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 desistir 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 no Firebase.

O Firebase Hosting fornece um certificado SSL para cada um de seus domínios e oferece 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 "Introdução" na página do Firebase Hosting do seu projeto para que você tenha um site do Firebase Hosting em 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 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 (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 Conectar domínio , 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 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 : Digite sua chave de domínio apex .

      Comprovar sua propriedade de um domínio apex, ou domínio raiz, prova 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 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 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 reabri-la posteriormente. Isso não afeta o tempo de propagação, mas você será solicitado a inserir novamente seu nome de domínio quando reabrir a janela.

    Após um longo tempo de propagação, clicar em Verificar na janela Conectar domínio do console do Firebase permite que você inicie 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 : Vá ao vivo

Na janela Conectar domínio do Firebase console, 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 com tempo de inatividade zero.

Aguarde o provisionamento do certificado SSL

Depois de verificarmos a propriedade do domínio, fornecemos um certificado SSL para seu domínio e o implantamos em nossa CDN global em até 24 horas após você apontar seus registros DNS A para o Firebase Hosting.

Seu domínio será listado como um dos Subject Alternative Names (SAN) no certificado FirebaseApp SSL. Você pode visualizar este certificado usando as ferramentas de segurança do navegador. Enquanto o domínio está sendo provisionado, você pode 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 por seu provedor de hospedagem anterior até que o status de configuração na página de hospedagem do Firebase 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 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 Apex

As entradas comuns incluem:

  • @
  • O nome de domínio apex (por exemplo, example .com )
  • Deixar 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 )
  • Apenas 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 o máximo 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 de seu provedor de nome de domínio para os servidores 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 têm registros A ou CNAME que apontam para outros provedores de hospedagem.
      Dica de solução de problemas: verifique se os 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 para seu domínio existente.
Pendente

Você configurou corretamente seu domínio personalizado, mas o Firebase Hosting não forneceu um certificado SSL.

Ocasionalmente, os seguintes problemas podem interromper 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 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 falhar, 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 para seu domínio existente.
  • Você solicitou certificados para muitos subdomínios.
    Dica de solução de problemas: geralmente, o Firebase Hosting recomenda não mais do que 20 subdomínios em um domínio personalizado apex, devido aos limites de emissão de certificados SSL.
Conectado

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

Necessita de nova verificação

O Firebase pode exigir que você verifique novamente manualmente a propriedade do seu domínio se ocorrer alguma 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 de verificação do site do Google 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 está mais atribuída a uma função do IAM que contém a permissão necessária para verificar a propriedade do domínio. Essas funções incluem proprietário, editor, administrador do Firebase e administrador do Firebase Develop.
Dica de solução de problemas: visite a página de hospedagem do seu projeto para concluir o processo de nova verificação dentro da janela de tempo especificada (geralmente 30 dias) para evitar que seu domínio personalizado seja desconectado automaticamente do Firebase Hosting.