blog
Servidores

Disco cheio no cPanel sem nenhuma conta estourar a cota

Roteiro de triagem por ponto de montagem para VPS e revenda cPanel, com o que pode ser apagado, o que só pode ser rotacionado e o que exige janela de parada.

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

Resposta curta: o alerta vem da partição, não da cota. Comece por `df -h` e `df -i`, desça com `du -xh --max-depth=1` e olhe quatro suspeitos: backup local, fila do Exim, log sem rotação e /tmp em loop device.

Neste artigo
  1. WHM alerta disco cheio e todas as contas estão dentro da cota
  2. Qual partição estourou e se o problema é espaço ou inode
  3. Os quatro lugares que enchem disco sem pertencer a nenhuma conta
  4. O que dá para resolver na hora e o que precisa de janela
  5. Script de triagem só de leitura para rodar em produção
  6. Como explicar ao cliente que o site dele não é o culpado

WHM alerta disco cheio e todas as contas estão dentro da cota

O alerta chega como Disk usage warning ou um serviço que simplesmente para de gravar. Você abre o Show Current Disk Usage do WHM, confere conta por conta e nenhuma passou da cota. A conclusão óbvia (e errada) é que o alerta é falso positivo.

Não é. A tela de uso de disco do WHM, segundo a documentação oficial do cPanel, lista o uso dos diretórios do sistema e das contas, mas o que dispara o alerta é a partição, não a soma das cotas. Uma partição pode encher com arquivos que não pertencem a nenhuma conta: backup local, fila de e-mail, log, arquivo temporário. É aí que você deve procurar.

E a cota de uma conta cPanel cobre o home do usuário e, conforme a configuração do servidor, também bancos de dados e caixas de correio. Nada disso inclui diretórios de sistema como /backup, /var/spool ou /tmp. Um backup de 40 GB gravado em /backup (exemplo) não entra na cota de ninguém e ocupa a mesma partição se não houver disco separado.

Qual partição estourou e se o problema é espaço ou inode

A ordem importa: primeiro descobrir qual ponto de montagem estourou, depois descer dentro dele sem atravessar montagem.

# 1. qual partição está cheia
df -h

# 2. inodes também enchem, e o sintoma é idêntico
df -i

Se df -h mostra 100% em / e df -i mostra uso de inode normal, é volume de dados. Se o espaço está folgado e os inodes em 100%, é quantidade de arquivos (sessão de PHP, fila de e-mail, cache). O tratamento é diferente.

Com a partição identificada, desça um nível de cada vez:

du -xh --max-depth=1 / | sort -h | tail -20

O -x é o detalhe que economiza tempo: ele impede que o du atravesse para outro sistema de arquivos. Sem ele, você soma /home montado em outro disco dentro do total de / e persegue o diretório errado. Repita o comando descendo no maior resultado até achar o arquivo ou diretório responsável.

Triagem de disco cheio, só leituradf -hQual ponto de montagem estouroudf -iEspaço ou inode esgotadodu -xh --max-depth=1Sem atravessar montagemDesça no maior resultadoRepita até achar o culpadoClassifique o localBackup, fila, log ou tmp
Ordem de diagnóstico: identificar a partição antes de caçar diretório.

Os quatro lugares que enchem disco sem pertencer a nenhuma conta

Local O que costuma ser Pode apagar? Risco
/backup, /home/backup Backups locais retidos além do necessário Sim, os antigos Baixo, se houver cópia remota
/var/spool/exim Fila de e-mail travada ou spam enfileirado Só com critério, via exim Médio, apaga mensagem legítima
/var/log, /usr/local/cpanel/logs Log que não rotaciona Não: rotacionar Médio, apagar não libera espaço enquanto o processo mantém o arquivo aberto
/tmp, /var/tmp Sessão PHP, upload órfão, arquivo de cache Sim, com cuidado Baixo a médio

Backup local retido além do necessário

O sistema de backup do cPanel grava em um diretório de destino e com uma retenção que você mesmo definiu: confira os dois em Backup Configuration no WHM antes de supor qualquer coisa. Se a retenção está alta ou alguém acrescentou uma conta grande, o crescimento é linear e invisível para a cota.

