blog
Painéis

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.

JR · · 10 min de leitura · 1 tabela · 9 blocos de código

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
  1. O que o exclude filtra e o que ele não alcança
  2. Meça a home com du antes de decidir o que sai
  3. Onde criar o cpbackup-exclude.conf e como escrever cada linha
  4. Compare o tamanho e confira o conteúdo com tar -tzf
  5. O que precisa estar dentro do pacote, sempre
  6. Como repetir esse processo em dezenas de contas
  7. Os cinco erros que só aparecem no dia da restauração
  8. 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.

Processo de exclusão de arquivos do backupMedirdu na home, achar o pesoEscrevercpbackup-exclude.conf na raizGerarbackup completo novoComparartamanho do .tar.gz antes e depoisProvartar -tzf e restauração de teste
Ordem do processo. Nenhuma etapa vale sozinha: sem a comparação e a listagem do pacote, o exclude falha em silêncio.

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:

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.

Decidir se uma pasta pode sair do backupA pasta está fora da home?Exclude não alcança, ignoreÉ conteúdo do cliente?Uploads e configs sempre entramSome sozinho ao limpar cache?Se não volta sozinho, mantenhaAlgum script no servidor usa?Confira cron e deploy antesCaminho relativo à home?Sem barra inicial, sem comentárioPode excluirRegistre a linha no template
Checklist de decisão por pasta, antes de escrever a linha no arquivo.

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

  1. Documentação oficial (cpanel) — How to Exclude Files From Backups. Consultado em 2026-09-16.
Leia também