Você não precisa abrir mão de seus nomes de domínio exclusivos e centrados na marca com o Firebase Hosting. Você pode usar um domínio personalizado (como example.com
ou app.example.com
) em vez de um domínio gerado pelo Firebase para seu site hospedado pelo Firebase.
O Firebase Hosting fornece um certificado SSL para cada um dos seus domínios e veicula seu conteúdo por meio de um CDN global.
O restante deste documento orienta você nessas etapas para conectar seu domínio personalizado.
Configure seu domínio para hospedagem
Certifique-se de ter concluído o assistente "Primeiros passos" na página do Firebase Hosting do seu projeto para ter um site do Firebase Hosting no seu projeto do Firebase.
Etapa 1 : adicionar domínio personalizado
Na página de hospedagem do seu projeto, entre no assistente para conectar um domínio personalizado:
- Se você tiver apenas um site de hospedagem, clique em Adicionar domínio personalizado .
- Se você tiver mais de um site de hospedagem , clique em Visualizar para o site desejado e clique em Adicionar domínio personalizado .
Insira o nome de domínio personalizado que você gostaria de conectar ao seu site de hospedagem.
(Opcional) Marque a caixa para redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado (de forma que
example.com
ewww.example.com
redirecionem para o mesmo conteúdo).Clique em Continuar para configurar seus registros DNS e concluir a configuração de seu domínio personalizado.
Etapa 2 : configurar domínio personalizado
Se solicitado no assistente de configuração do Connect Domain , verifique seu domínio apex.
Essas etapas garantem que seu domínio ainda não esteja vinculado a um projeto do Firebase e que você seja o proprietário do domínio especificado.
No site do seu provedor de domínio, localize a página de gerenciamento de DNS.
Adicione e salve um novo registro com as seguintes entradas:
Tipo : Adicione um registro TXT.
O Firebase Hosting exige que você mantenha esse registro TXT continuamente presente nas configurações de DNS para provar sua propriedade do domínio e autorizar o Firebase a atribuir e renovar certificados SSL para o seu site.
Seu provedor de domínio pode listar este termo como “Tipo de registro”.
Host : Insira sua chave de domínio apex .
Provar sua propriedade de um domínio ápice, ou domínio raiz, prova sua propriedade de todos os seus subdomínios.
Seu provedor de domínio pode listar esse termo como “Nome do host”, “Nome” ou “Domínio”.
Valor : copie o valor de verificação exclusivo no campo.
O Firebase Hosting verifica esse valor para comprovar a propriedade do seu domínio.
Seu provedor de domínio pode listar este termo como “Dados”.
Aguarde até 24 horas para a propagação dos seus registros TXT atualizados e clique em Verificar .
Observe que você pode clicar em Cancelar para fechar com segurança a janela Conectar Domínio e reabri-la mais tarde. Isso não afeta o tempo de propagação, mas você será solicitado a inserir novamente o seu nome de domínio ao reabrir a janela.
Após um amplo tempo de propagação, clicar em Verificar na janela Conectar domínio do console do Firebase permite iniciar o processo de provisionamento do certificado SSL.
Na maioria dos casos, a propagação dos seus registros e a verificação do seu domínio ocorrerão em algumas horas, dependendo do seu provedor de domínio. Consulte a documentação do seu provedor de domínio para obter instruções detalhadas sobre como adicionar registros TXT e tempos de propagação.
Se clicar em Verificar exibir uma mensagem de erro, seus registros não foram propagados ou seus valores podem estar incorretos.
No assistente Adicionar domínio personalizado do console do Firebase, selecione Configuração rápida ou Configuração avançada .
A Configuração Rápida pode ser usada para novos domínios que não estão recebendo tráfego no momento ou domínios que você está tentando transferir de outro site de hospedagem. A Configuração Avançada pode ser usada se você já tiver um domínio recebendo solicitações em outro provedor de hospedagem e precisar de uma migração sem tempo de inatividade.
O assistente de configuração avançada ajudará você a estabelecer um certificado SSL e uma reivindicação de propriedade para permitir que o Hosting forneça tráfego no domínio antes de recebê-lo.
Configuração rápida
- O assistente Adicionar domínio personalizado do console do Firebase mostrará os registros necessários que precisam ser atualizados para apontar sua página para o Firebase Hosting. Adicione, remova e salve registros do seu domínio no seu provedor DNS com as seguintes entradas:
- Tipo : Adicione o registro DNS fornecido.
- Host : insira sua chave de domínio personalizada para os registros.
- Valor : Atribua os endereços IP fornecidos ao valor dos registros.
- Aguarde até que seu certificado SSL seja provisionado . Isso pode levar até 24 horas após você apontar seu DNS para o Firebase Hosting. Na maioria dos casos, a propagação dos seus registros e o fornecimento do seu certificado SSL ocorrerão em algumas horas, dependendo do seu provedor de domínio.
O host que você indica é o domínio no qual deseja veicular conteúdo; este domínio pode ser um domínio ou subdomínio ápice.
Seu provedor de domínio pode listar esse termo como “Nome do host”, “Nome” ou “Domínio”.
Seu provedor de domínio pode listar este termo como “Dados”, “Aponta para”, “Conteúdo”, “Endereço” ou “Endereço IP”.
Configuração avançada
O modo de configuração avançada do assistente Adicionar domínio personalizado permite que você configure o Hosting para servir seu domínio com segurança antes de direcionar o tráfego para seus servidores. Em geral, a hospedagem precisa de três coisas para servir com sucesso o tráfego em um domínio:
- Registro de propriedade: um registro TXT informa à Hosting qual site servir no domínio
- Certificado SSL: um certificado específico de domínio que permite a comunicação criptografada entre servidores de hospedagem e usuários finais
- Registros IP de hospedagem: um ou mais registros A e AAAA que direcionam todas as solicitações do domínio para servidores de hospedagem
A configuração avançada orienta você na configuração do seu domínio para permitir que o Hosting cuide dos dois primeiros requisitos com antecedência, para que esteja pronto para servir o conteúdo correto antes de começar a receber tráfego para o seu domínio. Este assistente representa esse processo como um fluxo de trabalho em duas etapas:
- Preparar domínio
- Atualizar registro(s) DNS : adicione um ou mais registros ao seu domínio:
- Propriedade: um registro TXT no formato `hosting-site=[site_id]`.
- CAA (opcional): Um par de registros CAA que permitem que as autoridades de certificação da Hosting criem um certificado SSL para o seu domínio. Presente apenas se o Hosting descobrir registros CAA existentes que o impeçam de provisionar um certificado.
- Configurar certificado SSL : O assistente fornece um desafio ACME que as autoridades de certificação da hospedagem usarão para criar um certificado SSL para o seu domínio. Você pode escolher entre um desafio DNS ou HTTP:
- Desafio DNS : Visite os sites de gerenciamento de DNS do seu provedor de domínio. Adicione um registro TXT com a chave de subdomínio do desafio ACME e o valor fornecido. Aguarde até 24 horas para propagação de seus registros TXT.
- Desafio HTTP : carregue o arquivo de texto fornecido em seu site existente no URL especificado e verifique sua existência.
- Direto para hospedagem
- Tipo : Adicione registros DNS A/AAAA solicitados.
- Host : insira sua chave de domínio personalizada para ambos os registros.
O host que você indica é o domínio no qual deseja veicular conteúdo; este domínio pode ser um domínio ou subdomínio ápice. Seu provedor de domínio pode listar esse termo como “Nome do host”, “Nome” ou “Domínio”.
- Valor : atribua um valor a cada registro DNS A/AAAA para apontar seu domínio para os endereços IP especificados.
Seu provedor de domínio pode listar este termo como “Dados”, “Aponta para”, “Conteúdo”, “Endereço” ou “Endereço IP”.
A hospedagem tentará validar os desafios ACME antes de solicitar a verificação de sua CA. Se a CA não conseguir validar os seus desafios por qualquer motivo, por exemplo, problemas de serviço intermitentes. A hospedagem terá que gerar um novo conjunto de desafios para você. Após a verificação bem-sucedida, pode levar algumas horas para que o Hosting forneça um certificado SSL e permita sua propagação.
Depois que a Hosting estabelecer a propriedade do seu domínio e provisionar um certificado SSL, retorne ao seu provedor DNS e adicione registros DNS A/AAAA direcionando as solicitações para a Hosting:
Aguarde o provisionamento do certificado SSL
Depois de verificarmos a propriedade do domínio, forneceremos um certificado SSL para seu domínio e o implantaremos em nossa CDN global dentro de 24 horas após você apontar seus registros DNS A para o Firebase Hosting.
Seu domínio será listado como um dos nomes alternativos de assunto (SAN) no certificado SSL do FirebaseApp. Você pode visualizar este certificado usando as ferramentas de segurança do navegador. Enquanto o domínio estiver sendo provisionado, você poderá ver um certificado inválido que não inclui seu nome de domínio. Esta é uma parte normal do processo e será resolvida depois que o certificado do seu domínio estiver disponível.
Para usuários da Configuração avançada , seu site será hospedado pelo provedor de hospedagem anterior até que o status de configuração na página do Firebase Hosting do seu projeto seja atualizado para Conectado .
Sua chave de domínio personalizada
Ao adicionar ou editar registros DNS, diferentes provedores de domínio esperam que você insira entradas diferentes para o campo Host em seus sites de gerenciamento de DNS. Compilamos abaixo informações comuns de fornecedores populares. Consulte a documentação do seu provedor de domínio para obter instruções detalhadas.
Tipo de domínio | Chave de domínio personalizada |
---|---|
Domínio Apex | As entradas comuns incluem:
|
Subdomínio | As entradas comuns incluem:
|
Provedores de domínio comuns
Aqui estão alguns provedores de domínio comuns e os tipos de entrada que cada um pode exigir. Essas informações são mantidas atualizadas tanto quanto possível, mas consulte a documentação do seu provedor de domínio para obter instruções detalhadas.
nuvemflare
Tipo | Hospedar | Valor |
---|---|---|
Entradas de registro DNS TXT | ||
TXT | example .com | valor de verificação fornecido no console do Firebase |
DNS A registra entradas | ||
A | example .com | 199.36.158.100 |
A | www | 199.36.158.100 |
DNS do Google Cloud
Tipo | Hospedar | Valor |
---|---|---|
Entradas de registro DNS TXT | ||
TXT | example .com | valor de verificação fornecido no console do Firebase |
DNS A registra entradas | ||
A | example .com | 199.36.158.100 |
A | www | 199.36.158.100 |
NomeCheap
Tipo | Hospedar | Valor |
---|---|---|
Entradas de registro DNS TXT | ||
TXT | @ | valor de verificação fornecido no console do Firebase |
DNS A registra entradas | ||
A | @ | 199.36.158.100 |
A | @ | 199.36.158.100 |
Espaço quadrado
Tipo | Hospedar | Valor |
---|---|---|
Entradas de registro DNS TXT | ||
TXT | @ | valor de verificação fornecido no console do Firebase |
DNS A registra entradas | ||
A | @ | 199.36.158.100 |
A | www | 199.36.158.100 |
Configurar descrições de status para domínios personalizados
Status | Descrição |
---|---|
Precisa de configuração | Pode ser necessário alterar uma configuração em seus registros DNS.
|
Pendente | Você configurou corretamente seu domínio personalizado, mas o Firebase Hosting não provisionou um certificado SSL. Ocasionalmente, os seguintes problemas podem impedir a criação de um certificado SSL para um domínio personalizado:
|
Certificado de Cunhagem | Um certificado SSL está sendo produzido para o seu domínio. |
Conectado | Seu domínio personalizado possui os registros DNS adequados e um certificado SSL. |