Como restaurar um backup no cPanel

A forma de restaurar um backup no cPanel depende do tipo de cópia que tem. As cópias do diretório principal (Home Directory), de bancos de dados MySQL, de encaminhamentos (Email Forwarders) e de filtros de email (Email Filters) podem ser restauradas por você, cada uma separadamente, a partir da ferramenta Backup ou Backup Wizard do cPanel. Uma cópia completa da conta (Full Account Backup, cpmove) não pode ser restaurada a partir da interface do cPanel: exige acesso de administrador do servidor no WHM, por isso na Revenda de Hospedagem da Domain Name API a restauração é feita pela equipe de suporte.

Redigido por: Equipe de Suporte de Hospedagem da Domain Name API · Revisto por: Equipe de Operações Técnicas / Hospedagem · Última atualização: 5 de outubro de 2026

Primeiro, identifique o tipo de cópia

Carregar o arquivo errado na tela errada é a causa mais comum de problemas na restauração. Use a árvore de decisão abaixo para saber que tipo de arquivo tem e siga apenas a seção correspondente.

Cópia completa (arquivo com as pastas homedir e mysql) → pedido de suporte · Home Directory → cPanel › Backup · Cópia MySQL ou dump .sql → cPanel › Backup ou phpMyAdmin · Forwarders / Filters → cPanel › Backup · Arquivo comum como site.zip → File Manager.

Figura 1 – Que cópia tem? O método de restauro certo consoante o conteúdo do ficheiro.
Figura 1 – Qual cópia você tem? O método de restauração certo conforme o conteúdo do arquivo.

Este guia explica como restaurar em uma conta cPanel uma cópia que já tem. Se está transferindo um site de outro fornecedor de hospedagem, siga o guia Como migrar um site para o cPanel no Alojamento de Revenda, que também trata do DNS, dos testes e do encerramento da conta antiga.

Os exemplos usam example.com como domínio, olduser como usuário cPanel antigo e newuser como o novo. São valores de exemplo; utilize o seu próprio domínio e usuário.

Início rápido: um restauro seguro em 5 passos

Seja qual for o tipo de cópia, uma restauração segura segue os mesmos cinco passos. A restauração pode substituir arquivos ou um banco de dados existentes, por isso o primeiro passo é proteger o que existe agora.

  1. Identifique o tipo de cópia. Abra o arquivo no seu computador e veja as pastas que contém (Figura 1).
  2. Faça uma cópia da conta atual. Transfira em cPanel › Files › Backup uma cópia dos arquivos e dos bancos de dados de hoje.
  3. Verifique o espaço em disco e a conta de destino. Confirme que está na conta cPanel certa e que há espaço livre suficiente para extrair a cópia.
  4. Restaure apenas a parte de que precisa. Home Directory para arquivos, MySQL para um banco de dados, Forwarders para encaminhamentos e Filters para filtros.
  5. Verifique o resultado. Percorra a lista de verificação: site, área de administração, conexão com o banco de dados, email, versão de PHP, tarefas cron e SSL.

Que tipo de cópia tem?

O cPanel produz dois tipos principais de cópia: a Full Account Backup, que contém toda a conta, e as Partial Backups (cópias parciais), que contêm uma parte. Há quatro cópias parciais: Home Directory, banco de dados MySQL, Email Forwarders e Email Filters. Além disso, é frequente encontrar arquivos e dumps SQL criados por plugins ou desenvolvedores. Cada um é restaurado de forma diferente.

Tipo de cópia O que contém? O que não contém? Quem restaura e onde? Quando é a melhor opção?
A) Full Account Backup / cpmove Arquivos, email, bancos de dados, encaminhamentos, filtros, tarefas cron, zona DNS, domínios definidos e configurações da conta Depende da forma como foi criada; os serviços externos não estão incluídos Não é possível no cPanel. Exige administrador do servidor no WHM → pedido de suporte Para reconstruir toda a conta com o mesmo usuário
B) Home Directory Arquivos do diretório principal: public_html, pastas de domínios adicionais, arquivos ocultos, email dos seus domínios Bases de dados, reencaminhamentos, filtros ao nível da conta, tarefas cron, domínios definidos, DNS Você · cPanel › Files › Backup ou Backup Wizard Quando os arquivos do site ou o email foram danificados ou apagados
C) MySQL Database Backup O conteúdo de um banco de dados (tabelas e dados) Arquivos, email; o usuário do banco de dados e os privilégios Você · cPanel › Files › Backup ou Backup Wizard Para devolver apenas o banco de dados a um ponto anterior
D) Email Forwarders Os reencaminhamentos configurados para o domínio Caixas de correio e mensagens Você · cPanel › Files › Backup ou Backup Wizard Se os encaminhamentos foram apagados ou precisam ser recriados em outra conta
E) Email Filters Os filtros de email ao nível da conta Os emails; os filtros de usuário de cada caixa de e-mail Você · cPanel › Files › Backup ou Backup Wizard Se as regras de filtragem se perderam
F) Arquivo web manual (.zip, .tar.gz) Uma cópia comprimida de uma pasta Nada específico do cPanel; normalmente também não tem banco de dados Você · cPanel › File Manager › Upload e Extract Quando um plugin ou desenvolvedor arquivou apenas os arquivos
G) Dump SQL manual (.sql, .sql.gz) A exportação de um banco de dados Usuário, privilégios, arquivos Você · MySQL Database Wizard + phpMyAdmin › Import Se o banco de dados foi exportado com outra ferramenta ou o usuário mudou

