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

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

João Rizzon · 2026-10-05 · Servidores

---

## 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](https://docs.cpanel.net/whm/system-health/show-current-disk-usage/), 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.

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

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

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

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

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

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

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

- **Sem parar nada:** apagar backup antigo, truncar log com `:>`, remover sessão PHP expirada, ajustar retenção no WHM.
- **Com reload do serviço:** corrigir logrotate (reload do serviço que escreve o log), liberar espaço preso em arquivo aberto.
- **Com janela agendada:** redimensionar a imagem de `/tmp`, mover `/backup` para outro volume, mudar o datadir do MySQL.

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.

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

```bash
#!/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:

- Retenção de backup conferida no WHM e compatível com o disco disponível.
- Destino remoto de backup testado com restauração real, não só com "job concluído".
- Logrotate cobrindo os logs grandes, com rotação por tamanho e não só por data.
- Alerta de disco configurado em 80%, não em 95%: você precisa de tempo para agir.
- 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:

> **** "O espaço do seu site está normal e dentro do limite do plano. O que encheu foi a área de backup do servidor, que é uma área nossa, de infraestrutura. Já ajustamos a retenção e o espaço foi liberado. Nenhum arquivo do seu site foi tocado."

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.

