Se você estiver criando apps Angular ou Next.js renderizados pelo servidor, confira o Firebase App Hosting de última geração, uma solução de pilha completa para frameworks modernos da Web.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 e www.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”.
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:
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 os endereços IP fornecidos ao valor dos registros.
Seu provedor de domínio pode listar este termo como “Dados”, “Aponta para”, “Conteúdo”, “Endereço” ou “Endereço IP”.
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.
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.
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.
Direto para hospedagem
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:
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”.
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:
@
O nome de domínio apex (por exemplo, example .com )
Deixando o campo Host em branco
Subdomínio
As entradas comuns incluem:
O nome completo do subdomínio (por exemplo, app. example .com )
Apenas a parte do subdomínio (por exemplo, apenas app e deixando de fora . example .com )
Somente www para o subdomínio de www. example .com
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.
Na maioria dos casos, seus registros DNS A não foram propagados do seu provedor de nome de domínio para os servidores do Firebase Hosting. Dica de solução de problemas: se já se passaram mais de 24 horas, verifique se você apontou seus registros para o Firebase Hosting.
Em casos mais raros, especialmente se você estiver usando o fluxo de configuração avançada, os desafios de SSL podem falhar porque:
Seus registros DNS possuem registros A ou registros CNAME que apontam para outros provedores de hospedagem. Dica de solução de problemas: verifique se seus registros A apontam apenas para o Firebase Hosting e remova todos os registros CNAME.
A migração falhou e o token (registros DNS TXT ou arquivo enviado fornecido ao seu site) agora é inválido. Dica de solução de problemas: clique em Visualizar para o domínio e forneça o novo token ao seu domínio existente.
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:
Seus registros CAA são muito restritivos. Dica de solução de problemas: certifique-se de que as autoridades certificadoras `letsencrypt.org` e `pki.goog` tenham permissão para criar certificados SSL para o seu domínio.
Seu código de desafio é inválido. Se você estiver usando o fluxo de configuração avançada e a migração falhar, seu token (e seu código de desafio) serão inválidos. Dica de solução de problemas: clique em Visualizar para o domínio e forneça o novo token ao seu domínio existente.
Você solicitou certificados para muitos subdomínios. Dica de solução de problemas: geralmente, o Firebase Hosting não recomenda mais de 20 subdomínios em um domínio personalizado Apex, devido aos limites de emissão de certificados SSL.
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. Você pode servir o conteúdo do seu site.