Os nomes de arquivo dão uma pista, mas variam conforme a versão do cPanel e a ferramenta que criou a cópia. Uma cópia completa e uma do diretório principal podem ambas começar por backup- e terminar em .tar.gz. A forma fiável de as distinguir é ver o conteúdo: a cópia completa contém pastas como homedir e mysql; a do diretório principal mostra diretamente pastas como public_html, mail e etc.

Qual é a diferença entre uma cópia completa e uma parcial?

Uma cópia completa da conta e uma cópia parcial não se restauram da mesma forma. A Full Account Backup serve para reconstruir uma conta cPanel com todas as configurações e só pode ser restaurada no WHM. Cada cópia parcial leva uma parte da conta e é restaurada separadamente pelo próprio usuário do cPanel.

Figura 2 – Full Account Backup e Partial Backup: o que contém cada uma e quem a pode restaurar.
Figura 2 – Full Account Backup e Partial Backup: o que contém cada uma e quem a pode restaurar.
Característica Full Account Backup Partial Backup
Âmbito Toda a conta Uma parte da conta
Onde é restaurada WHM (administrador do servidor) cPanel › Files › Backup ou Backup Wizard
O revendedor ou o cliente pode fazê-lo? Não; é preciso abrir um pedido de suporte Sim
Tarefas cron, domínios definidos, DNS São restaurados Não são restaurados; configuram-se à parte
Usuário e prefixo do banco de dados Restaurado com o usuário da cópia É aplicado o usuário da conta de destino

Se tem uma Full Account Backup

Não tente carregar uma cópia completa nas opções Restore do cPanel. Segundo a própria documentação do cPanel, uma cópia completa não pode ser restaurada automaticamente no cPanel; essa função só existe no WHM.

A tela do WHM que restaura cópias completas (Transfer or Restore a cPanel Account nas versões atuais, Restore a Full Backup/cpmove File nas anteriores) exige acesso de administrador do servidor e não aparece no WHM de revenda padrão. Se não o vê, a sua conta não tem nenhum problema.

O que fazer: siga os passos do pedido de suporte na seção Como restauro uma Full Account Backup (cpmove)? mais abaixo.

Antes de restaurar: verificação de segurança

Antes de restaurar o que quer que seja, faça uma cópia da conta atual. A restauração escreve na conta os arquivos e os bancos de dados da cópia e pode substituir arquivos com o mesmo nome e o mesmo banco de dados. Se começar sem proteger o que existe agora, não terá para onde voltar se a restauração der errado.

Uma restauração nem sempre pode ser revertida

Se quiser manter os dados atuais, faça primeiro uma cópia nova. Demora alguns minutos e é a única forma confiável de corrigir um arquivo, uma data ou uma conta errados.

  • Fez uma cópia da conta atual? Em cPanel › Files › Backup, transfira pelo menos o Home Directory e os bancos de dados em questão.
  • A cópia pertence ao domínio e à conta certos? Confirme pelos arquivos em public_html ou pelo nome do banco de dados dentro do arquivo.
  • A data da cópia está certa? Veja a data no nome do arquivo ou as datas de modificação dos arquivos. É para esse ponto que vai voltar.
  • Há espaço livre suficiente na cota de disco? O arquivo é carregado primeiro e depois extraído, por isso o arquivo e o seu conteúdo podem ocupar espaço ao mesmo tempo. Se a cota não for suficiente, aumente o pacote no WHM como revendedor.
  • É um problema substituir arquivos existentes? Se houver arquivos alterados ou adicionados depois da data da cópia, copie-os antes para outro local.
  • Fez uma cópia do banco de dados atual? A restauração de um banco de dados substitui as tabelas.
  • O site gera dados continuamente? Se for uma loja online, um site de membros, de reservas ou um CRM, leia o aviso de perda de dados abaixo.
  • Está na conta cPanel certa? Se entrou a partir de WHM › List Accounts, confirme o usuário e o domínio principal indicados no cPanel.

