# Como achar em qual backup o arquivo apagado ainda está

Um processo de triagem que percorre todas as datas de backup, identifica a versão íntegra do arquivo e mantém o site no ar intacto até a decisão estar tomada.

> antes de restaurar qualquer coisa, liste o índice de cada cópia com `tar -tzvf arquivo.tar.gz | grep nome-do-arquivo`, que mostra presença, tamanho em bytes e data de modificação sem extrair nada. A cópia certa é a mais recente em que o arquivo aparece com tamanho coerente.

João Rizzon · 2026-10-13 · Painéis

---

Arquivo apagado em site de cliente tem uma ordem de operações que quase todo mundo inverte: primeiro se restaura, depois se descobre que a cópia escolhida já estava com o arquivo corrompido, ou que ela era anterior a uma alteração legítima que ninguém queria perder. A etapa que falta é a triagem: abrir o índice de cada cópia, sem extrair nada, e descobrir em qual data o arquivo existe e com qual tamanho.

O que segue é um processo de triagem que funciona em três cenários: acesso SSH, acesso só ao cPanel pelo navegador e acesso ao WHM (revenda ou servidor próprio). Os caminhos e nomes de arquivo usados aqui são exemplos ilustrativos, não medição.

## Nunca restaure antes de inventariar: o que você perde

Restaurar um backup completo de conta sobrescreve o que está no ar agora. Se o site recebeu pedidos, comentários, posts ou uploads desde a data da cópia, esse delta desaparece. Restaurar só o arquivo que falta é quase sempre o movimento certo, e para isso você precisa saber exatamente de qual cópia tirar.

Três perguntas que a triagem responde antes de qualquer restauração:

- Em quais datas o arquivo existe dentro da cópia.
- Qual o tamanho dele em cada data (um `.php` que caiu para 0 bytes ou que ganhou 40 KB de repente conta uma história).
- Se o que você quer é um arquivo só, um diretório ou o banco, porque cada um vive em um lugar diferente do `.tar.gz`.

## Onde o arquivo mora dentro do .tar.gz de conta

Um backup de conta do cPanel não é um espelho do `public_html` na raiz do arquivo. Ele tem uma estrutura própria, e conhecê-la economiza tempo em qualquer busca.

| Caminho dentro do arquivo (exemplo) | O que está ali |
|---|---||
| `usuario/homedir/public_html/` | Arquivos do site |
| `usuario/homedir/` | Resto da home, inclusive pastas fora do docroot |
| `usuario/mysql/` | Dumps `.sql` dos bancos |
| `usuario/meta/` | Metadados da conta |
| `usuario/cp/` | Configuração da conta no cPanel |

Ou seja: o arquivo que você procura em `public_html/wp-content/uploads/2024/relatorio.pdf` aparece no índice como `usuario/homedir/public_html/wp-content/uploads/2024/relatorio.pdf`. Busque pelo nome, não pelo caminho completo, para não errar por causa do prefixo.

## Como listar o conteúdo do backup sem extrair nada

`tar -t` lista. `tar -x` extrai. Enquanto você estiver em triagem, só existe `-t`.

```bash
# lista o índice completo de uma cópia (pode ser longo)
tar -tzvf /backup/2026-10-05/accounts/usuario.tar.gz

# filtra por nome do arquivo procurado
tar -tzvf /backup/2026-10-05/accounts/usuario.tar.gz | grep -i 'relatorio.pdf'
```

Com `-v`, cada linha traz permissões, dono, tamanho em bytes e data de modificação. É esse tamanho que diferencia "o arquivo existe" de "o arquivo existe e ainda está bom".

### Varrendo várias datas de uma vez para montar a linha do tempo

O ganho real aparece quando você percorre todas as cópias disponíveis em um laço e monta a linha do tempo:

```bash
for f in /backup/*/accounts/usuario.tar.gz; do
  echo "== $f"
  tar -tzvf "$f" | grep -i 'relatorio.pdf'
done
```

A saída vira um inventário por data. Onde não imprimir nada, o arquivo não está naquela cópia. Onde imprimir com tamanho plausível, você tem candidato.

### Quando o arquivo está lá mas o conteúdo já veio quebrado

Arquivo que existe em todas as cópias mas parou de funcionar pede outra pergunta: em qual data o conteúdo mudou. Para texto, `zgrep` procura dentro do arquivo comprimido sem descompactar na pasta:

```bash
zgrep -a 'eval(base64_decode' /backup/2026-10-05/accounts/usuario.tar.gz
```

Se a string de injeção aparece na cópia de uma data e não na anterior, você delimitou a janela de tempo, mas ainda não sabe em qual arquivo ela está: `zgrep` sobre o `.tar.gz` varre o stream inteiro e só confirma que a string existe em algum lugar daquela cópia, sem dizer o caminho nem a linha útil. Para localizar o arquivo, cruze com o índice: liste os candidatos com `tar -tzvf copia.tar.gz | grep '\.php$'`, e para cada suspeito leia o conteúdo direto do arquivo sem gravar nada em disco:

```bash
tar -xOzf /backup/2026-10-05/accounts/usuario.tar.gz \
  usuario/homedir/public_html/wp-config.php | grep -n 'eval(base64_decode'
```

