blog
Domínios e DNS

Editar o DNS do cliente pelo WHM sem a senha do cPanel

O roteiro da revenda: confirmar quem é autoritativo, exportar a zona, editar no DNS Zone Manager e validar MX e SPF no próprio nameserver antes de avisar o cliente.

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

Resposta curta: pelo DNS Zone Manager do WHM, em DNS Functions, a revenda abre a zona do cliente em Manage e edita os registros sem a senha do cPanel. Antes, confirme que seus nameservers respondem pelo domínio e exporte a zona com dig; depois, valide MX e SPF direto no ns1 e ns2.

Neste artigo
  1. Por que editar pelo WHM e não pelo cPanel do cliente
  2. Confirme quem responde pelo domínio antes de tocar na zona
  3. Exporte os registros atuais antes de qualquer mudança
  4. Como editar o registro no DNS Zone Manager do WHM
  5. Como validar MX e SPF no nameserver e não no cache
  6. Um checklist para repetir em cada domínio, com a frase para o cliente
  7. Quando o DNS Zone Manager não resolve e o que fazer

Este é um artigo documental: o procedimento segue a documentação oficial do DNS Zone Manager do WHM, consultada em 2026-11-09. Não houve medição própria. Os domínios e nameservers dos exemplos são fictícios.

Por que editar pelo WHM e não pelo cPanel do cliente

Os tutoriais de DNS no cPanel partem do login do dono do site. Para uma revenda, esse login costuma ser um problema. O cliente esqueceu a senha, ou a senha é dele e você não quer guardar, ou trocar a senha só para mudar um registro TXT cria outro chamado.

O WHM resolve isso com o DNS Zone Manager (em WHM » Home » DNS Functions » DNS Zone Manager). Ele lista as zonas das contas que pertencem à sua revenda e permite adicionar, editar e excluir registros sem entrar no cPanel de ninguém.

Duas condições precisam estar atendidas antes de começar:

Confirme quem responde pelo domínio antes de tocar na zona

Este é o erro mais caro e o mais fácil de evitar. Antes de abrir o WHM, pergunte à internet quais nameservers respondem pelo domínio:

dig +short NS cliente-exemplo.com.br

Se a saída listar os nameservers da sua revenda (no exemplo, ns1.revenda-exemplo.com.br e ns2.revenda-exemplo.com.br), o DNS Zone Manager é o lugar certo. Se aparecer *.ns.cloudflare.com ou o DNS do registrador, a edição tem que ser feita lá, e o WHM só serve como referência do que o servidor espera receber.

Um caso comum em agência: o site foi migrado para a sua revenda, mas os nameservers nunca foram trocados no registro.br. O site funciona porque alguém apontou um registro A no DNS antigo. Qualquer ajuste de MX ou SPF feito no WHM, nesse cenário, fica invisível.

Onde editar o DNS depende do nameserverdig +short NS retorna a revenda?Confira o nameserver autoritativo primeiroSim: editar no DNS Zone ManagerO servidor da revenda responde pelo domínioNão: editar onde o domínio apontaWHM não muda nada para a internet
Antes de abrir o WHM, descubra quem responde pelo domínio.

Exporte os registros atuais antes de qualquer mudança

A documentação consultada não descreve uma exportação ou backup da zona com um clique no DNS Zone Manager. Então trate o backup como tarefa sua. Ele serve para duas coisas: desfazer um erro em minutos e provar ao cliente como estava antes.

A forma mais simples é consultar o nameserver autoritativo diretamente, tipo por tipo, e salvar em arquivo:

for t in SOA NS A AAAA MX TXT CNAME CAA; do
  dig +noall +answer @ns1.revenda-exemplo.com.br cliente-exemplo.com.br $t
done > zona-cliente-exemplo-antes.txt

Repita para os nomes que importam além da raiz, porque a consulta acima só cobre o domínio principal:

for n in www mail webmail _dmarc default._domainkey; do
  dig +noall +answer @ns1.revenda-exemplo.com.br $n.cliente-exemplo.com.br ANY
done >> zona-cliente-exemplo-antes.txt

Alguns servidores respondem de forma mínima a consultas ANY. Se algum nome vier vazio, consulte o tipo específico (TXT para _dmarc, por exemplo). Como complemento, abra a zona no WHM pelo botão Manage e copie a tabela de registros para o mesmo arquivo. Dez segundos de cópia valem mais do que reconstruir um DKIM de memória.