Risco de perda de dados em sites em produção que geram dados continuamente

Ao restaurar uma cópia antiga do banco de dados, este volta ao momento em que a cópia foi feita. Os pedidos, registros, comentários, formulários, reservas e outros dados criados depois dessa data podem ser perdidos.

Em um site em produção que gera dados continuamente, avalie o impacto antes de restaurar uma cópia antiga sobre o banco de dados atual. Um caminho mais seguro é restaurar a cópia em um banco de dados novo e vazio e recuperar apenas as tabelas ou registros de que precisa, comparando as duas.

Se a restauração for inevitável, coloque o site em modo de manutenção durante pouco tempo, transfira uma última cópia do banco de dados atual e só depois restaure.

Como restauro uma cópia do diretório principal (Home Directory)?

A cópia do diretório principal é carregada em cPanel › Files › Backup, na seção Restore a Home Directory Backup. Recupera os arquivos do seu diretório principal: public_html, as pastas de domínios adicionais, os arquivos ocultos e o email dos seus domínios. Não recupera os bancos de dados, os encaminhamentos, os filtros no nível da conta nem as tarefas cron.

O que é uma cópia do diretório principal?

A cópia Home Directory é uma cópia compactada dos arquivos que pertencem a você no diretório principal da conta cPanel (/home/usuario). Segundo a documentação do cPanel, inclui os arquivos de public_html e o email dos domínios da sua conta. Restaurar esta cópia não é o mesmo que restaurar toda a conta cPanel.

Passo a passo

  1. Faça login no cPanel. Como revendedor, pode passar para o cPanel de um cliente a partir de WHM › List Accounts com o ícone cP junto à conta.
  2. Abra Files › Backup. Também o pode fazer em Files › Backup Wizard › Restore › Home Directory.
  3. Em Partial Backups, procure Restore a Home Directory Backup.
  4. Clique em Choose File e selecione a cópia do diretório principal no seu computador (normalmente um arquivo .tar.gz).
  5. Clique em Upload. O tempo depende do tamanho do arquivo e da sua conexão; não feche a aba do navegador.
  6. No fim, verá uma mensagem confirmando a restauração. Depois abra public_html no File Manager e verifique os arquivos.
Restauro Home Directory É recuperado?
Arquivos de public_html e das pastas de domínios adicionais Sim
Arquivos ocultos (.htaccess, .env, .user.ini) Sim
Email dos seus domínios (pasta mail) Sim; depois da restauração, confirme que as contas aparecem em Email Accounts
Bases de dados Não → seção MySQL
Email Forwarders e Email Filters ao nível da conta Não → seção de email
Tarefas cron Não → recrie-as em cPanel › Advanced › Cron Jobs
Domínios adicionais e subdomínios definidos Não; as pastas voltam, mas a definição do domínio não → cPanel › Domains
Versão de PHP selecionada Não; só voltam as definições que estejam em .htaccess ou .user.ini

O que acontece com os arquivos existentes?

A restauração escreve os arquivos da cópia no diretório principal e substitui os que têm o mesmo nome. Os arquivos que não estão na cópia, por terem sido adicionados depois, devem ser mantidos. Por exemplo, se restaurar o WordPress com uma cópia antiga, a pasta de um plugin instalado depois da data da cópia pode continuar lá.

Verificação do passo

O que deve ver: No File Manager, os arquivos do site em public_html, um index.php ou index.html e os arquivos ocultos (com Settings › Show Hidden Files ativo).

O erro mais comum aqui: Assumir que a cópia do diretório principal também trouxe o banco de dados. Se o site mostrar "Error establishing a database connection", restaure o banco de dados separadamente.

Passo seguinte: Se o site usa banco de dados, passe à seção MySQL.

Como restauro uma cópia de uma base de dados MySQL?

Se tem uma cópia MySQL transferida do cPanel e a conta de destino tem o mesmo usuário, use cPanel › Files › Backup › Restore a MySQL Database Backup. Se tem um dump .sql criado com outra ferramenta ou o usuário mudou, crie o banco de dados com o MySQL Database Wizard e importe-a com phpMyAdmin › Import.

O que é o prefixo do banco de dados e por que é importante?

O cPanel acrescenta o usuário da conta ao início do nome de cada banco de dados e de cada usuário do banco de dados. O banco de dados wp da conta olduser chama-se na verdade olduser_wp. Restaurada na conta newuser, deve chamar-se newuser_wp. Quando o prefixo muda, mudam também o nome do banco de dados e o usuário no arquivo de configuração do site.

