blog
Painéis

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.

JR · · 7 min de leitura · 1 tabela · 4 blocos de código

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
  1. Nunca restaure antes de inventariar: o que você perde
  2. Onde o arquivo mora dentro do .tar.gz de conta
  3. Como listar o conteúdo do backup sem extrair nada
  4. Quais cópias existem para a conta, pelo WHM
  5. A mesma triagem sem SSH, só pelo navegador
  6. Checklist de triagem reutilizável
  7. Frase pronta para o cliente
  8. 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:

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.

Triagem de backup: do índice ao arquivo publicadoInventariarListar cópias disponíveis por dataLocalizartar -t com grep pelo nomeConferirTamanho em bytes e dataExtrairPasta temporária fora do docrootPublicarRenomear o atual, subir o recuperado
Caminhos e nomes são ilustrativos, não medição.

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:

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

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

  1. Documentação oficial (cpanel) — The backups_list_user_files Script. Consultado em 2026-10-09.
Leia também