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.

Resposta curta: 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.
Neste artigo
- Nunca restaure antes de inventariar: o que você perde
- Onde o arquivo mora dentro do .tar.gz de conta
- Como listar o conteúdo do backup sem extrair nada
- Quais cópias existem para a conta, pelo WHM
- A mesma triagem sem SSH, só pelo navegador
- Checklist de triagem reutilizável
- Frase pronta para o cliente
- Os três erros que mais custam caro
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
.phpque 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.
# 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:
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:
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:
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.
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:
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 -tigual 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.
Referências
- Documentação oficial (cpanel) — The backups_list_user_files Script. Consultado em 2026-10-09.