Cenário A: cópia MySQL do cPanel, mesmo usuário

  1. Primeiro transfira uma cópia do banco de dados atual em cPanel › Files › Backup › Download a MySQL Database Backup.
  2. No mesma tela, em Restore a MySQL Database Backup, clique em Choose File e selecione a cópia (normalmente nome_bd.sql.gz).
  3. Clique em Upload e aguarde a mensagem de resultado.
  4. Em cPanel › Databases › MySQL Databases, confirme que o banco de dados aparece na lista e tem um usuário atribuído.

Assim recupera o conteúdo do banco de dados, mas nem sempre o usuário e a senha. Se o site não se conectar, confirme em MySQL Databases › Privileged Users que o usuário está atribuído ao banco de dados com ALL PRIVILEGES. Se o prefixo da cópia for diferente do da conta de destino, use o Cenário B: o resultado é mais previsível.

Cenário B: apenas um dump .sql ou .sql.gz, ou um usuário diferente

  1. Abra cPanel › Databases › MySQL Database Wizard e crie o banco de dados. O cPanel acrescenta o prefixo automaticamente, por exemplo newuser_wp.
  2. No segundo passo do assistente, crie um usuário do banco de dados com uma senha forte, por exemplo newuser_wpuser.
  3. No terceiro passo, atribua ALL PRIVILEGES e guarde com Make Changes.
  4. Abra cPanel › Databases › phpMyAdmin, selecione o novo banco de dados à esquerda e passe à aba Import.
  5. Escolha o dump e clique em Import. A tela indica o tamanho máximo de arquivo; se o seu dump for maior, compacte-o como .sql.gz.
  6. Atualize o nome do banco de dados, o usuário e a senha no arquivo de configuração do site. No cPanel, o host do banco de dados é normalmente localhost.
Aplicação Arquivo de configuração Campos a verificar
WordPress wp-config.php DB_NAME, DB_USER, DB_PASSWORD, DB_HOST
Laravel e semelhantes .env DB_DATABASE, DB_USERNAME, DB_PASSWORD, DB_HOST
OpenCart config.php e admin/config.php DB_DATABASE, DB_USERNAME, DB_PASSWORD, caminhos de arquivos
Software à medida O arquivo de configuração usado pelo seu desenvolvedor Dados de ligação e caminhos absolutos como /home/olduser/
// wp-config.php – exemplo: valores antigos e novos
define( 'DB_NAME', 'newuser_wp' );      // antes: olduser_wp
define( 'DB_USER', 'newuser_wpuser' );  // antes: olduser_wpuser
define( 'DB_PASSWORD', 'nova-palavra-passe' );
define( 'DB_HOST', 'localhost' );

Verificação do passo

O que deve ver: No phpMyAdmin, o mesmo número de tabelas que na cópia, e os novos dados do banco de dados no arquivo de configuração.

O erro mais comum aqui: Importar o banco de dados e esquecer de atribuir privilégios ao usuário, ou deixar o prefixo antigo no arquivo de configuração.

Passo seguinte: Se o site usa email, passe à seção de email; se não, à lista de verificação.

Como restauro uma cópia do email?

A restauração do email depende do que quer recuperar. As mensagens das caixas de e-mail voltam com a cópia do diretório principal. Os encaminhamentos voltam com a cópia de Email Forwarders e as regras de filtragem com a de Email Filters, cada uma separadamente.

Conceito O que significa Que cópia o recupera?
Email Account (conta de email) Uma caixa de e-mail como info@example.com e a respectiva senha Cópia Home Directory ou Full Account Backup
Email Messages (mensagens) Os emails da caixa de entrada, enviados e outras pastas Cópia Home Directory ou Full Account Backup
Email Forwarders (reencaminhamentos) Uma regra que envia o correio de um endereço para outro Cópia Email Forwarders ou Full Account Backup
Email Filters (filtros) Uma regra ao nível da conta que apaga, move ou reencaminha o correio recebido Cópia Email Filters ou Full Account Backup
  • Restaurar a cópia de encaminhamentos não recupera as mensagens das caixas de e-mail. Recupera apenas as regras de reencaminhamento.
  • Restaurar a cópia de filtros não recupera emails. Recupera apenas as regras de filtragem.
  • A cópia de Email Filters contém apenas filtros ao nível da conta. Os filtros de usuário de uma caixa de e-mail específica não estão incluídos.

Restaurar as cópias de Forwarders e Filters

  1. Abra cPanel › Files › Backup.
  2. Para uma cópia de reencaminhamentos, procure Restore Email Forwarders; para uma de filtros, Restore Email Filters.
  3. Clique em Choose File, selecione o arquivo e clique em Upload.
  4. Confirme que as regras aparecem em cPanel › Email › Forwarders e Email Filters.

Se só quer recuperar uma caixa de e-mail ou uma mensagem

