blog
Revenda

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.

JR · · 11 min de leitura · 3 tabelas · 4 blocos de código

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

Neste artigo
  1. O que o Terminate Accounts apaga e o que ele não desfaz
  2. O backup final precisa sair do servidor antes do primeiro clique
  3. Como descobrir se o domínio ainda delega para os seus nameservers
  4. O que some junto com a conta e o que continua existindo depois
  5. Executar a remoção com a decisão de DNS já tomada
  6. Como provar que o disco voltou para a revenda
  7. Checklist de encerramento e o aviso que você manda ao cliente

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

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

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

Decisão de DNS antes de terminar a contaConsultar o TLDdig +trace NS, nunca resolver recursivoNS do novo provedorTerminar a conta normalmenteNS ainda da sua revendaTerminar preservando a zona DNSTroca vai demorar semanasSó suspender, não terminarDomínio expiradoTerminar e remover a zona
A decisão depende do que o servidor do TLD responde, não do que o cliente informou.

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:

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

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:

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

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.

  1. Confirmar por escrito, com data, que o cliente está saindo e que o encerramento inclui remoção de dados.
  2. Gerar o backup completo da conta.
  3. 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.
  4. Enviar ao cliente o link ou o arquivo, com data limite de disponibilidade.
  5. 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.
  6. Listar o que vai junto, principalmente cron, filtros de e-mail e usuários de banco, e avisar o cliente item por item.
  7. Executar a remoção em Terminate Accounts, preservando a zona quando a delegação ainda apontar para você.
  8. Conferir disco usado da revenda antes e depois, e procurar backups residuais se a conta não voltar como espaço livre.
  9. Agendar a remoção da zona preservada para depois que a delegação mudar.
  10. 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":

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.

Sequência de encerramento de contaConfirmar saídaPor escrito, com dataBackup fora do servidorConferir com tar -tzfChecar a delegaçãoPerguntar ao servidor do TLDTerminar a contaPreservar zona se necessárioConferir disco e zonaAgendar remoção da zona órfã
A ordem importa: cada etapa depende de algo que a seguinte apaga.

Referências

  1. Documentação oficial (cpanel) — Terminate Accounts. Consultado em 2026-09-24.
Leia também