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

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

João Rizzon · 2026-11-12 · Revenda

---

## 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](https://docs.cpanel.net/whm/backup/file-and-directory-restoration-for-whm/), 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:

```bash
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:

```bash
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:

> **** Recuperei só o arquivo que quebrou, a partir da cópia do dia X. Pedidos, cadastros e e-mails que chegaram depois disso não foram tocados, então nada do que aconteceu hoje se perdeu.

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.