Restaurar uma cópia do diretório principal por causa de alguns emails também substitui os arquivos do site. Não edite à mão a pasta mail para recuperar uma única caixa de e-mail; abra um pedido de suporte com a cópia, o domínio e o endereço da caixa.

Verificação do passo

O que deve ver: As contas em Email Accounts, os reencaminhamentos em Forwarders e um email de teste que sai e volta.

O erro mais comum aqui: Restaurar a cópia de reencaminhamentos e esperar que as mensagens também voltem.

Passo seguinte: Passe à lista de verificação.

Como restauro uma Full Account Backup (cpmove)?

Resposta curta: nem como revendedor nem como cliente pode restaurar uma Full Account Backup a partir do cPanel. A restauração de uma conta completa exige acesso de administrador do servidor no WHM. Na Revenda de Hospedagem da Domain Name API, você prepara o arquivo de cópia e abre um pedido de suporte; a restauração é feita pela equipe de suporte.

O que é uma Full Account Backup?

A Full Account Backup (cópia completa da conta) é um único arquivo que reúne os arquivos, o email, os bancos de dados, os encaminhamentos e filtros, as tarefas cron, a zona DNS, os domínios definidos e as configurações de uma conta cPanel. Serve para reconstruir a conta inteira em outro servidor. No cPanel é criada com Download a Full Account Backup; no WHM é criada no mesmo formato, conhecido como cpmove.

Pergunta Resposta
Um usuário do cPanel pode restaurá-la? Não. Segundo a documentação do cPanel, uma cópia completa não pode ser restaurada automaticamente no cPanel; a função só existe no WHM.
Um usuário WHM de revenda pode restaurá-la? Não com os privilégios de revenda padrão. A tela de restauração pertence ao administrador do servidor.
Que acesso é necessário? Acesso de administrador do servidor (root).
O que deve fazer um revendedor da Domain Name API? Preparar a cópia e abrir um pedido de suporte (ver abaixo).

Como preparar o pedido de suporte

  1. Salve o arquivo de cópia no seu computador e anote o tamanho. A equipe de suporte indica na resposta ao pedido como enviar o arquivo.
  2. Indique o domínio a restaurar e o usuário cPanel de destino.
  3. Se já existir uma conta com o mesmo usuário, diga-o claramente e indique se deve ser substituída. Transfira antes uma cópia dessa conta.
  4. Confirme que a cota de disco do pacote de destino é suficiente para a cópia extraída.
  5. Depois da restauração, percorra a lista de verificação abaixo.

Precisa apenas de parte da cópia completa?

Se não precisa da cópia inteira, por exemplo apenas dos arquivos do site ou de um banco de dados, abra o arquivo no seu computador. A documentação do cPanel também sugere este caminho. Compacte os arquivos do site da pasta homedir e carregue-os com o File Manager, e importe o arquivo .sql da pasta mysql com o phpMyAdmin seguindo o Cenário B. O email, as tarefas cron e o DNS não podem ser recuperados com segurança desta forma; para isso abra um pedido.

Verificação do passo

O que deve ver: Um pedido que indica com clareza o domínio, o usuário, o tamanho do arquivo e se deve haver substituição.

O erro mais comum aqui: Carregar uma cópia completa na restauração Home Directory do cPanel. A estrutura de pastas do arquivo pode ser extraída para o diretório principal e o site não funcionará.

Passo seguinte: Quando a restauração terminar, percorra a lista de verificação.

Como restauro um arquivo web manual (.zip)?

Um arquivo como site.zip não é uma cópia do cPanel; é carregado e extraído com o File Manager. Abra a pasta de destino em cPanel › Files › File Manager (para o domínio principal é normalmente public_html), use Upload para carregar o arquivo, clique nele com o botão direito, escolha Extract e exclua-o no fim. Se o arquivo contiver uma subpasta, os arquivos ficam em algo como public_html/site/; mova-os um nível acima.

Cópias grandes e quota de disco

Se uma cópia grande não carregar, a causa é normalmente a cota de disco, o limite de upload do navegador ou uma queda de conexão. Comece pelo valor Disk Usage na página inicial do cPanel: precisam caber o arquivo e o conteúdo extraído. Como revendedor, pode aumentar temporariamente a cota em WHM › Packages › Edit a Package ou Modify an Account.

  • Dump de banco de dados grande: comprima-o como .sql.gz. Se continuar acima do limite do phpMyAdmin Import, abra um pedido de suporte.
  • Cópia do diretório principal muito grande: o upload pelo navegador pode parar no meio. Primeiro considere restaurar apenas o que precisa, por exemplo os arquivos do site. Se continuar falhando, abra um pedido e indique o tamanho do arquivo.
  • Quanto tempo demora uma restauração: depende do tamanho do arquivo e da carga do servidor. Cópias pequenas terminam em poucos minutos; cópias de vários GB demoram mais. Não feche a aba até terminar, mesmo que a tela pareça não responder.

