Ir para o console

Conectar um domínio personalizado

Você pode conectar domínios personalizados (como example.com ou myrealtimeapp.example.com) a um site do Firebase Hosting.

O Firebase Hosting provisiona um certificado SSL para cada um dos seus domínios e disponibiliza 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.

  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 domínio personalizado que você quer conectar ao seu site do Hosting.

  3. (Opcional) Marque a caixa para redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado.

  4. Clique em Continuar para iniciar o processo de validação. Em seguida, se necessário, verifique a propriedade do domínio seguindo as instruções no assistente de configuração.

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

  5. Para concluir a configuração do domínio personalizado, use o modo de Configuração rápida na maioria dos casos.

    No entanto, se você já tiver um site em execução em outro provedor de hospedagem e precisar de uma migração sem que haja inatividade, selecione Configuração avançada na lista suspensa do modo de configuração.

    • Configuração rápida: aponte os registros de DNS A do seu domínio para o Firebase Hosting.

    • Configuração avançada: siga as instruções na tela para atualizar os registros TXT do DNS do seu domínio ou para enviar um arquivo por upload a um local especificado no site existente. Após a conclusão da verificação, é possível apontar de maneira segura os registros de DNS A para o Firebase Hosting.

  6. O Firebase fornece um certificado SSL dentro de 24 horas após você apontar seus registros de DNS A para o Firebase Hosting.

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 disponibilizar o conteúdo do seu site.

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 na CDN global. Esse processo pode levar várias horas.

Seu domínio será listado como um dos Subject Alternative Names (nomes alternativos do assunto) no certificado SSL do FirebaseApp, que será visível publicamente. 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.