blog
Domínios e DNS

Copiar os registros DNS da hospedagem antiga sem redigitar

Exportar o arquivo de zona, validar a sintaxe, importar no destino e conferir por tipo antes de trocar os nameservers. Com checklist reutilizável e frase pronta para avisar o cliente.

JR · · 9 min de leitura · 1 tabela · 6 blocos de código

Resposta curta: exporte a zona do fornecedor antigo em formato BIND (ou reconstrua com dig consultando os nameservers autoritativos), valide com named-checkzone, importe no DNS Zone Manager do destino e compare registro a registro com dig antes de trocar os nameservers no registrador.

Neste artigo
  1. O que reunir antes de abrir qualquer painel
  2. Extrair a zona do fornecedor antigo
  3. Validar com named-checkzone e contar os registros por tipo
  4. O que não deve ser copiado literal da zona antiga
  5. Comparar os dois nameservers com diff antes de virar
  6. A ordem da virada quando existe DNSSEC na zona antiga
  7. Transformar a migração em artefato para a carteira

Redigitar zona DNS é onde o erro mora. Um TXT de SPF com aspas quebradas, um MX com prioridade trocada, um CNAME de verificação do Google Workspace que ninguém lembra para que serve: tudo isso sobrevive à migração se você copiar o arquivo inteiro em vez de olhar a tela do painel antigo e digitar no novo.

O procedimento abaixo é documental: se apoia no que a documentação oficial do DNS Zone Manager do cPanel/WHM descreve, e em ferramentas padrão de linha de comando. Os registros que aparecem nos exemplos são fictícios, montados para ilustrar o formato. Nada aqui é medição nossa.

O que reunir antes de abrir qualquer painel

A migração de zona tem uma ordem que não é negociável: a zona vai para o destino antes de qualquer alteração de nameserver no registrador. Se você inverter, o domínio passa a responder por um servidor que ainda não conhece os registros, e aí a janela de indisponibilidade deixa de ser teórica.

Antes de começar, reúna:

Esse último item é o que mais derruba migração. O cliente lembra do site e do e-mail. Ninguém lembra do TXT que valida o domínio numa plataforma de disparo contratada há dois anos.

Ordem da migração de zona DNSExtrair zona antigaExportar ou reconstruir com digValidar sintaxenamed-checkzone e contagem por tipoMontar zona no destinoRegistro a registro, antes de virarComparar com diffDois nameservers lado a ladoTrocar NS no registradorSó com diff limpo
A zona vai para o destino antes de qualquer alteração de nameserver.

Extrair a zona do fornecedor antigo

Quando o painel exporta e quando a cópia é manual

Se o fornecedor antigo roda cPanel/WHM, o DNS Zone Manager lista os registros do domínio e permite adicionar, editar e remover cada um, que é o que a documentação oficial descreve. A documentação não descreve um editor de arquivo de zona bruto nessa interface, então trate a cópia como manual: percorra a listagem e transcreva registro a registro para um arquivo dominio.com.zone local, com nome, TTL, classe, tipo e dados. Se a instalação do fornecedor expuser algum botão de exportar ou visualizar o arquivo, melhor, use ele.

Painéis que não são cPanel costumam ter um botão de exportar em formato BIND. Use esse. Exportação em CSV ou JSON também serve, mas você perde a validação sintática que o formato BIND permite.

Reconstruir a zona com dig quando não há exportação

Sem exportação, reconstrua a zona consultando os nameservers antigos diretamente. Transferência de zona completa raramente está liberada, mas tente primeiro:

dig @ns1.fornecedorantigo.com exemplo.com AXFR

Se vier Transfer failed, é o esperado: a maioria dos provedores bloqueia AXFR público. Então consulte tipo a tipo, apontando para o nameserver autoritativo antigo:

NS_ANTIGO=ns1.fornecedorantigo.com
DOM=exemplo.com

for T in SOA NS A AAAA MX TXT CAA; do
  dig +noall +answer @$NS_ANTIGO $DOM $T
done

Para subdomínios, você precisa saber o nome: dig não enumera. Teste a lista de sempre e a lista do cliente:

for H in www mail ftp webmail autodiscover cpanel loja blog api _dmarc; do
  dig +noall +answer @$NS_ANTIGO $H.$DOM A
  dig +noall +answer @$NS_ANTIGO $H.$DOM CNAME
done