Já restaurei a cópia. O que devo verificar agora?

Uma mensagem de "restauração concluída" não significa que o site funciona. Faça as verificações abaixo por ordem. Se faltar algo que o seu tipo de cópia não inclui, não é um erro: precisa da sua própria restauração.

Figura 3 – Que dados cada tipo de cópia deve recuperar.
Figura 3 – Que dados cada tipo de cópia deve recuperar.
Figura 4 – Verificação em cinco passos depois do restauro.
Figura 4 – Verificação em cinco passos depois da restauração.
Verificação Como testar Não é recuperado por
☐ A página inicial e as interiores abrem Abra várias páginas em uma janela privada MySQL, Forwarders, Filters
☐ Imagens, CSS e JavaScript carregam O aspecto da página não está quebrado MySQL, Forwarders, Filters
☐ Consegue entrar na área de administração Por exemplo /wp-admin Home Directory sozinha (precisa do banco de dados)
☐ A conexão com o banco de dados funciona Sem erro de ligação Home Directory, Forwarders, Filters
☐ Formulários e upload de arquivos funcionam Envie um formulário de teste, carregue uma imagem –
☐ As contas de email estão corretas cPanel › Email Accounts MySQL, Forwarders, Filters
☐ O email recebido e enviado funciona Teste de envio e recepção com um endereço externo –
☐ Forwarders e Filters estão corretos Email › Forwarders, Email Filters Home Directory, MySQL
☐ As tarefas cron existem (se necessário) Advanced › Cron Jobs; o usuário nos caminhos está certo? Todas as cópias parciais
☐ A versão de PHP está correta Software › MultiPHP Manager ou Select PHP Version Todas as cópias parciais
☐ SSL/HTTPS funciona Security › SSL/TLS Status; use Run AutoSSL se necessário –
☐ Os registros de erros estão limpos Metrics › Errors –

Resolução de problemas

A maioria dos problemas vem de um tipo de cópia errado, um banco de dados ausente, um nome de banco de dados com o prefixo alterado ou a versão de PHP. Experimente primeiro o que pode fazer sozinho; abra um pedido de suporte quando não tiver o acesso necessário.

Problema Causa provável Solução
O arquivo de cópia não carrega Seção errada ou tipo de arquivo incompatível Confirme o tipo de cópia com a Figura 1; por exemplo, não carregue uma cópia Home Directory na seção MySQL.
O arquivo é grande demais e o upload para Limite de carregamento do browser ou quebra de ligação Restaure apenas a parte de que precisa; compacte o banco de dados como .sql.gz. Se continuar falhando, abra um pedido com o tamanho do arquivo.
Disk cota exceeded O arquivo e o conteúdo extraído ultrapassam a cota Apague arquivos desnecessários e cópias antigas; como revendedor, aumente a cota do pacote ou da conta no WHM.
A opção de restauração não aparece A funcionalidade Backup está desativada na lista de funcionalidades da conta Como revendedor, confirme em WHM › Feature Manager que a funcionalidade de cópias está ativa na lista de funcionalidades da conta.
Não há botão de restauração para a cópia completa As cópias completas não são restauradas no cPanel É o comportamento esperado. Abra um pedido, ou extraia apenas a parte de que precisa e restaure-a pelo método parcial.
A restauração terminou, mas o site não abre Banco de dados ausente, versão de PHP diferente ou arquivos na pasta errada Procure o erro correspondente nesta tabela; leia o registro em Metrics › Errors.
403 Forbidden Sem arquivo de índice, permissões erradas ou uma regra do .htaccess a bloquear Confirme que há um arquivo de índice em public_html; defina 755 nas pastas e 644 nos arquivos.
404 Not Found Arquivos extraídos para uma subpasta ou regras de links permanentes ausentes Mova os arquivos para a pasta certa; no WordPress, salve uma vez Configurações › Links permanentes.
500 Internal Server Error Versão de PHP incompatível, extensão de PHP em falta ou linha errada no .htaccess Defina a versão de PHP usada quando a cópia foi feita; leia o erro em Metrics › Errors.
Aparece a página predefinida do cPanel Os arquivos foram para a raiz de documentos errada Verifique a raiz de documentos em cPanel › Domains e mova para lá os arquivos.
"Error establishing a database connection" Banco de dados ausente, usuário não atribuído ou prefixo antigo na configuração Em MySQL Databases, verifique o banco de dados, o usuário e ALL PRIVILEGES; atualize o arquivo de configuração para o prefixo newuser_.
A importação do banco de dados para no meio Limite do phpMyAdmin ou tempo esgotado Compacte o dump; se continuar falhando, abra um pedido com o tamanho do arquivo.
Os arquivos voltaram, mas o banco de dados não A cópia Home Directory não inclui bancos de dados Restaure o banco de dados separadamente na seção MySQL.
O banco de dados voltou, mas o site não se conecta O usuário e a senha não foram restaurados, ou o prefixo mudou Recrie o usuário e atribua privilégios; atualize o arquivo de configuração.
As contas de email não aparecem Só foi restaurada uma cópia MySQL ou de Forwarders, ou a lista não foi atualizada Confirme que a cópia Home Directory foi restaurada; se continuarem sem aparecer, abra um pedido.
Os emails antigos não voltaram As cópias de reencaminhamentos e filtros não contêm mensagens As mensagens voltam com a cópia Home Directory; se só precisa do email, abra um pedido.
Um reencaminhamento não funciona Endereço de destino errado ou o reencaminhamento não foi restaurado Verifique Email › Forwarders; restaure novamente a cópia ou adicione-o à mão.
Versão de PHP incompatível As cópias parciais não levam a definição de versão de PHP Escolha a versão certa no MultiPHP Manager ou no Select PHP Version e ative as extensões necessárias.
Problema no .htaccess Linhas de handler PHP ou redirecionamentos específicos do servidor antigo Mude temporariamente o nome do .htaccess e teste de novo; remova a linha problemática.
Permissões de arquivos erradas O arquivo foi criado em outro sistema Em File Manager › Permissions, defina 755 nas pastas e 644 nos arquivos; não use 777.
As tarefas cron não correm Não vêm nas cópias parciais ou os caminhos têm o usuário antigo Recrie-as em Advanced › Cron Jobs e mude os caminhos para /home/newuser/.
Erro de SSL O certificado ainda não foi emitido ou o domínio não aponta para este servidor Execute Run AutoSSL em Security › SSL/TLS Status; confirme que o domínio aponta para este servidor.

