Restaurar um arquivo de cliente no WHM sem voltar a conta
O caminho documentado pela cPanel para voltar um arquivo ou uma pasta escolhendo a data da cópia, sem logar na conta do cliente e sem sobrescrever pedidos e e-mails novos.

Resposta curta: pelo WHM, em Backup > File and Directory Restoration: escolha o usuário, navegue até o arquivo ou pasta no home, selecione a data da cópia e restaure. Só aquele item é sobrescrito; banco, pedidos e e-mails ficam intactos. Exige metadados de backup ativos.
Neste artigo
- Quando restaurar só o arquivo e não a conta
- O que a tela restaura e o que continua fora do alcance
- A restauração de arquivo exige metadados de backup ativos
- Como restaurar um arquivo pelo WHM, em quatro passos
- Como confirmar que só o item voltou e o resto segue atual
- O que fazer quando a data não aparece ou o site continua quebrado
- Checklist para repetir em todos os servidores e frase para o cliente
Quando restaurar só o arquivo e não a conta
O caso típico: o cliente apagou o wp-config.php por FTP, um plugin corrompeu o .htaccess, alguém sobrescreveu a pasta wp-content/themes/tema-filho com uma versão antiga. O resto do site está funcionando. Em uma loja, os pedidos de hoje estão no banco e os e-mails novos estão na caixa.
Se você usar a restauração completa da conta, tudo volta para o estado do backup: banco, e-mail, arquivos. Os pedidos feitos depois da cópia somem, e as mensagens recebidas depois dela também podem sumir. Para um problema de um arquivo, isso é trocar um incidente pequeno por um grande.
O WHM tem uma interface própria para o caso pequeno: File and Directory Restoration (em *WHM > Backup > File and Directory Restoration*). Ela restaura um arquivo ou uma pasta do diretório home de uma conta, escolhendo de qual backup vem a cópia, sem você precisar logar no cPanel do cliente. O procedimento abaixo segue a documentação oficial da cPanel, consultada em 13/10/2026. A Napoleon não mediu nem cronometrou esse processo: o que está aqui é documentação mais organização de rotina.
O que a tela restaura e o que continua fora do alcance
Antes de abrir a tela, vale saber o alcance dela, porque o erro mais caro é achar que ela resolve algo que não resolve.
| Situação | File and Directory Restoration resolve? | Caminho correto |
|---|---|---|
| Arquivo apagado ou alterado dentro do home da conta | Sim | Esta interface |
| Pasta inteira do tema, plugin ou uploads | Sim | Esta interface, selecionando o diretório |
| Tabela ou banco de dados MySQL | Não | Restauração de banco, não de arquivo |
| Conta inteira removida do servidor | Não | Restauração de conta (Backup Restoration) |
| Arquivo fora do home do usuário | Não | Fora do escopo da ferramenta |
A documentação deixa claro que o escopo é o diretório home do usuário. Banco de dados não é arquivo do ponto de vista dessa tela, então um post apagado no WordPress não volta por aqui: ele está no MySQL.
Outro ponto documentado: restaurar sobrescreve o item atual no mesmo caminho. Não existe pré-visualização lado a lado. Se a versão atual tiver algo que você quer guardar, copie antes.
A restauração de arquivo exige metadados de backup ativos
A interface só enxerga cópias feitas pelo sistema de backup do WHM e depende dos metadados de backup estarem habilitados em *WHM > Backup > Backup Configuration*. É com esse índice que a tela monta a lista de arquivos e as datas disponíveis para cada um.
Consequência prática: se o servidor do cliente passou a gerar metadados só a partir de certa data, cópias anteriores podem não aparecer na lista, mesmo existindo em disco. Confira essa configuração no dia em que montar o servidor, não no dia em que precisar restaurar.
Se você é revendedor sem acesso root, essa tela provavelmente não está no seu WHM. Nesse caso o pedido vai para o suporte da hospedagem, e a informação útil para mandar é: usuário da conta, caminho exato do item e data aproximada da versão boa.
Como restaurar um arquivo pelo WHM, em quatro passos
Abra a interface e escolha a conta
Em *WHM > Backup > File and Directory Restoration*, selecione o usuário da conta (o nome de usuário do cPanel, não o domínio). A tela carrega a árvore do diretório home dele.
Navegue até o item e confira o caminho
Abra as pastas até chegar ao arquivo ou diretório. Para WordPress, o caminho costuma ser public_html/ ou a pasta do domínio adicional. Confirme o caminho antes, no próprio cliente ou no gerenciador de arquivos, para não restaurar o wp-config.php do site errado em uma conta com vários domínios.
Se o arquivo foi apagado, ele ainda aparece na árvore porque a lista vem dos metadados do backup, não só do disco atual.
Escolha a data da cópia anterior ao problema
Ao selecionar o item, a interface lista os backups que contêm aquela versão, com data e tipo. Escolha a cópia mais recente anterior ao problema. Se não souber quando o problema começou, pergunte ao cliente o que ele mudou e quando, ou olhe a data de modificação do arquivo quebrado (comando na próxima seção).
Restaure e confirme a substituição
Clique em restaurar e confirme na caixa de diálogo. O item volta para o mesmo caminho, substituindo o que estiver lá. Nada mais da conta é tocado: banco, e-mails e demais arquivos ficam como estão.
Como confirmar que só o item voltou e o resto segue atual
A verificação tem dois lados: o item restaurado está certo, e o resto continua atual.
No terminal (se você tem SSH na conta ou no servidor), valide pelo conteúdo, não pela data. Se você renomeou ou copiou a versão quebrada antes de restaurar, compare as duas:
diff /home/usuario/public_html/.htaccess.quebrado /home/usuario/public_html/.htaccess
md5sum /home/usuario/public_html/.htaccess.quebrado /home/usuario/public_html/.htaccess
grep -n "DB_NAME" /home/usuario/public_html/wp-config.php
O diff deve mostrar diferença entre a versão quebrada e a restaurada, e os dois hashes do md5sum devem ser distintos. Se o arquivo tinha sido apagado e não há cópia para comparar, o grep de uma linha que você sabe que existia (o nome do banco no wp-config.php, uma regra conhecida no .htaccess) confirma que o conteúdo voltou.
A data de modificação (ls -l --time-style=full-iso) serve no máximo como pista. O esperado é que o item restaurado traga a data da versão do backup, mas a documentação da cPanel não descreve esse comportamento, então não trate isso como prova. E uma data antiga em um arquivo não diz nada sobre o resto da conta: para confirmar que banco, pedidos e e-mails seguem atuais, use o roteiro do navegador abaixo.
No navegador, o roteiro é:
- Abra o site em janela anônima para não pegar cache do seu login.
- Se o item era um arquivo público (imagem, CSS), abra a URL direta dele e confira que carrega.
- Em loja WooCommerce, entre em *Pedidos* e confirme que os pedidos posteriores à data do backup continuam lá.
- No webmail, confira que as mensagens recentes seguem na caixa.
Para checar só o status HTTP de um arquivo restaurado, sem cache do navegador:
curl -I https://exemplo.com.br/wp-content/uploads/2026/10/banner.jpg
Um 200 indica que o arquivo está sendo servido. Um 404 indica caminho errado ou item ainda ausente. Se o site usa cache de página ou CDN, limpe antes de concluir que a restauração falhou.
O que fazer quando a data não aparece ou o site continua quebrado
A data que eu queria não aparece. O backup daquele dia não existe, foi rotacionado pela retenção configurada ou foi gerado sem metadados. Verifique a retenção em *Backup Configuration*. Se a cópia estiver em destino remoto e não for listada, trate com o suporte do servidor.
Restaurei a pasta e sobraram arquivos novos. Não presuma que restaurar um diretório apaga o que foi criado depois da cópia. Se precisa da pasta exatamente como no backup, renomeie a atual antes (por exemplo tema-filho.quebrado), restaure e compare. Isso também te dá rollback imediato.
Restaurei e o site continua quebrado. Ou o problema não estava naquele arquivo, ou está no banco. Volte o arquivo renomeado, olhe o error_log da pasta e o log de erros do PHP antes de restaurar outro item no escuro.
Permissão ou dono errado depois da restauração. Confira com ls -l se o arquivo pertence ao usuário da conta. Arquivo de outro dono costuma gerar erro 500 ou falha de escrita.
Checklist para repetir em todos os servidores e frase para o cliente
Para usar em todos os servidores que você administra:
- Metadados de backup habilitados em *Backup Configuration*, conferidos na implantação.
- Retenção suficiente para cobrir o tempo que o cliente leva para perceber um problema.
- Caminho exato do item confirmado antes de abrir o WHM.
- Versão atual copiada ou renomeada antes de restaurar.
- Data da cópia escolhida pela última versão boa, não pela mais recente.
- Verificação: item restaurado ok, pedidos e e-mails recentes intactos, cache limpo.
- Registro no seu controle: conta, caminho, data da cópia usada, horário da restauração.
Frase pronta para o cliente, que costuma evitar o pedido de restaurar tudo:
E quando ele pedir para voltar o site inteiro para ontem: explique que isso apaga os pedidos e mensagens de hoje, e que restaurar o item específico resolve o mesmo problema sem esse custo.
Referências
- Documentação oficial (cpanel) — File and Directory Restoration for WHM. Consultado em 2026-10-13.