Backup do site grande demais: o exclude do cPanel
O filtro de entrada do backup do cPanel: como medir com du, escrever o exclude, validar que o site ainda restaura e replicar o mesmo arquivo em todas as contas de cliente.

Resposta curta: 1 arquivo de texto na home da conta, o cpbackup-exclude.conf, com um caminho relativo por linha, tira cache, node_modules, pasta de plugin de backup e .tar.gz antigos do backup da conta, inclusive o agendado pelo servidor. Ele filtra o que entra no pacote e não apaga nada do disco.
Neste artigo
- O que o exclude filtra e o que ele não alcança
- Meça a home com du antes de decidir o que sai
- Onde criar o cpbackup-exclude.conf e como escrever cada linha
- Compare o tamanho e confira o conteúdo com tar -tzf
- O que precisa estar dentro do pacote, sempre
- Como repetir esse processo em dezenas de contas
- Os cinco erros que só aparecem no dia da restauração
- O texto pronto para explicar a mudança ao cliente
O backup completo de uma conta cPanel carrega a home inteira. Tudo que está lá dentro entra no .tar.gz, inclusive o cache do WP Rocket, o node_modules que ficou no tema depois do último build, a pasta do UpdraftPlus e aquele backup-2023-11-04.tar.gz que alguém gerou, baixou pela metade e nunca apagou. O resultado é o clássico backup dentro do backup: o arquivo novo engole o arquivo velho, cresce, estoura a cota de disco ou o tempo de geração, e falha.
O cPanel tem um filtro de entrada para isso. Ele se chama cpbackup-exclude.conf e é um arquivo de texto na home da conta, com um caminho por linha. A documentação oficial do cPanel descreve o formato e o local. O que segue é o processo para usar isso em escala: medir, escrever, gerar, comparar, provar que o site ainda sobe.
O que o exclude filtra e o que ele não alcança
Antes de listar pasta, alinhe a expectativa. Esse arquivo é um filtro de empacotamento, não um faxineiro.
| O exclude faz | O exclude não faz |
|---|---|
| Impede que o caminho listado entre no backup da conta gerado pelo sistema de backup do cPanel | Não apaga nada do disco: a pasta continua lá, ocupando o mesmo espaço |
| Vale para o backup completo da conta, tanto o que a própria conta gera no gerenciador quanto o que o servidor gera na rotina agendada daquela conta | Não alcança o que está fora da home: banco de dados, cron do sistema, zona de DNS |
| Aceita caminhos relativos à home, um por linha | A documentação trata do backup da conta; ela não confirma o comportamento em downloads parciais (só banco, só home, só filtros de e-mail), então trate isso como não verificado |
| Passa a valer no próximo backup gerado | Não reescreve backups já existentes |
| Convive com a lista global que o administrador do servidor mantém no servidor | Não desfaz uma exclusão global: se o admin já tirou algo, a conta não traz de volta |
A parte do backup agendado é a que mais importa para quem cuida de carteira de clientes, porque é ali que o .tar.gz cresce sozinho todo dia. Como você não controla o horário dessa rotina, a validação muda de forma: em vez de gerar um backup na hora, espere o próximo pacote agendado aparecer e confira o conteúdo dele com tar -tzf, como está mais abaixo.
Se o seu objetivo é liberar disco agora, exclude não resolve. Apagar resolve. O exclude resolve o problema seguinte, que é o arquivo de backup crescer de novo no mês que vem.
Meça a home com du antes de decidir o que sai
Não escreva o exclude no escuro. Dez minutos de du evitam excluir a pasta errada.
Onde está o peso da home, pasta por pasta
Conectado por SSH na conta:
cd ~
du -sh
du -h --max-depth=2 . | sort -h | tail -20
O primeiro comando dá o tamanho total da home, que é a base de comparação. O segundo lista os vinte maiores caminhos até dois níveis, ordenados. Em site WordPress, desça mais um nível onde costuma doer:
du -sh public_html/wp-content/* | sort -h
Ache os .tar.gz e as node_modules esquecidas
find ~ -maxdepth 3 -name 'backup-*.tar.gz' -exec ls -lh {} \;
find ~ -maxdepth 3 -type d \( -name node_modules -o -name cache -o -name updraft \) -exec du -sh {} \;
O primeiro pega o .tar.gz de backup que ficou na home ou dentro do public_html. O segundo mostra o tamanho de cada pasta suspeita sem você ter que adivinhar o caminho exato do tema.
Simule o tamanho final com du --exclude, sem gerar backup
du aceita --exclude, então dá para ver o número final sem gerar backup nenhum:
du -sh --exclude='cache' --exclude='node_modules' --exclude='updraft' ~
Compare com o du -sh puro do começo. A diferença entre os dois é uma estimativa do que você vai deixar de empacotar, em bytes de disco. O padrão de --exclude casa pelo nome, então confira se ele não está pegando uma pasta legítima com o mesmo nome em outro lugar da árvore. Se tiver dúvida, use o caminho completo relativo no lugar do nome curto e rode de novo.
Um aviso que evita conversa errada depois: du mede ocupação em disco e o .tar.gz é comprimido. Os dois números não se comparam entre si. Use o du para dimensionar o ganho esperado e decidir o que entra na lista; para falar com o cliente, compare tamanho de pacote com tamanho de pacote.
Onde criar o cpbackup-exclude.conf e como escrever cada linha
O arquivo fica na raiz da home da conta, não dentro de public_html:
/home/usuario/cpbackup-exclude.conf
Uma linha por caminho, relativo à home. Sem barra inicial. public_html/wp-content/cache está certo; /home/usuario/public_html/wp-content/cache é o erro mais comum e faz a linha simplesmente não casar com nada.
Um ponto de partida para WordPress (exemplo ilustrativo, ajuste ao que o seu du mostrou):
public_html/wp-content/cache
public_html/wp-content/updraft
public_html/wp-content/ai1wm-backups
public_html/wp-content/themes/meutema/node_modules
tmp
backup-*.tar.gz
Criar pelo terminal:
nano ~/cpbackup-exclude.conf
cat ~/cpbackup-exclude.conf
Sem SSH, o Gerenciador de Arquivos do cPanel serve: crie o arquivo na pasta inicial da conta, com esse nome exato, e edite pelo editor de texto do painel. O nome não começa com ponto, então ele aparece na listagem normal.
Só caminhos no arquivo. A documentação descreve um caminho por linha e não documenta linha de comentário, então não coloque # explicando nada ali dentro: uma linha que o parser não entende pode virar um padrão sem correspondência, ou pior, um padrão com correspondência inesperada. A explicação de cada linha mora no seu repositório, como está na seção de padronização.
A documentação do cPanel indica que o arquivo aceita curingas. Curinga é conveniente e é onde nasce acidente: *cache* pode alcançar um plugin chamado wp-super-cache inteiro, com arquivos de configuração dentro. Quando a economia vier de uma pasta só, escreva o caminho literal dela. Curinga fica para o caso em que você não sabe o nome do diretório de antemão, como o node_modules de um tema que muda de nome por cliente.
A lista passa a valer no próximo backup. Backup já gerado continua do tamanho que era.
Compare o tamanho e confira o conteúdo com tar -tzf
Gere um backup completo novo pelo cPanel e compare o tamanho do .tar.gz com o último que existia. Se o número não mudou, o arquivo provavelmente não foi lido: quase sempre é caminho absoluto, nome do arquivo digitado errado ou o arquivo salvo dentro de public_html. Se a conta depende da rotina agendada do servidor, repita a comparação no primeiro pacote agendado que sair depois da mudança, porque é ele que você vai restaurar em uma emergência.
Antes de comemorar, abra a lista do que ficou dentro. Sem extrair nada:
tar -tzf backup-9.8.2026_00-00-00_usuario.tar.gz | grep -c ''
tar -tzf backup-9.8.2026_00-00-00_usuario.tar.gz | grep 'wp-content/uploads' | head
tar -tzf backup-9.8.2026_00-00-00_usuario.tar.gz | grep 'wp-config.php'
tar -tzf backup-9.8.2026_00-00-00_usuario.tar.gz | grep 'cache/' | head
(o nome do arquivo acima é exemplo; use o que o cPanel gerou). O primeiro conta as entradas. Os dois seguintes confirmam que o essencial está lá. O último tem que voltar vazio, ou voltar só com algo que você decidiu manter. tar -tzf em arquivo de vários GB demora e lê tudo, então rode uma vez, com calma, e não em horário de pico.
O que precisa estar dentro do pacote, sempre
Exclude mal escrito não avisa. Ele falha em silêncio e você só descobre no dia da restauração. Passe por esta lista toda vez que criar um exclude novo:
wp-config.phpe.htaccessna raiz do sitewp-content/uploadsinteira, incluindo os anos antigoswp-content/themesdo tema ativo e do tema pai, se for filhowp-content/pluginsdos plugins ativoswp-content/mu-plugins, que quase ninguém lembra que existe- dump SQL do banco: vem do backup completo do cPanel, não da home, então nenhum exclude o remove; confirme mesmo assim que ele está no pacote
- caixas de e-mail em
mail/, se o cliente usa e-mail no mesmo plano - filtros, encaminhamentos e autorresposta, que o backup completo carrega junto
- tarefas cron: ficam fora da home, o exclude não as toca, mas anote-as à parte porque nem toda restauração as recoloca
- arquivos soltos fora do WordPress: certificado, script de integração, pasta de um subdomínio antigo que ainda responde
O teste que vale de verdade é restaurar em um domínio de teste ou em uma instalação local e ver o site abrir. Com um cliente relevante, faça isso uma vez. Com os outros, o checklist acima cobre.
Como repetir esse processo em dezenas de contas
Para quem cuida de dez, trinta, cem sites, o ganho não é o arquivo: é o processo.
Mantenha um template versionado, com a explicação fora do arquivo
Um cpbackup-exclude.conf base no seu repositório de ferramentas, contendo só linhas de caminho. Ao lado dele, um README.md explicando por que cada linha existe, qual plugin gera aquela pasta e em que situação a linha sai. Duas ou três variantes do template: WordPress simples, WordPress com build no servidor, loja com muitos uploads. O que sobe para o servidor é o arquivo de caminhos; o README fica no repositório.
Adapte o template a cada conta, nunca copie cego
O caminho do tema muda. O plugin de backup muda. Rode o du da conta antes de subir o template, e corrija as linhas que não existem naquela instalação. Linha que aponta para caminho inexistente não quebra nada, mas esconde a linha que faltou.
Suba o arquivo e confirme que ele chegou inteiro
Com SSH na conta do cliente:
scp cpbackup-exclude.conf [email protected]:~/cpbackup-exclude.conf
ssh [email protected] 'cat ~/cpbackup-exclude.conf'
O cat não é firula: ele mostra se o arquivo chegou inteiro e se alguma linha de comentário escapou do template. Sem SSH, Gerenciador de Arquivos, mesmo resultado, só mais lento.
Com WHM e root, separe o que é global do que é da conta
A documentação do cPanel descreve também a exclusão no nível do servidor, mantida pelo administrador. Padrão que vale para toda conta (tmp, pasta de cache de um plugin que você usa em todos os sites) cabe lá. Padrão específico de um cliente fica na home dele. Revenda sem root não tem acesso a essa camada: nesse caso é conta por conta, e o template versionado é o que salva tempo.
Registre tamanho antes, tamanho depois e o que saiu
Data, tamanho do pacote antes, tamanho do pacote depois, o que foi excluído. É o que você vai consultar daqui a oito meses quando o backup voltar a crescer e você precisar saber se é pasta nova ou se alguém removeu o arquivo.
Os cinco erros que só aparecem no dia da restauração
Caminho absoluto. /home/usuario/public_html/wp-content/cache não casa. Relativo à home, sempre.
Excluir uploads inteira. Acontece com curinga largo ou com a ideia de que "imagem o cliente tem no computador dele". Não tem. A biblioteca de mídia é conteúdo, não cache, e sem ela a restauração devolve um site de quadrados cinza.
Confiar no nome "cache". Vários plugins guardam em pasta de cache coisas que o site não refaz sozinho de imediato: CSS crítico gerado uma vez, versões WebP das imagens, arquivos combinados com hash no nome. Se for regenerável em minutos ao limpar o cache, exclua. Se a regeneração depende de uma passada manual em cada página, ou de crédito em serviço externo, pense duas vezes. Teste: limpe a pasta em homologação e veja se o site volta ao normal sozinho.
Excluir node_modules de projeto que compila no servidor. Se o deploy roda npm ci no servidor, a pasta é reconstruível e pode sair. Se o build é feito só na sua máquina e o servidor apenas serve o resultado, a pasta nem deveria estar lá. Mas se existe um script no servidor que depende dela para rodar, você acabou de tirar do backup uma dependência que ninguém documentou. Confira o cron e o pipeline antes.
Achar que o exclude limpa disco. O aviso de cota vai continuar. Exclude reduz o .tar.gz, não a home. A limpeza é um passo separado: apagar backups antigos, esvaziar tmp, remover a pasta do plugin de backup depois de mover os arquivos para fora do servidor.
O texto pronto para explicar a mudança ao cliente
Cliente não quer saber de cpbackup-exclude.conf. Ele quer saber se o backup dele ainda serve. Adapte:
X e Y são o mesmo indicador: o tamanho do arquivo .tar.gz do backup antes da mudança e o tamanho do primeiro pacote gerado depois. Não misture com o número do du, que mede ocupação em disco e não passou por compressão. Número específico encerra a conversa; adjetivo abre outra.
---
Fonte: cPanel, How to Exclude Files From Backups, consultado em 16/09/2026. Os tamanhos e nomes de arquivo citados no texto são exemplos ilustrativos, não medição.
Referências
- Documentação oficial (cpanel) — How to Exclude Files From Backups. Consultado em 2026-09-16.