Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Conecte um domínio personalizado

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 em uma 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

  1. Na página de hospedagem do seu projeto , insira o 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 Exibir para o site desejado e, em seguida, clique em Adicionar domínio personalizado .
  2. Insira o nome de domínio personalizado que você deseja 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 (como example.com e www.example.com redirecionam para o mesmo conteúdo).

  4. Clique em Continuar para iniciar o processo de validação.

Etapa 2 : verificar a propriedade do domínio

Se solicitado no assistente de configuração do Connect Domain , verifique seu domínio do 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 em suas configurações de DNS para provar sua propriedade do domínio e autorizar o Firebase a atribuir e renovar certificados SSL para 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 apex, ou domínio raiz, comprova sua propriedade de todos os seus subdomínios.

      Seu provedor de domínio pode listar este 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 provar 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 de 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 reabrir mais tarde. Isso não afeta o tempo de propagação, mas você será solicitado a reinserir seu nome de domínio quando 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 de seus registros e a verificação de 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.

Passo 3 : Entre ao vivo

Na janela Conectar domínio do console do Firebase, selecione Configuração rápida para um novo site ou Configuração avançada se você já tiver um site em execução em outro provedor de hospedagem e precisar de uma migração sem tempo de inatividade.

Aguarde o provisionamento do certificado SSL

Depois de verificarmos a propriedade do domínio, provisionamos um certificado SSL para seu domínio e o implantamos 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 provisionando, 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 de configuração avançada , seu site será hospedado pelo seu provedor de hospedagem anterior até que o status de configuração na página do Firebase Hosting do seu projeto seja atualizado para Connected .

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 entradas comuns de provedores populares abaixo. 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 do Apex

As entradas comuns incluem:

  • @
  • O nome de domínio do 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, somente app e deixando de fora . example .com )
  • Apenas www para o subdomínio de www. example .com

Provedores de domínio comum

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 o mais atualizadas possível, mas consulte a documentação do seu provedor de domínio para obter instruções detalhadas.

Descrições de status de configuração para domínios personalizados

Status Descrição
Precisa de configuração

Pode ser necessário alterar uma configuração com 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 estar falhando porque:

    • Seus registros DNS têm 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 carregado fornecido ao seu site) agora é inválido.
      Dica de solução de problemas: clique em Exibir 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 emissã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 de certificação `letsencrypt.org` e `pki.goog` tenham permissão para criar certificados SSL para 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 falhou, seu token (e seu código de desafio) agora são inválidos.
    Dica de solução de problemas: clique em Exibir 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 do apex, devido aos limites de emissão de certificados SSL.
Conectado

Seu domínio personalizado tem os registros DNS adequados e um certificado SSL.
Você pode servir o conteúdo do seu site.

Precisa de nova verificação

O Firebase pode exigir que você verifique novamente a propriedade do domínio manualmente se ocorrer uma das seguintes situações:

  • O registro TXT adicionado quando você verificou inicialmente que a propriedade do seu domínio foi alterada ou removida das configurações de DNS do seu domínio.
    • Observe que vários registros TXT com um token google-site-verification são permitidos em um único domínio.
    • Exigimos que o registro TXT esteja continuamente presente em suas configurações de DNS, pois isso prova que você é o proprietário do domínio e nos autoriza a atribuir e renovar certificados SSL para seu site.
  • A pessoa que verificou a propriedade do domínio não recebe mais uma função do IAM que contém a permissão necessária para verificar a propriedade do domínio. Esses papéis incluem proprietário, editor, administrador do Firebase e administrador de desenvolvimento do Firebase.
Dica de solução de problemas: visite a página do Hosting do seu projeto para concluir o processo de nova verificação dentro do período especificado (geralmente 30 dias) para evitar que seu domínio personalizado seja desconectado automaticamente do Firebase Hosting.