# Terminate Accounts no WHM sem apagar a zona DNS

A ordem das operações no Terminate Accounts do WHM, o que some junto com a conta e como provar que o disco voltou.

> marque a opção de preservar a zona DNS no Terminate Accounts do WHM. Sem ela, a zona é removida junto com a conta e o domínio passa a responder REFUSED enquanto ainda delegar para os seus nameservers. Antes do clique, backup final conferido fora do servidor.

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

---

## O que o Terminate Accounts apaga e o que ele não desfaz

Primeiro, o aviso de honestidade: não há medição de laboratório neste artigo. Nada aqui foi cronometrado ou testado em bancada da Napoleon. O conteúdo se apoia na [documentação oficial do WHM sobre Terminate Accounts](https://docs.cpanel.net/whm/account-functions/terminate-accounts/) e na ordem em que as operações precisam acontecer para que nenhum passo dependa de algo que você já apagou.

A documentação do cPanel é explícita quanto ao caráter da operação: a remoção da conta é permanente e não pode ser desfeita pela interface. O que sai junto, no mesmo clique: o diretório home com todos os arquivos, as caixas e os dados de e-mail, os bancos de dados, as contas FTP, as tarefas cron do usuário e a zona DNS do domínio principal, a menos que você marque a opção para preservá-la.

Esse último item é o que derruba cliente de terceiros. A zona DNS não pertence logicamente à conta, ela pertence à delegação do domínio. Se o domínio do ex-cliente ainda delega para `ns1`/`ns2` da sua revenda no momento em que você termina a conta, a zona some e os seus nameservers passam a responder por um domínio que não conhecem mais. O resultado é `status: REFUSED` em qualquer consulta. O site sai do ar à medida que o cache do registro A expira nos resolvers, ou seja, dentro do TTL que a zona publicava, não no instante da remoção. O e-mail quebra de um jeito diferente e mais traiçoeiro: sem resposta válida para o MX, o MTA remetente trata a falha de DNS como erro temporário e mantém a mensagem em fila, retentando por dias (muitos servidores usam uma janela padrão de 4 a 5 dias) antes de devolver ao remetente. Na prática, o cliente descobre o problema primeiro pelo site, e depois recebe uma enxurrada de devoluções de mensagens que ficaram paradas desde o dia da remoção.

Como revendedor, você só enxerga em Terminate Accounts as contas que possui. Isso limita o estrago possível, mas não limita o estrago na zona.

## O backup final precisa sair do servidor antes do primeiro clique

A regra é simples: o arquivo precisa estar em uma máquina que não seja o servidor de hospedagem antes de você abrir a tela de remoção. Backup que mora no `/home` da conta que você vai apagar não é backup, é cópia condenada.

### Como gerar o backup completo da conta pelo cPanel

O caminho mais previsível é pelo próprio cPanel da conta, em Backup, gerando um backup completo (`Download a Full Account Backup`). Ele produz um `.tar.gz` no diretório home e, se o seu provedor permitir, pode enviá-lo direto por FTP ou SCP para um destino externo. Se a opção estiver desabilitada no servidor, o plano B é um backup por partes: home via FTP/SFTP, bancos via phpMyAdmin ou `mysqldump`, e e-mail via IMAP com um cliente que baixe tudo.

### Como conferir que o .tar.gz abre e contém o que deveria

Baixado o arquivo, confira antes de apagar qualquer coisa. Os comandos abaixo listam o conteúdo sem extrair, o que é rápido mesmo em arquivos grandes. O nome do arquivo é fictício, troque pelo seu.

```bash
# o arquivo abre? se o gzip estiver truncado, isto falha aqui
tar -tzf backup-9.9.2026_00-00-00_cliente.tar.gz > /dev/null && echo OK

# os blocos que precisam existir
tar -tzf backup-9.9.2026_00-00-00_cliente.tar.gz | grep -m1 '/homedir/'
tar -tzf backup-9.9.2026_00-00-00_cliente.tar.gz | grep -m1 '/mysql/'
tar -tzf backup-9.9.2026_00-00-00_cliente.tar.gz | grep -m1 '/homedir/mail/'

# encaminhadores, filtros e cron, que quase ninguém confere
tar -tzf backup-9.9.2026_00-00-00_cliente.tar.gz | grep -E '/(va|vf|cron)/'

# tamanho real do que chegou
ls -lh backup-9.9.2026_00-00-00_cliente.tar.gz
```

Se `tar -tzf` retorna erro de fim inesperado de arquivo, o download truncou. Baixe de novo, de preferência por SFTP com retomada, e repita a conferência. Um `.tar.gz` de poucos KB quando a conta usa centenas de MB é sinal de backup abortado por cota de disco durante a geração, que é exatamente o cenário de conta cheia de cliente saindo.

### O que precisa estar dentro do tarball para o backup valer

Os caminhos abaixo são relativos à raiz do pacote `cpmove` dentro do tarball.

| Item | Onde olhar no tarball | Por que costuma faltar |
|---|---|---||
| Arquivos do site | `homedir/public_html/` | Nada, costuma estar |
| E-mail | `homedir/mail/` | Backup parcial feito só do `public_html` |
| Bancos de dados | `mysql/*.sql` | Backup por FTP não leva banco |
| Usuários e senhas de banco | `mysql/*.create` e arquivos de grants | Restaura o banco e o site não conecta |
| Cron | `cron/<usuario>` | Ninguém lembra do cron até o relatório parar |
| Encaminhadores de e-mail | `va/<dominio>` | Some sem ninguém notar por semanas |
| Filtros de e-mail | `vf/<dominio>` | Regra de triagem do cliente evapora na migração |
| Contas de e-mail, senhas e cotas | `homedir/etc/<dominio>/` | Caixa restaurada sem senha, cliente sem acesso |
| Subdomínios e addon domains | arquivo `userdata` e metadados da conta | Reaparece como "faltou uma pasta" |

Se for um cliente com contrato relevante, faça um teste de restauração em outra conta antes de terminar a original. É o único jeito de provar que o backup presta. Custa uma hora e evita a conversa que não tem como vencer.

## Como descobrir se o domínio ainda delega para os seus nameservers

Antes de abrir Terminate Accounts, descubra para onde o domínio delega neste momento. A pergunta não é "o cliente disse que migrou", é "o TLD já responde com os nameservers novos". Perguntar isso a um resolver recursivo (`@8.8.8.8`, por exemplo) não serve: ele pode devolver cache antigo ou o NS que a zona autoritativa publica, que pode ser a sua. A consulta precisa chegar ao servidor do TLD.

```bash
# caminho completo a partir da raiz: mostra quem delega para quem
dig +trace NS dominio-do-cliente.com.br

# ou pergunte direto ao servidor do TLD (.br, neste exemplo)
dig NS dominio-do-cliente.com.br @a.dns.br +noall +authority
# para .com/.net, use um dos gtld-servers: @a.gtld-servers.net

# o seu nameserver ainda é autoritativo para essa zona?
dig @ns1.suarevenda.com.br dominio-do-cliente.com.br SOA +noall +comments
```

Como ler o resultado: no `+trace`, o bloco que vem dos servidores do TLD é uma referência (os NS aparecem na seção AUTHORITY, sem a flag `aa`). É esse bloco que vale, porque é a delegação registrada. O bloco seguinte vem da própria zona autoritativa e pode listar NS diferentes, o que acontece quando alguém editou a zona mas não mexeu no registrador. Se a consulta direta ao servidor do TLD ainda devolve `ns1.suarevenda.com.br`, a delegação é sua, independentemente do que o cliente disse.

Na consulta ao seu nameserver, `status: NOERROR` com flag `aa` significa que a zona existe no seu servidor e está sendo usada. `status: REFUSED` significa que o seu nameserver não tem a zona: se o TLD ainda delega para você, o domínio está fora do ar.

Com essas duas respostas na mão, existem três caminhos e eles não são equivalentes.

| Situação do domínio | O que fazer | Risco |
|---|---|---||
| O TLD já entrega os NS do novo provedor | Terminar a conta normalmente, com ou sem preservar a zona | Baixo |
| O TLD ainda entrega os NS da sua revenda | Manter a conta suspensa pelo tempo da troca, ou terminar preservando a zona DNS | Alto se terminar sem preservar |
| Domínio foi abandonado ou expirou | Terminar a conta e remover a zona | Baixo, só limpa zona órfã |

O meio termo útil é terminar a conta preservando a zona DNS. A documentação do WHM prevê essa opção na própria tela de remoção, e ela existe justamente para o caso em que a delegação ainda não mudou. Você libera disco, e-mail e banco, e o domínio continua resolvendo para o registro que a zona tiver, normalmente o IP do servidor, com o site devolvendo a página de conta inexistente em vez de erro de DNS. É um estado temporário, não um estado final: agende a remoção da zona para depois que a delegação mudar, senão você acumula zonas órfãs no servidor, que é um problema diferente e mais silencioso.

Se o cliente ainda vai levar semanas para trocar nameserver, a opção mais conservadora é não terminar nada: deixe a conta suspensa até a troca. Suspensa, ela não serve páginas, mas mantém zona, caixas e dados no lugar.

## O que some junto com a conta e o que continua existindo depois

O erro comum não é apagar a conta, é supor que a conta era tudo. Parte do que o cliente chama de "meu site" vive fora dela.

**Vai junto com a conta, de uma vez:**

- subdomínios e addon domains configurados dentro do cPanel
- contas FTP, inclusive as que a agência criou para o desenvolvedor
- tarefas cron do usuário, incluindo o `wp-cron` externo e rotinas de integração
- certificados SSL instalados na conta, inclusive os emitidos automaticamente
- filtros, encaminhadores e autorrespostas de e-mail
- bancos de dados e os usuários de banco com senhas próprias
- a zona DNS do domínio principal, salvo se você preservá-la

**Fica fora da conta e continua existindo depois da remoção:**

- o registro do domínio, que vive no registrador e não no WHM
- os registros DNS que estiverem no painel do registrador, se a delegação já foi movida
- backups remotos, Google Workspace, Microsoft 365, CDN, formulários externos
- qualquer backup da própria conta que esteja no destino externo que você configurou

Essa separação também é a lista que você manda para o cliente. "O domínio continua seu, ele não está aqui" resolve metade da ansiedade da saída.

## Executar a remoção com a decisão de DNS já tomada

Com backup conferido fora do servidor e decisão de DNS tomada, a execução é rápida.

### Remover pela interface do WHM e marcar a caixa de preservar zona

Em WHM, em Account Functions, abra Terminate Accounts. A interface lista as contas que você possui e permite selecionar uma ou mais de uma vez. Marque a opção de preservar a zona DNS se a delegação ainda aponta para você, confirme e leia o resultado por conta. A documentação oficial reforça o ponto que importa: a ação é permanente.

Para a maioria dos revendedores, essa é a única via. O lote via linha de comando existe, mas não para quem não administra o servidor.

### Remover pela API quando a saída é em lote

Uma ressalva de fonte antes do exemplo: a página de Terminate Accounts citada neste artigo documenta a interface, não a chamada de API. O parâmetro que preserva a zona (`keepdns`) pertence à documentação da função `removeacct` da API do WHM, que é um documento separado. Confira os nomes dos parâmetros na referência da função antes de rodar em lote, porque eles mudam entre versões e eu não validei esta chamada em bancada.

O binário `whmapi1` roda apenas como `root`, no shell do servidor. Revendedor não tem esse acesso, então o comando abaixo só é útil para quem administra a máquina:

```bash
# só com acesso root no servidor
whmapi1 removeacct user=cliente01 keepdns=1

# remove a conta e a zona junto
whmapi1 removeacct user=cliente01
```

Revendedor com token de API chama a mesma função por HTTPS, autenticando com o próprio usuário de revenda, e só consegue agir sobre as contas que possui:

```bash
curl -sS \
  -H 'Authorization: whm usuariorevenda:TOKEN_AQUI' \
  'https://servidor.exemplo.com.br:2087/json-api/removeacct?api.version=1&user=cliente01&keepdns=1'
```

O token precisa ter a permissão correspondente, concedida por quem administra o servidor. Se a resposta vier com erro de privilégio, é isso que falta, não a sintaxe. Guarde a saída da chamada no seu registro de atendimento. Em disputa posterior, a data e o retorno da chamada valem mais que memória.

### O que fazer quando a remoção falha no meio

Remoção que falha no meio costuma deixar resíduo. Os casos mais comuns: processo do usuário ainda rodando, banco travado, ou a conta ter sido movida de dono. Se a tela retornar erro, não tente de novo em sequência cega. Confira primeiro se a conta ainda aparece em List Accounts e se o diretório home ainda existe. Se o resíduo persistir e você não tem root, esse é o momento de abrir chamado com o provedor do servidor, porque limpeza manual de conta pela metade não é trabalho de revendedor.

## Como provar que o disco voltou para a revenda

Terminar conta é também uma operação de capacidade. Se você fez isso para liberar disco, comprove.

Antes da remoção, anote em WHM, em Account Information, List Accounts, o disco usado pela conta e o total consumido pela sua revenda. Depois da remoção, olhe os mesmos dois números. A diferença no total precisa ser próxima do que a conta usava.

| Momento | Onde olhar | O que anotar |
|---|---|---||
| Antes | WHM, List Accounts | Disco usado da conta e soma da revenda |
| Depois | WHM, List Accounts | Soma da revenda |
| Divergência | Pasta de backup e cota da conta pai | Backups da conta ainda no servidor |

Quando o espaço não volta, a causa quase sempre tem nome: backup da própria conta ainda armazenado no servidor, seja o `.tar.gz` gerado no passo 1 e nunca removido, seja uma rotina de backup do provedor que guarda cópias fora do home. O arquivo do passo 1 é fácil de esquecer porque ele é criado dentro da conta e, se você copiou para outro diretório seu antes de terminar, a cópia sobrevive. Verifique seus próprios diretórios antes de abrir chamado dizendo que o disco não foi liberado.

## Checklist de encerramento e o aviso que você manda ao cliente

Padronize isso em um documento e rode igual em toda saída, do cliente pequeno ao grande. A sequência importa mais que a velocidade.

- Confirmar por escrito, com data, que o cliente está saindo e que o encerramento inclui remoção de dados.
- Gerar o backup completo da conta.
- Baixar o backup para fora do servidor e conferir com `tar -tzf` que o arquivo abre e contém `homedir`, `mysql`, `homedir/mail`, `va`, `vf` e `cron`.
- Enviar ao cliente o link ou o arquivo, com data limite de disponibilidade.
- Consultar a delegação real com `dig +trace NS` ou perguntando ao servidor do TLD, e decidir: terminar com remoção de zona, terminar preservando a zona, ou só suspender até a troca.
- Listar o que vai junto, principalmente cron, filtros de e-mail e usuários de banco, e avisar o cliente item por item.
- Executar a remoção em Terminate Accounts, preservando a zona quando a delegação ainda apontar para você.
- Conferir disco usado da revenda antes e depois, e procurar backups residuais se a conta não voltar como espaço livre.
- Agendar a remoção da zona preservada para depois que a delegação mudar.
- Apagar o backup final no fim do prazo de retenção combinado.

Sobre retenção: o cPanel não decide isso, quem decide é o seu contrato. Uma janela de 30 dias contados a partir do aviso de encerramento costuma ser suficiente para o cliente organizar a migração, e é curta o bastante para você não virar depositário eterno de dado de terceiro. Escreva o prazo no contrato e cumpra, inclusive a parte de apagar.

A frase pronta para o aviso, que evita a discussão de "ninguém me falou":

> **** Seus dados ficam disponíveis para download até DD/MM. A partir dessa data a conta é removida do servidor e não há como recuperá-la. Até lá, o DNS do seu domínio precisa estar apontado para o novo provedor, caso contrário o site sai do ar no momento da remoção e as mensagens enviadas para o seu e-mail ficam presas em fila até serem devolvidas aos remetentes.

Duas frases e uma data. É o que separa um encerramento limpo de um domingo explicando por que o e-mail de um cliente que já não é seu parou de funcionar.

