blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 8 blocos de código

Resposta curta: 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.

Neste artigo
  1. Monte a lista com addon e parked, não só o domínio principal
  2. Por que o dig rodado dentro do servidor mente sobre a delegação
  3. Os quatro baldes, e o que quebra em cada um
  4. NS correto não prova nada sobre o A e o MX
  5. O TTL decide a ordem da fila de migração
  6. O que escrever para o cliente que controla o DNS em outro painel
  7. Checklist para reusar no próximo lote

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.

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

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

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

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

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.

Quatro baldes da auditoria de delegaçãoBalde 1: NS no destinoZona sua, só editar o ABalde 2: NS do host antigoSite e e-mail ficam no antigoBalde 3: DNS em terceiroA congelado no IP velhoBalde 4: sem zona respondendoJá quebrado, investigar antes
Classificação de cada linha do CSV em quatro grupos de decisão.

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:

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.

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

  1. 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.
  2. Avise o balde 3 e o balde 2 em seguida, porque dependem de terceiro e o tempo de resposta não é seu.
  3. Resolva o balde 4 sem pressa, fora da janela de migração.
  4. 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.

Ordem da fila de migração por baldeBaixar TTLBalde 1 e pedido ao balde 3Avisar terceirosBaldes 3 e 2, fora do seu controleResolver balde 4Fora da janela de migraçãoMigrar balde 1Por último, com TTL baixoRepetir o loopComparar com o CSV anterior
Ordem da fila de migração definida pelo TTL e pela dependência de terceiros.

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:

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

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.

Referências

  1. Documentação oficial (cpanel) — WHM: Nameserver Record Report. Consultado em 2026-09-30.
Leia também