O `-O` manda o conteúdo para a saída padrão, então o `grep -n` devolve a linha. Com o caminho e a linha em mãos, você sabe o que restaurar. Para extrair um único arquivo depois de decidido, use o caminho exato que o `tar -t` mostrou, extraindo para uma pasta temporária fora do docroot, nunca por cima do site.

## Quais cópias existem para a conta, pelo WHM

Quem administra o servidor (revenda com WHM ou servidor dedicado) tem um atalho documentado pela cPanel: o script `backups_list_user_files`, que lista os arquivos de backup existentes para um usuário. A documentação oficial está em [The backups_list_user_files Script](https://docs.cpanel.net/whm/scripts/the-backups_list_user_files-script/).

O uso é direto: você informa o usuário e recebe a relação das cópias disponíveis para aquela conta. Isso responde à primeira metade da triagem (quais datas existem) sem você precisar adivinhar a estrutura de diretórios do destino de backup. A segunda metade (o que tem dentro) continua sendo `tar -t`.

Vale a ressalva: esse script é de WHM, roda com privilégio administrativo e não está disponível em conta de hospedagem compartilhada comum. Se você é a agência e não o administrador do servidor, pule para a via navegador.

## A mesma triagem sem SSH, só pelo navegador

Sem SSH, o caminho é mais manual, mas chega ao mesmo lugar.

### Veja quais cópias existem

No cPanel, a área de **Backup** mostra os backups completos de conta disponíveis para download e os backups parciais. O **Backup Restoration** (quando habilitado pelo provedor) lista as cópias por data e permite restaurar arquivos, bancos ou e-mail de forma seletiva. Anote as datas antes de clicar em qualquer botão de restaurar.

### Baixe a cópia candidata e abra no seu computador

Baixe o `.tar.gz` da data suspeita e abra localmente. No Linux e no macOS, `tar -tzvf` funciona igual na sua máquina. No Windows, 7-Zip abre o `.tar.gz` em duas camadas (primeiro o `.gz`, depois o `.tar`) e você navega pela árvore `usuario/homedir/public_html/` sem extrair tudo.

### Suba só o arquivo conferido

Confirmado o arquivo certo, use o **Gerenciador de Arquivos** para enviar apenas ele, de preferência renomeando o atual em vez de sobrescrever: `relatorio.pdf` vira `relatorio.pdf.old-20261009` e o recuperado entra no lugar. Se der errado, o desfazer é um rename.

## Checklist de triagem reutilizável

Salve isso como template de chamado e preencha para qualquer cliente:

- Nome exato do arquivo ou diretório perdido, e caminho relativo a `public_html`.
- Data e hora aproximadas em que ele ainda funcionava, segundo o cliente.
- Lista das cópias disponíveis, com data de cada uma.
- Para cada cópia, resultado de `tar -tzvf ... | grep nome`: presente ou ausente, tamanho em bytes, data de modificação.
- Escolha da cópia: a mais recente em que o arquivo está presente e com tamanho coerente.
- Extração para pasta temporária fora do docroot, conferência do conteúdo (abrir o arquivo, não só olhar o nome).
- Backup do estado atual antes de escrever qualquer coisa: renomeie o arquivo existente, não apague.
- Colocação do arquivo recuperado, teste da URL afetada e do fluxo que dependia dele.
- Registro no chamado: data da cópia usada, caminho de origem, caminho de destino, quem autorizou.

Os passos 4 e 5 são o que diferencia triagem de tentativa e erro. Os passos 7 e 9 são o que te protege quando o cliente pergunta, três semanas depois, por que determinado conteúdo mudou.

## Frase pronta para o cliente

Use enquanto a triagem está em curso, para comprar tempo sem parecer inércia:

> **** "Localizamos as cópias de segurança disponíveis e estamos verificando em qual delas o arquivo ainda existe íntegro. Nada do site no ar será sobrescrito nessa etapa: a conferência é feita sobre o backup, sem tocar na versão atual. Assim que identificarmos a data correta, restauramos apenas o arquivo afetado e avisamos antes."

Dois efeitos: o cliente entende que existe um passo técnico entre o pedido e a solução, e fica registrado por escrito que a restauração seletiva foi a opção escolhida, não uma restauração completa que apagaria pedidos e cadastros recentes.

## Os três erros que mais custam caro

- **Restaurar a conta inteira para recuperar um arquivo.** Sobrescreve banco, e-mail e uploads posteriores. Só faça com autorização explícita e depois de exportar o estado atual.
- **Confiar na presença do nome no índice.** Arquivo com 0 byte aparece no `tar -t` igual a um arquivo íntegro. Olhe o tamanho e abra o conteúdo antes de publicar.
- **Descobrir a retenção só na hora da emergência.** Quantas cópias o plano guarda, e com qual frequência, determina até onde você consegue voltar. Confirme isso no cadastro do cliente antes de prometer prazo de recuperação.

E um lembrete contra o próprio interesse: em boa parte dos casos de arquivo sumido em WordPress, o conteúdo não foi apagado do disco, foi tirado do ar por um plugin, por mudança de permissão ou por uma atualização que renomeou a pasta. Antes de baixar 4 GB de backup, confira se o arquivo está no servidor pelo Gerenciador de Arquivos. Dois minutos ali economizam uma tarde.

