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.

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
- Por que editar pelo WHM e não pelo cPanel do cliente
- Confirme quem responde pelo domínio antes de tocar na zona
- Exporte os registros atuais antes de qualquer mudança
- Como editar o registro no DNS Zone Manager do WHM
- Como validar MX e SPF no nameserver e não no cache
- Um checklist para repetir em cada domínio, com a frase para o cliente
- 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:
- Privilégio de DNS na revenda. Quem define o que uma revenda enxerga no WHM é o administrador do servidor, nos privilégios da conta de revenda. Se o DNS Zone Manager não aparece no seu menu, o pedido vai para quem administra o servidor, não para o suporte do cliente.
- O servidor precisa ser autoritativo para o domínio. Se o domínio usa nameservers de terceiros (Cloudflare, o próprio registrador, outro provedor), editar a zona no WHM não muda nada para o mundo. A zona existe localmente, mas ninguém a consulta.
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.
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:
dig +short NSno domínio: o servidor da revenda é autoritativo?- Exportar a zona para
zona-dominio-antes.txtcom data. - Editar no DNS Zone Manager pelo Manage, sempre editando o registro existente.
- Validar MX e TXT no
ns1e nons2. - Exportar de novo para
zona-dominio-depois.txte guardar os dois arquivos. - 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:
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:
- Nameservers de terceiros. Edite onde o domínio aponta. Se o cliente detém o acesso, envie a ele os valores exatos copiados da zona do WHM.
- Revenda sem o privilégio de DNS. Peça ao administrador do servidor. Contornar pedindo a senha do cliente resolve hoje e cria o mesmo problema na próxima vez.
- Recurso que só existe no cPanel do usuário. Algumas ferramentas de e-mail do cPanel geram ou validam registros automaticamente. Pelo WHM, a revenda consegue abrir o cPanel da conta a partir da lista de contas, sem a senha do cliente, e usar a ferramenta de lá.
Em todos os casos, o backup prévio e a checagem no nameserver continuam valendo. Eles independem de onde a zona é editada.
Referências
- Documentação oficial (cpanel) — DNS Zone Manager (WHM). Consultado em 2026-11-09.