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

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

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

---

Este é um artigo documental: o procedimento segue a [documentação oficial do DNS Zone Manager do WHM](https://docs.cpanel.net/whm/dns-functions/dns-zone-manager/), 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:

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

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

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

```bash
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 NS` no domínio: o servidor da revenda é autoritativo?
- Exportar a zona para `zona-dominio-antes.txt` com data.
- Editar no DNS Zone Manager pelo **Manage**, sempre editando o registro existente.
- Validar MX e TXT no `ns1` e no `ns2`.
- Exportar de novo para `zona-dominio-depois.txt` e 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:

> **** "Atualizei o endereço de entrega dos seus e-mails no servidor de DNS. A mudança já está valendo na origem, e nas próximas horas os provedores de internet vão atualizando a cópia que guardam. Guardei a configuração anterior caso a gente precise voltar."

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

