Redirecionar Domínio Raiz

Domínios customizados na Guara Cloud são configurados em subdomínios, como www.example.com, app.example.com ou api.example.com. Se os visitantes também devem acessar seu site pelo domínio raiz example.com, configure seu provedor de DNS ou CDN para redirecionar example.com para o subdomínio que você adicionou na Guara Cloud.

A configuração recomendada é:

1. Adicionar www.example.com como domínio customizado na Guara Cloud.
2. Criar o CNAME de www.example.com exatamente como aparece no dashboard.
3. Configurar um redirecionamento HTTPS de example.com para https://www.example.com.

Por que domínios raiz são diferentes

O DNS usa registros CNAME para fazer um hostname ser alias de outro hostname. A Guara Cloud usa configuração de domínio customizado baseada em CNAME porque o destino do seu serviço pode mudar por trás dos panos enquanto seu domínio continua funcionando.

Os padrões de DNS tornam o domínio raiz especial. Um domínio raiz, também chamado de apex ou naked domain, precisa ter registros como SOA e NS da própria zona. A regra de CNAME no RFC 1034 seção 3.6.2 diz que, quando um CNAME existe em um nome, nenhum outro dado deve existir ali. O RFC 1912 seção 2.4 reforça a regra operacional de que um CNAME não pode coexistir com outros dados.

Por isso muitos provedores de DNS não permitem CNAME em example.com, mesmo permitindo CNAME em www.example.com.

O que configurar

Use o subdomínio como o endereço servido pela Guara Cloud, e use o domínio raiz apenas como redirecionamento.

Se você usa Cloudflare DNS

A Cloudflare suporta redirecionamento do domínio raiz para o www com Redirect Rules. Siga o guia oficial da Cloudflare: Redirect from root to WWW.

Use este formato:

• Hostname: example.com
• Destino do redirecionamento: https://www.example.com
• Código de status: 301 ou 308
• Preservar caminho e query string: habilitado

A Cloudflare precisa ter um registro DNS com proxy ativo para o hostname raiz, para receber a requisição e aplicar a regra de redirecionamento. Use o guia da Cloudflare como fonte da verdade para os campos atuais do dashboard.

Se seu registrador oferece URL forwarding

Alguns registradores oferecem “URL forwarding” ou “domain forwarding”. Isso pode funcionar, mas confira estes pontos antes de depender dele:

• Precisa suportar HTTPS para https://example.com.
• Deve usar redirecionamento permanente, normalmente 301 ou 308.
• Deve preservar o caminho e a query string.
• Não deve usar masked forwarding ou frames.
• Deve redirecionar para o subdomínio exato que você adicionou na Guara Cloud, como https://www.example.com.

Se o registrador redireciona apenas http://example.com, mas não https://example.com, visitantes que digitarem ou clicarem na URL HTTPS podem ver um erro do navegador antes do redirecionamento acontecer.

O que não fazer

• Não aponte example.com para o destino CNAME da Guara Cloud, a menos que seu provedor de DNS ofereça explicitamente CNAME flattening, ALIAS ou ANAME e você entenda o comportamento específico desse provedor.
• Não use masked forwarding. Ele mantém example.com no navegador enquanto embute www.example.com, o que quebra expectativas normais de roteamento, cookies, analytics e segurança.
• Não adicione example.com e www.example.com na Guara Cloud esperando que a Guara Cloud redirecione entre eles. A Guara Cloud serve o hostname exato que você configura; o redirecionamento do raiz deve ficar no seu provedor de DNS ou CDN.

Como testar

Depois de configurar o redirecionamento, teste as duas URLs:

curl -I https://example.com
curl -I https://www.example.com

O domínio raiz deve retornar um status de redirecionamento como 301 ou 308, com o header Location apontando para https://www.example.com. O domínio www deve retornar a resposta do seu serviço na Guara Cloud.

Alterações de DNS e redirecionamento podem levar algum tempo para propagar. A maioria aparece em minutos, mas alguns provedores e resolvers podem manter o comportamento antigo em cache por mais tempo.