Ir para o conteúdo
decodecodeveloper docs
Storefront → Arquivo do admin descontinuado

Admin legado: Apex Domains

Como redirecionar um domínio apex na deco.cx

Documentação de produto descontinuado — Fresh e o antigo admin foram descontinuados. Estas instruções são mantidas para migração e referência histórica. Novos projetos usam Blocks 7.x e o Editor de Sites do Studio.

Arquivo do admin descontinuado. Fresh e o antigo admin da deco.cx foram descontinuados. Use Blocks 7.x publicado para o runtime e o Site Editor do Studio para a edição atual. Esta página preserva o fluxo e as capturas de tela do antigo admin da deco.cx. Para o Site Editor do Studio, use os guias atuais. As notas de migração explicam a mudança.

O que é domínio apex?

Domínio apex é o domínio raiz sem subdomínio.

Exemplo:

  • www.example.com → Subdomínio
  • loja.example.com → Subdomínio
  • example.com → Domínio Apex

Posso apontar um site deco.cx para o domínio apex?

Não diretamente — sites deco.cx rodam em um subdomínio (ex.: www). Porém, a deco.cx oferece um serviço de redirect gerenciado para que visitantes que acessem o domínio apex sejam redirecionados automaticamente para o lugar certo.

Como configurar um Apex Redirect

1. No painel do seu site, acesse Configurações → Domínios e clique em Adicionar domínio existente.

2. Insira o seu domínio apex (sem subdomínio):

Domain step

3. Defina para qual subdomínio redirecionar:

Subdomain step

4. Adicione os seguintes registros DNS no seu provedor de DNS:

TipoNomeValor
A@16.148.147.194
A@52.32.122.94
A@52.35.156.199

Obs.: @ representa o domínio apex (raiz). Alguns provedores de DNS usam o nome completo do domínio ou deixam o campo em branco — consulte a documentação do seu provedor.

5. Atualize a página de Configurações → Domínios para verificar o status. Quando o certificado for provisionado, a entrada exibirá Active. Geralmente isso leva alguns minutos.

Migrando do Sistema Antigo

Se você vir um banner "Redirect legado detectado" no admin, um ou mais domínios apex do seu site ainda usam o sistema de redirect antigo e precisam ser migrados.

O que é um domínio apex? É o domínio raiz sem nenhum subdomínio — ex.: example.com (apex) em vez de www.example.com ou loja.example.com (subdomínios).

Seu site não vai sair do ar. O subdomínio onde o seu site roda de fato (ex.: www.example.com) não é afetado em nenhum momento durante a migração. Apenas o redirect apex (ex.: example.com → www.example.com) passa por uma breve transição.

Passo 1 — Adicione novamente o domínio

Em Configurações → Domínios, clique em Adicionar domínio existente e informe o mesmo domínio apex. Defina o subdomínio de redirect no próximo passo e confirme. Uma nova entrada aparecerá ao lado da entrada legada existente.

Passo 2 — Adicione os novos registros DNS

Acesse o seu provedor de DNS — é o serviço onde você registrou ou gerencia o seu domínio (ex.: GoDaddy, Cloudflare, Registro.br, Hostgator). Adicione os três registros abaixo:

TipoNomeValor
A@16.148.147.194
A@52.32.122.94
A@52.35.156.199

Obs.: @ representa o próprio domínio apex. Alguns provedores usam o nome completo do domínio ou deixam o campo em branco — consulte a documentação do seu provedor se tiver dúvida.

Passo 3 — Remova os registros DNS antigos

Durante esta etapa, o domínio apex (ex.: example.com) ficará um breve período sem certificado HTTPS válido — acessos via HTTP continuam funcionando normalmente e o redirect para www ocorre sem interrupção. O certificado HTTPS é emitido automaticamente em poucos minutos após a propagação do DNS.

O subdomínio do seu site (ex.: www.example.com) não é afetado em nenhum momento.

Ainda no seu provedor de DNS, exclua os registros apex antigos. Se você usava o sistema legado da deco.cx (baseado em Deno Deploy), os registros a remover são estes:

TipoNomeValor
A@34.120.54.55
AAAA@2600:1901:0:6d85::
CNAME_acme-challenge*.acme.deno.dev

Deixar registros antigos no lugar — especialmente o AAAA — fará com que os navegadores continuem roteando o tráfego para o sistema antigo.

Após alguns minutos a nova entrada exibirá Active e a migração estará concluída. Se quiser garantir que está tudo correto, faça uma requisição como a abaixo.

Você também pode deletar a entrada legada neste momento — ela não é mais necessária.

Verificando a migração

Com a nova entrada Active, você pode confirmar que o redirect está sendo servido pela deco.cx rodando o seguinte comando no terminal (substitua seudominio.com.br pelo seu domínio):

curl -s -I seudominio.com.br

Procure o header X-Redirect-By: deco na resposta:

HTTP/1.1 307 Temporary Redirect
Location: https://www.seudominio.com.br
X-Redirect-By: deco
...

Se aparecer X-Redirect-By: deco, a migração está completa e o redirect apex já está rodando no novo sistema.

Troubleshooting da Migração

A nova entrada não fica Active

  • Confirme que os três registros A foram adicionados corretamente no seu provedor de DNS.

  • Certifique-se de que as entradas do redirect antigo foram removidas do seu provedor de DNS. As entradas antigas são:

    TipoNomeValor
    A@34.120.54.55
    AAAA@2600:1901:0:6d85::
    CNAME_acme-challenge(ex.: _acme.deno.dev.)

  • A propagação do DNS leva alguns minutos — se a entrada ainda não estiver Active após 30 minutos, revise os registros acima.