dig +noall +answer @$NS_ANTIGO _dmarc.$DOM TXT
dig +noall +answer @$NS_ANTIGO default._domainkey.$DOM TXT

O seletor DKIM muda por provedor de e-mail. default é comum em cPanel, mas Google Workspace e Microsoft 365 usam seletores próprios. Se o cliente usa e-mail externo, pegue o seletor correto no painel do provedor de e-mail, não chute.

Validar com named-checkzone e contar os registros por tipo

Importar zona com erro de sintaxe gera dois cenários ruins: o painel rejeita tudo e você perde tempo, ou aceita parcialmente e você fica com uma zona pela metade sem perceber. Valide local com named-checkzone, que vem no pacote bind-utils (RHEL/Alma/Rocky) ou bind9-utils (Debian/Ubuntu):

named-checkzone exemplo.com exemplo.com.zone

Saída esperada: OK. Erro comum nessa etapa é TXT longo sem aspas corretas e registro sem ponto final no FQDN, o que faz o BIND concatenar o nome da zona e criar mail.exemplo.com.exemplo.com.

Aproveite e conte os registros por tipo. Esse número é a sua conferência depois:

named-compilezone -f text -F text -o - exemplo.com exemplo.com.zone \
  | awk '!/^;/ && NF>=4 {print $4}' | sort | uniq -c

O named-compilezone -o - normaliza o arquivo: ele reescreve toda linha com nome, TTL e classe explícitos, então a quarta coluna passa a ser sempre o tipo. Se você rodar o awk direto no arquivo original, linhas com nome herdado da anterior ou TTL omitido deslocam as colunas e a contagem sai errada sem reclamar. Caso não tenha o named-compilezone disponível, conte manualmente pelo menos MX, TXT e SRV, que são os tipos onde a diferença dói.

Anote o resultado. Se o arquivo tem 14 A, 6 CNAME, 3 MX e 5 TXT, a zona no destino precisa ter o mesmo, descontando o que você decidir mudar de propósito.

O que não deve ser copiado literal da zona antiga

Nem tudo da zona antiga deve atravessar. Três categorias precisam de decisão consciente:

Tipo Copiar literal? O que fazer
SOA Não O destino gera o próprio. Serial, nameserver primário e e-mail de contato são do novo servidor.
NS Não Substituir pelos nameservers do destino.
A/AAAA do site Não Apontar para o IP novo, não para o IP do servidor antigo.
A/AAAA de serviço externo Sim CDN, servidor de aplicação separado, IP de outro fornecedor.
MX Depende Se o e-mail fica no destino, usar os MX do destino. Se o e-mail é externo, copiar idêntico, prioridades inclusive.
TXT de SPF Revisar Precisa incluir o novo servidor de envio se o e-mail migrar junto.
TXT de verificação Sim Google, Microsoft, Facebook, plataformas de disparo. Copiar caractere por caractere.
DKIM Depende Se o e-mail fica no destino, gerar chave nova no destino. Se é externo, copiar.
DMARC Sim Copiar e revisar a política depois da migração estabilizar.
CAA Sim A menos que a CA mude.
SRV Sim Autodiscover, SIP, XMPP. Prioridade, peso, porta e alvo precisam bater.

No destino, o DNS Zone Manager do cPanel/WHM permite adicionar, editar e remover registros da zona, e a documentação detalha os campos exigidos por tipo. A inserção é registro a registro no formulário: não conte com colar o bloco inteiro de uma vez. Com acesso root ao servidor de destino, dá para contornar editando o arquivo em /var/named/ e recarregando o BIND, mas aí você assume a sintaxe e o serial por conta própria.

Por que baixar o TTL para 300 uma semana antes

Uma semana antes da virada, reduza o TTL dos registros que vão mudar para 300 segundos no fornecedor antigo. Isso encurta a janela em que resolvedores ainda entregam o IP velho. Depois que a migração estabilizar, volte para 3600 ou mais. TTL baixo permanente aumenta consulta à toa.

Comparar os dois nameservers com diff antes de virar

Com a zona pronta no destino e os nameservers ainda apontando para o antigo, você consegue comparar os dois lados em produção, sem risco. Consulte o nameserver novo diretamente:

NS_NOVO=ns1.fornecedornovo.com
NS_ANTIGO=ns1.fornecedorantigo.com
DOM=exemplo.com

for T in MX TXT CAA; do
  echo "== $T =="
  diff <(dig +short @$NS_ANTIGO $DOM $T | sort) \
       <(dig +short @$NS_NOVO   $DOM $T | sort)