Erros comuns

  • Achar que uma Full Account Backup e uma cópia do diretório principal são a mesma coisa.
  • Não fazer uma cópia da conta atual antes de restaurar.
  • Restaurar na conta cPanel errada.
  • Não verificar a data da cópia e voltar mais atrás do que o pretendido.
  • Carregar uma cópia grande sem verificar o espaço em disco.
  • Restaurar apenas os arquivos do site e esquecer o banco de dados.
  • Restaurar o banco de dados sem verificar o usuário e ALL PRIVILEGES.
  • Confundir a restauração de encaminhamentos com a restauração de caixas de e-mail.
  • Não verificar a versão de PHP depois da restauração.
  • Assumir que as tarefas cron voltam com uma cópia parcial.
  • Restaurar um banco de dados antigo diretamente sobre uma loja online em produção e apagar os pedidos feitos depois da cópia.

Perguntas frequentes

Como restauro um backup no cPanel?

Primeiro identifique o tipo de cópia. As cópias Home Directory, MySQL, Email Forwarders e Email Filters pode restaurá-las sozinho: abra cPanel › Files › Backup, escolha o arquivo na seção Restore correspondente e clique em Upload. A Full Account Backup não é restaurada no cPanel; na Revenda de Hospedagem da Domain Name API você abre um pedido de suporte. Antes de restaurar, faça uma cópia da conta atual.

Posso restaurar uma cópia completa no cPanel?

Não. Segundo a documentação do cPanel, uma cópia completa da conta não pode ser restaurada automaticamente na interface do cPanel; a função só existe no WHM e exige acesso de administrador do servidor. Como revendedor, prepare o arquivo e abra um pedido de suporte. Se só precisa dos arquivos ou de um banco de dados, extraia essa parte e restaure-a pelo método parcial.

Como restauro um arquivo cpmove?

Um arquivo cpmove é uma cópia completa da conta e é restaurado no WHM com acesso de administrador do servidor. Na Revenda de Hospedagem da Domain Name API, abra um pedido de suporte com o domínio, o usuário cPanel de destino, o tamanho do arquivo e se uma conta existente com o mesmo nome deve ser substituída. Antes disso, transfira uma cópia da conta de destino.

O que restaura uma cópia do diretório principal?

A cópia Home Directory restaura os arquivos do diretório principal da conta cPanel: public_html, as pastas de domínios adicionais, arquivos ocultos como o .htaccess e o email dos seus domínios. Não restaura bancos de dados, encaminhamentos, filtros no nível da conta, tarefas cron, domínios definidos nem a versão de PHP selecionada; isso é configurado separadamente.

Como restauro uma cópia MySQL?