Guarde o arquivo na pasta do cliente com data no nome. Em agência com vários sites, isso vira o histórico de DNS que o cliente nunca teve.

Como editar o registro no DNS Zone Manager do WHM

Segundo a documentação, a tela inicial do DNS Zone Manager lista os domínios e oferece atalhos para adicionar registros A, CNAME e MX, além do botão Manage, que abre a edição completa da zona.

Como achar a zona certa entre domínios parecidos

Use o campo de busca para filtrar pelo domínio do cliente. Confira o nome com atenção: revendas com muitos clientes costumam ter domínios parecidos, e a zona errada aceita a edição sem reclamar.

Onde filtrar MX e TXT dentro da zona

Na edição completa, filtre por tipo de registro para achar o que vai mudar. Para alteração de MX ou SPF, filtre por MX e depois por TXT.

Por que editar o registro existente em vez de criar outro

Para trocar um valor, use Edit no registro existente e salve. Criar um registro novo ao lado do antigo é a origem dos dois problemas mais comuns: dois registros SPF no mesmo nome (o que invalida a verificação) e um MX antigo ainda com prioridade melhor que o novo.

Quando reduzir o TTL antes de trocar o valor

Se vai migrar o e-mail do cliente para outro provedor, reduza o TTL dos registros envolvidos com antecedência, espere o TTL antigo expirar e só então troque os valores. Para um TXT de verificação, isso é desnecessário.

O que anotar depois de salvar e por que o ns2 importa

Anote no arquivo do cliente o que mudou, de qual valor para qual. O serial da zona é incrementado ao salvar. A forma como a mudança chega ao ns2 depende da configuração do servidor (cluster DNS do cPanel ou NOTIFY/AXFR entre primário e secundário). Por isso a checagem no segundo nameserver, logo abaixo, não é opcional.

Como validar MX e SPF no nameserver e não no cache

Não valide pelo resolvedor do seu escritório ou por um site de propagação. Eles podem estar mostrando cache. Pergunte ao nameserver da revenda, que é a fonte:

dig +short @ns1.revenda-exemplo.com.br cliente-exemplo.com.br MX
dig +short @ns1.revenda-exemplo.com.br cliente-exemplo.com.br TXT

O que conferir na saída:

Item Resultado esperado Sinal de problema
MX Só os servidores do provedor de e-mail atual MX antigo ainda presente
Prioridade do MX A ordem que o provedor documenta Servidor antigo com número menor
SPF Um único TXT começando com v=spf1 Dois registros v=spf1
Includes do SPF O provedor atual incluído Include do provedor antigo sem uso
DKIM e DMARC Presentes como antes da mudança Sumiram após a edição
Segundo nameserver Mesma resposta que o primeiro Resposta diferente ou desatualizada

A última linha importa. Repita as consultas trocando ns1 por ns2. Se o segundo nameserver devolver a versão antiga por mais que alguns minutos, a sincronização entre eles tem um problema, e isso é assunto para quem administra o servidor.

Depois de confirmado no autoritativo, o restante do mundo vê a mudança conforme o TTL antigo expira nos caches.

Um checklist para repetir em cada domínio, com a frase para o cliente

Para padronizar em todos os sites da carteira, o roteiro cabe em uma lista:

  1. dig +short NS no domínio: o servidor da revenda é autoritativo?
  2. Exportar a zona para zona-dominio-antes.txt com data.
  3. Editar no DNS Zone Manager pelo Manage, sempre editando o registro existente.
  4. Validar MX e TXT no ns1 e no ns2.
  5. Exportar de novo para zona-dominio-depois.txt e guardar os dois arquivos.
  6. Avisar o cliente com prazo realista.

O penúltimo item do checklist transforma o diff entre os dois arquivos em comprovante da mudança.

A frase que costuma funcionar com o cliente final, sem abrir discussão técnica:

Roteiro padrão de edição de DNS no WHMConfirmar nameserverRevenda é autoritativa para o domínioExportar zona antesArquivo com data no nomeEditar registro existenteUse Edit pelo botão ManageValidar ns1 e ns2Mesma resposta nos dois nameserversExportar zona depoisGuarde os dois arquivos para o diff
Roteiro para repetir em cada domínio da carteira.

Quando o DNS Zone Manager não resolve e o que fazer

Há situações em que o DNS Zone Manager não resolve, e insistir nele só gasta tempo:

Em todos os casos, o backup prévio e a checagem no nameserver continuam valendo. Eles independem de onde a zona é editada.

Referências

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