blog
Revenda

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.

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

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
  1. Quando restaurar só o arquivo e não a conta
  2. O que a tela restaura e o que continua fora do alcance
  3. A restauração de arquivo exige metadados de backup ativos
  4. Como restaurar um arquivo pelo WHM, em quatro passos
  5. Como confirmar que só o item voltou e o resto segue atual
  6. O que fazer quando a data não aparece ou o site continua quebrado
  7. 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.

Qual caminho de restauração usarProblema em arquivo ou pasta do home?Confira o caminho exato antesSim: File and Directory RestorationRestaura só o item escolhidoNão: o dado está no MySQLUse restauração de bancoConta inteira removida do servidorUse Backup Restoration
Escolha o caminho antes de abrir qualquer tela de restauração.

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.

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.

Passos para restaurar um item no WHMEscolher a contaUsuário do cPanel, não o domínioConferir o caminhoAntes de abrir o WHMEscolher a dataÚltima cópia boa anterior ao problemaRestaurar e confirmarSubstitui o item no mesmo caminho
Só o item selecionado é substituído. 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 é:

  1. Abra o site em janela anônima para não pegar cache do seu login.
  2. Se o item era um arquivo público (imagem, CSS), abra a URL direta dele e confira que carrega.
  3. Em loja WooCommerce, entre em *Pedidos* e confirme que os pedidos posteriores à data do backup continuam lá.
  4. 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:

  1. Metadados de backup habilitados em *Backup Configuration*, conferidos na implantação.
  2. Retenção suficiente para cobrir o tempo que o cliente leva para perceber um problema.
  3. Caminho exato do item confirmado antes de abrir o WHM.
  4. Versão atual copiada ou renomeada antes de restaurar.
  5. Data da cópia escolhida pela última versão boa, não pela mais recente.
  6. Verificação: item restaurado ok, pedidos e e-mails recentes intactos, cache limpo.
  7. 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

  1. Documentação oficial (cpanel) — File and Directory Restoration for WHM. Consultado em 2026-10-13.
Leia também