done

Saída vazia significa igualdade. Diferença em A do domínio raiz e em NS é esperada e desejada. Diferença em MX ou TXT quando o e-mail é externo é bug seu.

Checklist de conferência por tipo, na ordem em que vale a pena fazer:

  1. MX: host e prioridade idênticos ao antigo, se o e-mail não migra. Se migra, confira contra a documentação do novo servidor de e-mail.
  2. TXT de SPF: um único registro SPF por domínio. Dois SPF quebram a validação. Confira o número de mecanismos que exigem consulta DNS, o limite do protocolo é 10.
  3. TXT de verificação: compare string por string, sem reescrever. Copiar e colar, nunca digitar.
  4. DKIM: a chave pública é longa e quebra em múltiplas strings entre aspas. Confira se o painel novo preservou a quebra ou se concatenou errado.
  5. DMARC: _dmarc presente e com a mesma política.
  6. CNAME: nenhum CNAME no apex. Nenhum CNAME apontando para nome que deixou de existir.
  7. SRV: prioridade, peso, porta, alvo. Autodiscover errado quebra Outlook sem gerar erro visível no site.
  8. A/AAAA de subdomínio: cada um com destino decidido, nenhum sobrando apontando para IP antigo que vai ser desativado.
  9. DNSSEC: confira se a zona antiga está assinada e se há registro DS publicado no registrador. dig +short DS exemplo.com @8.8.8.8 e dig +dnssec exemplo.com SOA respondem isso. Se houver DS e o destino não assinar a zona com a mesma chave, a resolução não degrada: ela para, com SERVFAIL para todo mundo que valida.

A ordem da virada quando existe DNSSEC na zona antiga

Troque os nameservers no registrador só depois que o diff acima estiver limpo.

Se a zona antiga tem DNSSEC ativo, a ordem muda. Primeiro desative o DNSSEC no fornecedor antigo e remova o registro DS no registrador. Depois espere o TTL do DS expirar (consulte o TTL com dig DS exemplo.com @8.8.8.8 e, na dúvida, conte 24 horas, já que muitos TLDs publicam DS com TTL longo). Só então troque os nameservers. Trocar NS com DS publicado e zona não assinada no destino derruba o domínio inteiro com SERVFAIL nos resolvedores validadores, e isso inclui Google Public DNS e Cloudflare. Reative o DNSSEC no destino e publique o novo DS depois que a migração estabilizar. A partir daí, resolvedores no mundo passam a consultar o novo conjunto conforme o cache de cada um expira.

Mantenha o serviço antigo ligado por pelo menos 72 horas depois da virada. Não cancele no mesmo dia. Resolvedor que ignora TTL existe, e e-mail entregue no servidor velho durante a propagação você só recupera se o velho ainda estiver de pé.

Frase pronta para o cliente, pode copiar:

Ela funciona porque dá prazo, explica o comportamento estranho antes de ele acontecer e oferece saída. Cliente que foi avisado do comportamento não abre chamado de urgência.

Decisão de virada quando existe DNSSECZona antiga tem DNSSEC?dig DS e dig +dnssec SOASe não tem: trocar NSDiff limpo, segue diretoSe tem: desativar DNSSECNo fornecedor antigoRemover DS no registradorEsperar o TTL do DSTrocar os nameserversSó depois do DS expirarReativar DNSSEC no destinoPublicar novo DS depois
Trocar NS com DS publicado e zona não assinada gera SERVFAIL em resolvedores validadores.

Transformar a migração em artefato para a carteira

Se você mantém 20 ou 200 sites, transforme isso em artefato. Para cada domínio, uma pasta no repositório do cliente com:

O arquivo .antes é o seu rollback documental: se algo quebrar em três semanas e ninguém souber qual TXT sumiu, ele responde em dez segundos. O inventario.md é o que impede a próxima migração de redescobrir do zero que aquele CNAME esquisito é da ferramenta de disparo.

Uma última recomendação contra o próprio interesse: se a zona do cliente tem cinco registros e o e-mail é externo, não vale montar todo esse processo. Exporte, confira o MX e o SPF, vire. O ritual completo compensa quando há subdomínio, SRV, DKIM e serviço de terceiro no meio, que é justamente onde a redigitação costuma quebrar.

Referências

  1. Documentação oficial (cpanel) — DNS Zone Manager. Consultado em 2026-10-29.
Leia também