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

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

João Rizzon · 2026-09-21 · Painéis

---

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](https://docs.cpanel.net/knowledge-base/backup/how-to-exclude-files-from-backups/) 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.php` e `.htaccess` na raiz do site
- `wp-content/uploads` inteira, incluindo os anos antigos
- `wp-content/themes` do tema ativo e do tema pai, se for filho
- `wp-content/plugins` dos plugins ativos
- `wp-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 usuario@servidor.exemplo:~/cpbackup-exclude.conf
ssh usuario@servidor.exemplo '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:

> **** O backup completo da sua hospedagem passou de X GB para Y GB. A diferença é arquivo temporário que o próprio site recria sozinho: cache de páginas, cópias antigas de backup que estavam guardadas dentro do próprio site e arquivos de instalação de ferramentas. Nada do que o site precisa para voltar ao ar ficou de fora: banco de dados, imagens e arquivos enviados, tema, plugins, e-mails e configurações continuam no backup. Ele agora gera mais rápido, ocupa menos espaço e reduz o risco de falhar por falta de disco.

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](https://docs.cpanel.net/knowledge-base/backup/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.

