# Quais domínios da revenda ainda usam o nameserver antigo

Um loop de dig, um CSV de quatro colunas e uma decisão por grupo, em vez de abrir conta por conta no painel antes de trocar o IP.

> classifique a carteira em 4 baldes com um loop de dig NS contra um resolvedor público: NS já no destino, NS do fornecedor antigo, DNS em terceiro e domínio sem zona respondendo. Cada balde tem um responsável e uma ordem de execução ditada pelo TTL.

João Rizzon · 2026-10-01 · Revenda

---

Trocar o IP de um lote de contas sem saber onde cada domínio aponta é o jeito mais rápido de passar um fim de semana respondendo "o site sumiu". A auditoria que evita isso cabe em um loop de `dig` e numa planilha de quatro colunas. O trabalho não é técnico, é de organização: você precisa saber, antes de mexer, quem controla a delegação de cada domínio da carteira.

## Monte a lista com addon e parked, não só o domínio principal

A fonte da lista depende do seu acesso. Com WHM de revenda, a lista de contas já dá o domínio principal de cada conta. Com acesso root ao servidor, `/etc/userdomains` é mais completo, porque inclui domínios adicionais (addon), subdomínios e parked, que são exatamente os que ficam de fora quando alguém confere "domínio por domínio" no painel.

```bash
# domínios do servidor, um por linha, sem o usuário
awk -F: '{print $1}' /etc/userdomains | sort -u > dominios.txt
wc -l dominios.txt
```

Se você só tem WHM de revenda, exporte a lista de contas pela interface e salve no mesmo formato: um domínio por linha. O resto do processo é idêntico.

Vale separar desde já os subdomínios dos domínios registráveis. Um subdomínio não tem delegação própria no registro na maioria dos casos: ele segue a zona do domínio pai. Consultar NS de `loja.cliente.com.br` costuma devolver o NS do pai ou nada, e isso polui o relatório.

```bash
# só os domínios de segundo nível .com.br e .com (ajuste para seus TLDs)
grep -E '^[^.]+\.(com\.br|com|net\.br)$' dominios.txt > raiz.txt
```

## Por que o dig rodado dentro do servidor mente sobre a delegação

Este é o erro que mais atrapalha. Rodar `dig NS dominio.com.br` dentro do servidor que hospeda o domínio pode devolver a zona local, porque o resolvedor da máquina enxerga o arquivo de zona antes de perguntar ao mundo. Você vê o NS que você mesmo configurou e conclui que está tudo delegado.

Force um resolvedor externo com `@` e peça a resposta autoritativa de quem delega. Duas consultas diferentes, dois significados:

```bash
# o que o mundo enxerga (resposta do resolvedor público)
dig +short NS cliente.com.br @1.1.1.1

# o que o registro delega (pergunta direta ao TLD, sem cache)
dig +trace NS cliente.com.br | tail -n 5
```

O loop da carteira inteira, com pausa para não martelar o resolvedor:

```bash
while read d; do
  ns=$(dig +short NS "$d" @1.1.1.1 | sort | tr '\n' ' ')
  a=$(dig +short A "$d" @1.1.1.1 | head -n1)
  mx=$(dig +short MX "$d" @1.1.1.1 | head -n1)
  echo "$d|${ns:-SEM_NS}|${a:-SEM_A}|${mx:-SEM_MX}"
  sleep 0.2
done < raiz.txt | tee auditoria.csv
```

Exemplo de saída (fictício, só para ilustrar o formato):

```
cliente-a.com.br|ns1.seudominio.com.br. ns2.seudominio.com.br.|203.0.113.10|mx.seudominio.com.br.
cliente-b.com.br|ns1.antigohost.com. ns2.antigohost.com.|198.51.100.4|mail.antigohost.com.
cliente-c.com.br|dana.ns.cloudflare.com. rick.ns.cloudflare.com.|SEM_A|aspmx.l.google.com.
cliente-d.com.br|SEM_NS|SEM_A|SEM_MX
```