ls -lh /backup/*/ | head
du -xh --max-depth=2 /backup | sort -h | tail

O que fazer: apagar gerações antigas é seguro se você confirmou que existe destino remoto funcionando. Antes de apagar qualquer coisa, abra o Backup Configuration no WHM e reduza a retenção, senão o espaço volta a sumir na próxima madrugada. Se o servidor não tem disco separado para backup, a correção estrutural é montar um volume dedicado ou mandar o backup direto para destino remoto.

Fila do Exim travada ou disparando spam

Fila grande quase sempre significa uma de duas coisas: um script de contato comprometido disparando spam, ou um destino que está recusando e as mensagens ficam em retry.

# quantas mensagens na fila
exim -bpc

# resumo por domínio de destino, para ver quem está em retry
exim -bp | exiqsumm | tail -20

# contagem por remetente do envelope, para achar quem está disparando
exim -bpr | grep '<' | awk '{print $4}' | sort | uniq -c | sort -rn | head

O que fazer: não apague /var/spool/exim com rm -rf. Isso destrói a estrutura de diretórios que o Exim espera e você ganha um segundo incidente. Remova mensagens pela própria ferramenta (exim -Mrm <id>) depois de identificar o padrão, e trate a causa: senha de e-mail vazada, formulário sem validação, plugin desatualizado. Se a fila voltar a crescer em horas, a causa não foi tratada.

Log que não rotaciona e espaço preso em arquivo já apagado

/var/log e /usr/local/cpanel/logs guardam logs de serviço. Um arquivo aberto por um processo continua ocupando espaço mesmo depois de apagado, até o processo soltar o descritor. É por isso que apagar log com rm às vezes não devolve nada no df.

# arquivos grandes dentro de /var/log
find /var/log -type f -size +500M -exec ls -lh {} \;

# espaço preso em arquivo já apagado mas ainda aberto
lsof +L1 | head

O que fazer: esvaziar sem quebrar o handle, com : > /var/log/arquivo.log, e corrigir a rotação. Logrotate com copytruncate ou um postrotate que recarrega o serviço resolve de forma permanente. Apagar o arquivo e torcer é assim que o mesmo problema volta em poucas semanas.

/tmp em loop device cheio com a raiz folgada

Em parte das instalações cPanel, /tmp é um arquivo de imagem montado como loop device, com tamanho fixo e opções restritivas. Confirme com mount antes de concluir. Consequência prática: /tmp pode estar 100% cheio enquanto / está folgado, e o sintoma é MySQL reclamando de tabela temporária ou sessão PHP falhando, sem nenhuma relação aparente com disco.

df -h /tmp
mount | grep ' /tmp '

Se aparecer um loop na saída do mount, você está nesse cenário. Limpar arquivos antigos resolve o momento; aumentar a imagem é procedimento com parada de serviço e deve ser agendado, não feito às 23h de uma sexta.

O que dá para resolver na hora e o que precisa de janela

Regra de ouro para agência: o item da primeira lista você faz na hora. Os da terceira entram em janela com aviso ao cliente, mesmo que o servidor esteja em 99%. Encher o disco de novo é ruim; corromper um banco por desmontar algo ocupado é pior.

Três níveis de intervenção por riscoNa horaBackup antigo, truncar log, retençãoCom reloadLogrotate, espaço preso em arquivoCom janelaImagem de /tmp, mover /backup
Separe a ação pelo risco, não pela urgência do alerta.

Script de triagem só de leitura para rodar em produção

Rode nessa ordem em qualquer servidor cPanel que você administra. Salve como script interno e execute antes do alerta, não depois.

#!/bin/bash
# triagem-disco.sh - leitura, sem alteração
echo "== partições ==";      df -h
echo "== inodes ==";          df -i
echo "== raiz, 1 nível ==";   du -xh --max-depth=1 / 2>/dev/null | sort -h | tail -15
echo "== /var/log ==";        du -xh --max-depth=1 /var/log | sort -h | tail -10
echo "== cpanel logs ==";     du -xh --max-depth=1 /usr/local/cpanel/logs | sort -h | tail -10
echo "== fila exim ==";       exim -bpc
echo "== /tmp ==";            df -h /tmp; mount | grep ' /tmp '

Nenhum comando acima escreve ou apaga qualquer coisa. Pode rodar em produção com tranquilidade e guardar a saída no ticket, o que ajuda muito quando o problema volta.

Preventivo, uma vez por servidor:

  1. Retenção de backup conferida no WHM e compatível com o disco disponível.
  2. Destino remoto de backup testado com restauração real, não só com "job concluído".
  3. Logrotate cobrindo os logs grandes, com rotação por tamanho e não só por data.
  4. Alerta de disco configurado em 80%, não em 95%: você precisa de tempo para agir.
  5. Monitoramento de inode junto com o de espaço.

Como explicar ao cliente que o site dele não é o culpado

O cliente não quer saber de ponto de montagem. Ele quer saber se o site dele é o culpado e se vai cair. Use algo assim:

Troque "área de backup" por "fila de e-mail do servidor" ou "arquivos de registro do sistema" conforme o caso. Duas coisas precisam estar na frase: não é culpa do site dele e o que você fez para não repetir. A segunda parte é o que evita a pergunta de volta.

Se o diagnóstico apontar de verdade para /home e uma conta específica, aí a conversa é outra: crescimento de mídia, backup de plugin dentro do public_html, ou a conta realmente precisa de mais espaço. Mas antes de concluir que é a conta, descarte os pontos de montagem acima, e vale olhar o resto antes de oferecer upgrade a quem não precisa.

Referências

  1. Documentação oficial (cpanel) — Show Current Disk Usage (WHM). Consultado em 2026-10-04.
Leia também