Se o usuário da conta for o mesmo, carregue a cópia MySQL do cPanel em cPanel › Files › Backup › Restore a MySQL Database Backup. Se o usuário for diferente, crie um novo banco de dados e um usuário com o MySQL Database Wizard, atribua ALL PRIVILEGES, importe o dump com o phpMyAdmin Import e atualize o arquivo de configuração do site com os novos dados.

Como carrego um arquivo .sql no cPanel?

Crie um banco de dados e um usuário com o MySQL Database Wizard do cPanel e atribua ao usuário ALL PRIVILEGES. Depois selecione esse banco de dados no phpMyAdmin e importe o arquivo na aba Import. Se o arquivo ultrapassar o limite indicado na tela Import, compacte-o como .sql.gz. Por fim, atualize os dados do banco de dados no arquivo de configuração do site.

Restaurar uma cópia apaga os arquivos existentes?

A restauração Home Directory escreve os arquivos da cópia e substitui os que têm o mesmo nome; os arquivos que não estão na cópia devem ser mantidos. A restauração MySQL substitui o conteúdo do banco de dados pelo da cópia. Por isso, o mais seguro é fazer uma cópia dos arquivos e do banco de dados atuais antes de restaurar.

Restaurar uma cópia recupera os meus emails?

Depende do tipo de cópia. A cópia Home Directory e a Full Account Backup contêm as mensagens das caixas de e-mail. As cópias MySQL, Email Forwarders e Email Filters não contêm mensagens. Restaurar uma cópia Home Directory por causa de alguns emails também substitui os arquivos do site, por isso, para uma só caixa de e-mail, é mais seguro abrir um pedido de suporte.

O que restaura a cópia de Forwarders?

A cópia de Email Forwarders restaura apenas as regras de encaminhamento, por exemplo enviar o e-mail de info@ para outro endereço. Não restaura caixas de e-mail, mensagens nem filtros. É carregada em cPanel › Files › Backup › Restore Email Forwarders e o resultado é verificado em Email › Forwarders.

Por que não vejo a opção de restauração?

Se não houver seção Restore, a funcionalidade Backup pode estar desativada na lista de funcionalidades da conta; como revendedor, verifique no WHM Feature Manager. No caso de uma Full Account Backup, é normal não ver a opção, porque as cópias completas não são restauradas no cPanel. Nesse caso, abra um pedido ao suporte da Domain Name API.

Como restauro um arquivo de cópia muito grande?

Primeiro confirme que a cota de disco comporta o arquivo e o conteúdo extraído; se necessário, aumente o pacote no WHM. Considere restaurar apenas a parte de que precisa em vez da cópia inteira e compacte os dumps de bancos de dados como .sql.gz. Se o upload pelo navegador continuar parando no meio, abra um pedido de suporte indicando o tamanho do arquivo.

Quanto tempo demora uma restauração no cPanel?

Depende do tamanho da cópia, do número de arquivos, da velocidade da sua conexão e da carga do servidor. Um site pequeno é restaurado em poucos minutos; cópias de vários GB demoram mais para carregar e extrair. Mantenha a aba do navegador aberta até o processo terminar e aguarde a mensagem de resultado.

Por que o site não abre depois da restauração?

As causas mais comuns são um banco de dados que não foi restaurado, o prefixo antigo do banco de dados no arquivo de configuração, uma versão de PHP diferente e arquivos extraídos para a pasta errada. Leia o registro em cPanel › Metrics › Errors, verifique o banco de dados e os privilégios do usuário, e defina a versão de PHP usada quando a cópia foi feita.

Como restauro uma cópia do WordPress no cPanel?

Uma cópia do WordPress tem duas partes: arquivos e banco de dados. Restaure os arquivos com uma cópia Home Directory ou extraindo o arquivo no File Manager, e o banco de dados com uma cópia MySQL ou com o phpMyAdmin Import. Depois verifique DB_NAME, DB_USER, DB_PASSWORD e DB_HOST no wp-config.php e salve uma vez a configuração de Links permanentes.

Ficou bloqueado ao restaurar a cópia?

Abra um pedido ao suporte da Domain Name API. Indique o domínio, o tipo de cópia (completa, Home Directory, MySQL, etc.), o tamanho do arquivo, o passo em que falhou e a mensagem de erro exata ou uma captura de tela, para que a nossa equipe possa continuar exatamente a partir desse ponto.

Abrir um pedido de suporte

Procura uma Revenda de Hospedagem cPanel com marca própria?

Com a Revenda de Hospedagem da Domain Name API, pode oferecer hospedagem cPanel aos seus clientes com a sua própria marca e gerenciar as contas no WHM. Veja os pacotes.

Ver o Alojamento de Revenda cPanel