Conectar um domínio personalizado

Você não precisa abrir mão de nomes de domínio exclusivos e centrados na sua marca para apps implantado em Firebase App 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. Firebase App Hosting provisiona um SSL certificado para cada um dos seus domínios.

O restante deste documento mostra as etapas para conectar sua conta domínio.

Configurar seu domínio para o App Hosting

Verifique se você concluiu as etapas básicas App Hosting configure tarefas para que Você tem um site do Firebase App Hosting no seu projeto do Firebase.

Etapa 1: adicionar um domínio personalizado

  1. Abra o página App Hosting.
  2. Selecione um back-end App Hosting usando a opção View Dashboard.
  3. Selecione a guia Configurações e clique em Adicionar domínio personalizado.
  4. Insira o nome de domínio personalizado que você quer conectar à sua App Hosting.
  5. (Opcional) Marque a caixa se quiser redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado (de modo que example.com e www.example.com redirecionam para o mesmo conteúdo).
  6. Clique em Continuar para configurar os registros DNS e concluir a configuração do seu domínio personalizado.

Etapa 2: configurar o domínio personalizado

  1. O assistente Adicionar domínio personalizado do Console do Firebase vai mostrar as registros necessários que precisam ser atualizados para direcionar sua página ao app Firebase do Hosting. Adicione, remova e salve registros do seu domínio no provedor de DNS com as seguintes entradas:

    • Tipo: adicione o registro DNS fornecido.

    • Host: digite seu chave de domínio personalizada para os registros. O host que você indicar é o domínio em em que você quer veicular conteúdo. este domínio pode ser um domínio ou subdomínio apex. Seu provedor de domínio pode liste esse termo como "Nome do host", "Nome" ou "Domínio".

    • Valor: atribua o valor fornecido aos seus registros. Seu domínio pode listar este termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP". O conteúdo do campo de valor varia tipo de registro, com registros A e AAAA com endereços IP como valores, enquanto Registros TXT são strings.

Aguarde o provisionamento do certificado SSL. Isso pode levar algumas horas após você apontar seu DNS para o Firebase App Hosting. Na maioria casos, a propagação de seus registros e o provisionamento de seu certificado SSL podem ocorrer no prazo de uma hora, dependendo do provedor de domínio.

Aguarde o provisionamento do certificado SSL

App Hosting pode levar algumas horas para provisionar um certificado SSL para seu domínio depois de atualizar os registros DNS.

Você pode visualizar este certificado usando as ferramentas de segurança do navegador. Enquanto o domínio está provisionando, talvez você veja um certificado inválido ou tenha problemas ao seu domínio. Essa é uma parte normal do processo e será resolvida depois que o certificado do seu domínio estiver disponível.

Observação: o Firebase App Hosting faz o reprovisionamento automático dos certificados SSL, conforme necessário para domínios personalizados.

Sua chave de domínio personalizada

Ao adicionar ou editar registros DNS, diferentes provedores de domínio esperam que você inserir diferentes entradas no campo Host nos sites de gerenciamento de DNS. Compilamos abaixo entradas comuns dos provedores mais usados. Fazer referência ao seu domínio na documentação do provedor para instruções detalhadas.

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

Entradas comuns incluem o seguinte:

  • @
  • O nome de domínio apex (por exemplo, example.com)
  • O campo Host em branco
Subdomínio

Entradas comuns incluem o seguinte:

  • O nome completo do subdomínio (por exemplo, app.example.com)
  • Somente 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

Veja 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. Ainda assim, consulte a documentação do seu provedor de domínio para ver instruções detalhadas.

Descrições de status para domínios personalizados

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

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

  • Na maioria dos casos, os registros DNS A não se propagaram do seu provedor de nomes de domínio para os servidores do Firebase App Hosting.
    Dica de solução de problemas: se já se passaram mais de 24 horas, verifique se você apontou seus registros para Firebase App Hosting.

  • Em casos mais raros, os desafios do SSL podem falhar porque seus registros DNS têm registros A ou CNAME que para outros provedores de hospedagem.
    Dica para solução de problemas: verifique se os registros A apontam apenas para Firebase App Hosting e remova todos os registros CNAME.
Pendente

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

Ocasionalmente, registros CAA excessivamente restritivos pode interromper a emissão de um certificado SSL para um domínio personalizado. Assegurar que as autoridades certificadoras `letsencrypt.org` e `pki.goog` têm permissão para criar certificados SSL para seu domínio.
Estamos criando o certificado

Um certificado SSL está sendo produzido para seu domínio.
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.