Conecte um domínio personalizado

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

  1. 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 .
  2. Insira o nome de domínio personalizado que você gostaria de conectar ao seu site de hospedagem.

  3. (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).

  4. 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.

  1. No site do seu provedor de domínio, localize a página de gerenciamento de DNS.

  2. 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”.

  3. 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.

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.

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.