Quem administra o servidor pelo WHM tem ainda o **Nameserver Record Report**, em DNS Functions, que compara, para cada domínio do servidor, os nameservers registrados no domínio com os nameservers do servidor, segundo a [documentação do cPanel](https://docs.cpanel.net/whm/dns-functions/nameserver-record-report/). É um bom cruzamento com o seu CSV: a interface é mais rápida para olhar, o CSV é o que você versiona e reusa no próximo lote.

## Os quatro baldes, e o que quebra em cada um

Classifique cada linha do CSV em um dos quatro grupos. A decisão muda por grupo, não por cliente.

| Balde | Como identificar na saída | O que quebra ao trocar o IP | Quem age |
|---|---|---|---||
| 1. NS já no destino | NS iguais aos do servidor novo | Nada, se a zona no destino já tem o A novo | Só você |
| 2. NS do fornecedor antigo | NS de outro provedor de hospedagem | Site e e-mail continuam no antigo até a delegação mudar | Você (se tem acesso) ou o cliente, no registrador |
| 3. DNS em terceiro | NS de Cloudflare, Registro.br, agência | Nada muda sozinho: o A/MX continua apontando para o IP velho | Quem opera aquele painel de DNS |
| 4. Sem zona respondendo | `SEM_NS` no CSV (o status vem numa segunda consulta, sem `+short`) | Já está quebrado hoje; a migração não é a causa | Investigar antes de migrar |

O balde 2 é o clássico da migração mal planejada: você move os arquivos, liga o servidor novo e o mundo continua vendo o antigo. O balde 3 é o mais perigoso, porque parece saudável. A delegação está estável, ninguém precisa mexer no registrador, e por isso mesmo o registro A fica congelado apontando para um IP que você acabou de desligar.

O balde 4 merece um olhar separado. O `+short` do loop não imprime o status da resposta, então o CSV só marca `SEM_NS`. Para cada linha assim, rode uma consulta completa e leia o status:

```bash
while IFS='|' read d ns resto; do
  [ "$ns" = "SEM_NS" ] || continue
  st=$(dig NS "$d" @1.1.1.1 | grep -o 'status: [A-Z]*' | head -n1)
  echo "$d|$st"
done < auditoria.csv
```

NOERROR sem resposta, SERVFAIL e REFUSED têm causas diferentes. Resposta REFUSED normalmente quer dizer que o servidor consultado não é autoritativo para aquela zona e se recusa a responder. Domínio expirado, zona removida ou delegação para um servidor que nunca recebeu a zona caem aí. Não migre esse domínio junto com o lote: resolva ou arquive.

## NS correto não prova nada sobre o A e o MX

Um relatório de nameserver responde a uma pergunta só: para onde o registro delega a zona. Ele não diz qual IP está no registro A, nem para onde o MX aponta, nem se existe um CNAME antigo no `www`.

Por isso o loop acima já traz A e MX como colunas vizinhas. A combinação importa mais que cada campo isolado:

- NS no destino e A no IP velho: a zona está sob seu controle, a correção é editar o A. Rápido.
- NS no destino e MX apontando para outro provedor: e-mail está fora. Se você copiar a zona padrão do servidor novo por cima, derruba o e-mail do cliente.
- NS de terceiro e A no IP velho: ninguém no seu lado consegue corrigir. É pedido ao cliente ou à agência.
- NS no destino, A correto, mas sem resposta em `www`: subdomínio esquecido, o caso mais comum de "migrou e o site abre sem www".

Se o site usa certificado emitido por validação HTTP, o A errado também impede a renovação. O site pode continuar no ar pelo provedor antigo e o certificado do seu servidor falha em silêncio, até expirar.

## O TTL decide a ordem da fila de migração

TTL é o tempo que um resolvedor guarda a resposta em cache. Enquanto ele não expira, mudar a zona não muda o que o visitante enxerga.

```bash
# TTL atual do A e do NS
dig +noall +answer A cliente.com.br @1.1.1.1
dig +noall +answer NS cliente.com.br @1.1.1.1
```

Na saída de `+noall +answer` cada linha vem na ordem nome, TTL, classe, tipo e dado. O TTL é o segundo campo da linha, o primeiro numérico, em segundos:

```
cliente.com.br.   300   IN   A   203.0.113.10
```

Nesse exemplo faltam 300 segundos para o cache expirar. Monte a fila assim:

- **Baixe o TTL primeiro** nos domínios do balde 1, onde a zona está no seu servidor, pelo menos um ciclo completo antes da data da migração. No balde 3, peça a redução a quem opera o painel junto com o aviso. Baixar TTL em cima da hora não adianta: o cache antigo ainda carrega o valor alto.
- **Avise o balde 3 e o balde 2 em seguida**, porque dependem de terceiro e o tempo de resposta não é seu.
- **Resolva o balde 4** sem pressa, fora da janela de migração.
- **Migre o balde 1 por último**, quando o TTL já estiver baixo e as outras pendências estiverem encaminhadas.

Depois da troca, repita o mesmo loop com `@8.8.8.8` e `@1.1.1.1` e compare com o CSV antigo. A auditoria vira verificação sem trabalho extra.

## O que escrever para o cliente que controla o DNS em outro painel

Quando o domínio cai no balde 3, a mensagem precisa ser curta e pedir uma ação única. Texto pronto, adapte os valores:

> **** O domínio **cliente.com.br** tem o DNS administrado fora da nossa hospedagem (hoje responde pelos nameservers da Cloudflare). Vamos mudar o endereço IP do servidor em **data**. Para o site continuar no ar, alguém com acesso a esse painel precisa alterar o registro A de `cliente.com.br` e de `www` para **IP novo** na data combinada. O e-mail não será afetado se o registro MX for mantido como está. Se preferir, podemos fazer a alteração: basta nos enviar um acesso com permissão apenas de DNS.

Duas coisas que essa frase faz e o e-mail genérico não faz: nomeia o registro exato que precisa mudar e separa site de e-mail. Cliente que entende que o e-mail não para costuma aprovar a janela mais rápido.

## Checklist para reusar no próximo lote

- Lista completa vindo de `/etc/userdomains` ou da lista de contas do WHM, com addon e parked incluídos.
- Subdomínios separados dos domínios registráveis antes de consultar NS.
- Consulta sempre com `@` em resolvedor público, nunca no resolvedor do próprio servidor.
- `+trace` nos casos duvidosos, para ver a delegação no TLD em vez do cache.
- CSV com quatro colunas: domínio, NS, A, MX.
- Classificação nos quatro baldes e uma decisão por balde, não por cliente.
- TTL reduzido com antecedência nos domínios sob seu controle.
- Cruzamento com o Nameserver Record Report do WHM para os domínios hospedados no servidor.
- Repetição do loop depois da migração, comparando com o CSV anterior.

Guarde o `auditoria.csv` com a data no nome. Na próxima migração, o diff entre os dois arquivos mostra em segundos quais domínios mudaram de mãos desde a última vez.

