Ter um domínio principal (como seudominio.com.br) permite que você organize diferentes aplicações através de subdomínios. Se você utiliza o Firebase Hosting, este é o guia completo.

1. Configuração no Firebase Console Link para o cabeçalho

O Firebase precisa validar que você é o proprietário do subdomínio:

  1. No Firebase Console, vá em Hosting > Adicionar domínio personalizado.
  2. Insira o endereço completo (ex: suaaplicacao.seudominio.com.br).
  3. O Firebase fornecerá um registro CNAME (ou registros A e TXT). Copie esses valores.

2. Configuração no Registro.br Link para o cabeçalho

Agora, aponte o subdomínio para os servidores do Google:

  1. Acesse o Registro.br e selecione o domínio principal.

  2. Na seção DNS, clique em Editar Zona > Nova Entrada.

  3. No campo NOME: Digite apenas o prefixo (ex: suapliacacao).

  4. No campo TIPO: Selecione CNAME (ou conforme instruído).

  5. No campo DADOS: Cole o valor fornecido (ex: seu-projeto.web.app).

  6. Clique em Adicionar e em Salvar Alterações.

3. Configurando o Redirecionamento WWW (Opcional) Link para o cabeçalho

Para que o usuário que digitar www.suaaplicacao.seudominio.com.br também chegue ao seu site:

  1. No Firebase, clique novamente em Adicionar domínio personalizado.

  2. Digite o endereço com o www: www.suaaplicacao.seudominio.com.br.

  3. Selecione a opção Redirecionar para um domínio existente e escolha suaaplicacao.seudominio.com.br.

  4. No Registro.br, adicione uma nova entrada CNAME com o nome www.suaaplicacao apontando para o mesmo valor do passo anterior.

4. O Fator Tempo: Propagação e SSL Link para o cabeçalho

  • Propagação do DNS: Pode levar de alguns minutos a algumas horas para que o Registro.br avise a internet que seu subdomínio existe.

  • Certificado SSL (HTTPS): O status no Firebase ficará como “Criando certificado”. O Google gera automaticamente um certificado de segurança gratuito, o que pode levar de 1 a 24 horas. Durante esse período, o site pode aparecer como “Inseguro” ou dar erro de acesso.

5. Checklist de Erros Comuns Link para o cabeçalho

Se o domínio aparecer como “Conectado”, mas o site exibir “Site Not Found”:

  • Falta de Deploy: Verifique se você rodou ng build e firebase deploy no terminal do seu projeto.

  • Firebase.json: Se você tem vários sites no mesmo projeto, certifique-se de que o arquivo firebase.json está apontando para o site correto usando a chave “site”: “nome-do-recurso”.

Conclusão Link para o cabeçalho

Configurar subdomínios é uma excelente forma de escalar seu projeto. Uma vez que o primeiro subdomínio é configurado, os próximos seguem o mesmo padrão: Adicionar no Firebase -> Criar entrada no Registro.br -> Aguardar SSL.