Por que o domínio personalizado do Notion não aceita registro DNS apex
🔍 WiseChecker

Por que o domínio personalizado do Notion não aceita registro DNS apex

Se você tentou conectar um domínio personalizado ao seu workspace do Notion e recebeu um erro sobre o registro DNS apex, não está sozinho. O Notion exige um registro CNAME para verificação de domínio, mas domínios apex como exemplo.com normalmente só suportam registros A, AAAA ou ALIAS. Essa limitação decorre dos padrões DNS e da infraestrutura do Notion. Este artigo explica o motivo técnico por trás dessa restrição e mostra as etapas exatas para configurar seu domínio corretamente.

Principais conclusões: Por que registros DNS apex falham para domínios personalizados do Notion

  • Conflito de tipo de registro DNS: O Notion exige um registro CNAME para verificação, mas domínios apex não podem usar registros CNAME de acordo com os padrões DNS.
  • Solução com subdomínio: Use um subdomínio como www.exemplo.com com um registro CNAME apontando para cname.verify.notion.site.
  • Alternativas do provedor DNS: Alguns provedores oferecem registros ALIAS ou ANAME que emulam o comportamento CNAME no apex, mas o Notion não os suporta.

ADVERTISEMENT

Por que o Notion rejeita registros DNS apex

O Sistema de Nomes de Domínio tem uma regra fundamental: um registro CNAME não pode coexistir com nenhum outro tipo de registro no mesmo nome. Essa regra é definida nas RFCs 1034 e 2181. Um domínio apex, como exemplo.com, deve ter pelo menos registros SOA e NS. Adicionar um registro CNAME ali entraria em conflito com esses registros obrigatórios. O Notion usa um registro CNAME para verificar a propriedade do domínio e rotear o tráfego. Como domínios apex não podem hospedar um registro CNAME, o Notion não pode aceitar um domínio apex diretamente.

O processo de verificação do Notion procura um destino CNAME específico: cname.verify.notion.site. Se a consulta DNS para seu domínio retornar um registro A ou AAAA em vez de um CNAME, a verificação falha. Isso não é um bug ou uma limitação apenas do Notion. É uma restrição do próprio protocolo DNS. Mesmo que você use um provedor DNS que ofereça um registro ALIAS ou ANAME, o Notion ainda procura um registro CNAME verdadeiro. Registros ALIAS são resolvidos no nível do provedor DNS, não no nível do servidor de nomes autoritativo, então o Notion não os considera válidos.

Alguns serviços como GitHub Pages ou Netlify permitem domínios apex usando uma técnica chamada CNAME flattening. O Notion não implementa isso. Em vez disso, o Notion espera explicitamente um registro CNAME no domínio exato que você configurar. Se você definir o domínio personalizado do seu workspace como exemplo.com, o Notion consultará exemplo.com por um registro CNAME. Como exemplo.com não pode ter um registro CNAME, a verificação sempre falha.

Etapas para configurar um domínio personalizado para seu workspace do Notion

Para conectar um domínio personalizado com sucesso, você deve usar um subdomínio. A escolha mais comum é www. Esse método funciona com qualquer provedor DNS que suporte registros CNAME, o que é praticamente todos.

  1. Escolha um subdomínio
    Selecione um subdomínio como www.exemplo.com ou blog.exemplo.com. Não use exemplo.com sozinho. Anote o subdomínio exato que planeja usar.
  2. Abra o console de gerenciamento do seu provedor DNS
    Faça login no painel de controle do seu registrador de domínio ou provedor de hospedagem DNS. Provedores comuns incluem GoDaddy, Cloudflare, Namecheap e Google Domains.
  3. Adicione um registro CNAME
    Crie um novo registro DNS do tipo CNAME. Defina o campo nome como seu subdomínio escolhido. Por exemplo, se seu subdomínio for www, digite www. Defina o campo destino ou valor como cname.verify.notion.site. Salve o registro.
  4. Abra as configurações do workspace do Notion
    Navegue até Configurações e Membros na barra lateral esquerda. Selecione Configurações no menu superior. Role até a seção Workspace e clique em Domínio Personalizado.
  5. Digite seu subdomínio
    No campo Domínio Personalizado, digite o subdomínio completo, por exemplo www.exemplo.com. Clique em Verificar Domínio. O Notion verificará o registro CNAME que você criou. Se o registro estiver correto, o status do domínio mudará para Verificado.
  6. Aguarde a propagação do DNS
    As alterações de DNS podem levar até 48 horas para se propagar mundialmente, embora a maioria das atualizações ocorra em alguns minutos. Se a verificação falhar imediatamente, aguarde 15 minutos e tente novamente.
  7. Configure um redirecionamento do domínio apex
    Para permitir que visitantes acessem seu workspace digitando exemplo.com, configure um redirecionamento do seu domínio apex para o subdomínio. A maioria dos provedores DNS oferece encaminhamento de URL ou regras de redirecionamento. No Cloudflare, use uma Page Rule. No GoDaddy, use o recurso Forwarding. Aponte exemplo.com para http://www.exemplo.com.

ADVERTISEMENT

Se o Notion ainda rejeitar seu domínio personalizado

Mesmo após seguir as etapas acima, você pode encontrar erros. Abaixo estão os problemas mais comuns e como resolvê-los.

Registro CNAME não encontrado após adicioná-lo

Verifique novamente o tipo de registro. Deve ser CNAME, não A, AAAA ou ALIAS. Confirme se o destino é exatamente cname.verify.notion.site, sem ponto final ou espaços extras. Se você usa Cloudflare, certifique-se de que o proxy da nuvem laranja esteja desativado para este registro. O proxy do Cloudflare pode interferir na verificação CNAME.

Verificação de domínio bem-sucedida, mas o site não carrega

Após a verificação, o Notion pode levar até 24 horas para provisionar certificados SSL. Durante esse período, o domínio personalizado pode exibir um aviso de segurança ou não carregar. Aguarde algumas horas e tente novamente. Se o problema persistir, remova o domínio personalizado e adicione-o novamente nas configurações do Notion.

Redirecionamento do apex para o subdomínio não está funcionando

O encaminhamento de URL depende do seu provedor DNS. Alguns provedores exigem que você crie um registro A apontando para o servidor de redirecionamento deles. Verifique a documentação do seu provedor. Alternativamente, use um serviço como Cloudflare com uma Page Rule que redirecione exemplo.com para www.exemplo.com usando um redirecionamento 301.

Item Domínio Apex (exemplo.com) Subdomínio (www.exemplo.com)
Tipo de registro DNS suportado A, AAAA, NS, SOA CNAME, A, AAAA
Pode usar domínio personalizado do Notion Não Sim
Requer configuração de redirecionamento Sim, para o subdomínio Não
Conformidade com padrões DNS Conforme RFC 1034 e 2181 Conforme

Agora você sabe por que o Notion não pode usar um registro DNS apex para domínios personalizados. A restrição vem dos padrões DNS que impedem registros CNAME na raiz de um domínio. Use um subdomínio como www e configure um redirecionamento do seu domínio apex. Para uma configuração mais limpa, considere usar um provedor DNS que ofereça CNAME flattening, embora o Notion ainda possa rejeitá-lo. Sempre teste o registro CNAME com uma ferramenta de consulta DNS antes de tentar a verificação no Notion.

ADVERTISEMENT