# 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.

> 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.

João Rizzon · 2026-10-30 · Domínios e DNS

---

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](https://docs.cpanel.net/whm/dns-functions/dns-zone-manager/130/) 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:

- Acesso ao painel do fornecedor antigo com permissão de exportar ou ao menos visualizar a zona completa.
- Acesso ao WHM ou cPanel do destino com o DNS Zone Manager disponível.
- O TTL atual dos registros principais (você vai querer baixá-lo antes da virada).
- A lista de serviços externos que dependem de DNS nesse domínio: e-mail, CDN, ferramenta de e-mail marketing, verificação de propriedade do Search Console, Microsoft 365, SSL por validação DNS.

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.

## 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:

```bash
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:

```bash
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:

```bash
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):

```bash
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:

```bash
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:

```bash
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:

- **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.
- **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.
- **TXT de verificação**: compare string por string, sem reescrever. Copiar e colar, nunca digitar.
- **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.
- **DMARC**: `_dmarc` presente e com a mesma política.
- **CNAME**: nenhum CNAME no apex. Nenhum CNAME apontando para nome que deixou de existir.
- **SRV**: prioridade, peso, porta, alvo. Autodiscover errado quebra Outlook sem gerar erro visível no site.
- **A/AAAA de subdomínio**: cada um com destino decidido, nenhum sobrando apontando para IP antigo que vai ser desativado.
- **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:

> **** Vamos transferir a configuração de endereços do seu domínio para o novo servidor. A configuração é copiada integralmente e conferida antes da troca, então o site e os e-mails continuam funcionando. Durante até 72 horas após a troca, parte dos visitantes ainda pode ser atendida pelo servidor antigo, que seguirá ligado nesse período justamente por isso. Não há interrupção prevista. Se você receber um e-mail nesse intervalo e ele não aparecer na caixa, me avise que eu recupero.

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.

## 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:

- `dominio.com.zone.antes` (exportação original, nunca editada)
- `dominio.com.zone.depois` (a zona que foi importada)
- `inventario.md` com a lista de serviços externos que dependem de DNS e quem contratou cada um
- a saída do `uniq -c` por tipo, antes e depois

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.

