Ir para o console

Conectar um domínio personalizado

Você não precisa desistir dos seus nomes de domínio exclusivos com a cara da sua marca usando o Firebase Hosting. É possível conectar domínios personalizados (como yourdomain.com ou app.yourdomain.com) em vez de um domínio gerado pelo Firebase a um site do Firebase Hosting.

O Firebase Hosting provisiona um certificado SSL para cada um dos seus domínios e exibe o conteúdo em uma CDN global.

Geralmente, o Firebase Hosting recomenda no máximo 20 subdomínios em qualquer domínio apex personalizado devido aos limites de emissão do certificado SSL.

Configurar seu domínio para o Hosting

Verifique se você tem um site do Firebase Hosting no seu projeto do Firebase. Para isso, é necessário ter concluído o assistente "Primeiros passos" na página do Firebase Hosting do seu projeto.

Etapa 1: adicionar domínio

  1. Na página Hosting do seu projeto, abra o assistente para conectar um domínio personalizado:

    • Se você tiver apenas um site do Hosting, clique em Conectar domínio.
    • Se você tiver mais de um site do Hosting, clique em Exibir no site desejado e selecione Conectar domínio.
  2. Insira o nome de domínio personalizado que você quer conectar ao seu site do Hosting.

  3. (Opcional) Marque a caixa se quiser redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado (de modo que yourdomain.com e www.yourdomain.com redirecionem para o mesmo conteúdo).

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

Etapa 2: confirmar propriedade de domínio

Caso seja solicitado no assistente de configuração da opção Conectar domínio, verifique seu domínio apex.

Essas etapas garantem que seu domínio ainda não está vinculado a um projeto do Firebase e que você é o proprietário do domínio especificado.

  1. 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: adicionar um registro TXT.

      É preciso que você mantenha esse registro TXT continuamente presente nas suas configurações de DNS a fim de comprovar sua propriedade do domínio e nos autorizar a atribuir e a renovar certificados SSL para seu site.

      Seu provedor de domínio pode listar esse termo como "Tipo de registro".

    • Host: insira sua chave de domínio apex.

      Ao provar sua propriedade de um domínio apex, ou domínio raiz, você também comprova sua propriedade de todos os subdomínios dele.

      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 esse termo como "Dados".

  2. Aguarde até 24 horas para a propagação de seus registros TXT atualizados.

    Se ao clicar em Verificar for exibido uma mensagem de erro, isso significa que seus registros não foram propagados ou seus valores podem estar incorretos.

    É possível 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ê deverá inserir novamente seu nome de domínio ao entrar na janela.

    Após uma ampla propagação, clicar em Verificar na janela Conectar domínio do Console do Firebase permite que você inicie o processo de provisionamento de certificado SSL.

    Na maioria dos casos, a propagação de seus registros e a verificação do seu domínio acontecerão em algumas horas, dependendo do seu provedor de domínio. Consulte a documentação do seu provedor de domínio para mais instruções detalhadas sobre como adicionar registros TXT e tempos de propagação.

Etapa 3: ativar

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 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 implantaremos na nossa CDN global em 24 horas após você direcionar seus registros de DNS A ao Firebase Hosting.

Seu domínio será listado como um dos nomes alternativos do assunto (SAN, na sigla em inglês) no certificado SSL do FirebaseApp. Visualize este certificado usando as ferramentas de segurança do navegador. Durante o provisionamento do domínio, talvez você veja um certificado inválido que não inclui seu nome de domínio. Esse problema é uma parte normal do processo e será resolvido depois que o certificado do seu domínio estiver disponível.

Para usuários da Configuração avançada, o site será hospedado por seu provedor 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 distintas para o campo Host nos seus sites de gerenciamento de DNS. Compilamos abaixo entradas comuns dos provedores mais usados. Consulte a documentação do seu provedor de domínio para ver instruções mais detalhadas.

Tipo de domínio Chave de domínio personalizada
Domínio apex

Entradas comuns incluem o seguinte:

  • @ s

  • O nome de domínio apex (yourdomain.com)

  • Deixar o campo Host em branco

Subdomínio

Entradas comuns incluem o seguinte:

  • O nome do subdomínio (app.yourdomain.com)
  • Apenas a parte do subdomínio (app, deixando de fora .yourdomain.com)
    • Um caso de uso comum é inserir www como sua chave para o subdomínio www.yourdomain.com.

Configurar descrições de status para domínios personalizados

Status Descrição
Configuração necessária

Pode ser necessário alterar uma configuração dos seus registros DNS.

  • Na maioria dos casos, seus registros de DNS A não se propagaram 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, principalmente se você estiver usando o fluxo de configuração avançada, os desafios do SSL podem apresentar falha porque:

    • seus registros de 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 de DNS TXT ou o arquivo enviado por upload para seu site) agora é inválido;
      Dica de solução de problemas: clique na opção Ver do 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.

Às vezes, os seguintes problemas podem interromper a emissão de um certificado SSL para um domínio personalizado:

  • Seus registros da CAA são muito restritivos.
    Dica de solução de problemas: verifique se a autoridade de certificação Let's Encrypt tem 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 o código de desafio serão inválidos.
    Dica de solução de problemas: clique na opção Ver do 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: em geral, o Firebase Hosting recomenda no máximo 20 subdomínios em um domínio apex personalizado, devido aos limites de emissão de certificados SSL.
Conectado

Seu domínio personalizado tem os registros de DNS apropriados e recebeu um certificado SSL.
É possível exibir o conteúdo do seu site.

Requer nova verificação

O Firebase exigirá apenas que você verifique mais uma vez manualmente a propriedade do domínio após o estágio de configuração inicial quando essas duas situações ocorrerem:

  • O registro TXT da Etapa 2 foi alterado ou removido das configurações de DNS do seu domínio.
    • Observe que vários registros TXT com um token de verificação do site Google são permitidos em um único domínio.
    • É preciso que você mantenha esse registro TXT continuamente presente nas suas configurações de DNS para comprovar sua propriedade do domínio e nos autorizar a atribuir e a renovar certificados SSL para seu site.
  • A pessoa que comprovou a propriedade do domínio foi removida do projeto.
Dica para solução de problemas: acesse a página do Hosting do projeto para concluir o processo de revalidação dentro da janela especificada (geralmente 30 dias) para que o domínio seja removido automaticamente do console do Hosting.