Como migrar um site para o cPanel na Revenda de Hospedagem
Migrar um site para o cPanel na Revenda de Hospedagem é muito mais do que copiar os arquivos do site. Também precisa transferir os bancos de dados, as contas de email e as mensagens existentes, os registros DNS, as configurações de PHP e as tarefas cron, e verificar o estado do SSL. O caminho mais seguro é preparar primeiro a nova conta cPanel, testar o site sem alterar o DNS e mudar o DNS apenas quando os testes derem certo.
Não cancele a hospedagem antiga logo que a cópia termine. As alterações de DNS não chegam a todos ao mesmo tempo. Até tudo estar verificado, a conta antiga é o seu caminho de volta se faltar um arquivo ou se um email chegar atrasado.
Resposta rápida
Para migrar um site para o cPanel com segurança: faça o inventário da origem e um backup completo. Crie o pacote e a conta cPanel no WHM. Transfira arquivos, bancos de dados, email e tarefas cron. Teste o site através do arquivo hosts sem alterar o DNS. Quando os testes derem certo, aponte o DNS para o novo servidor e verifique o SSL e o email. Encerre a hospedagem antiga no fim.
Importante: restaurar uma cópia completa (cpmove) e a ferramenta Transfer Tool do WHM exigem acesso no nível do servidor (root), por isso em uma conta de revenda são tratados pela equipe de suporte. Já a migração com cópias parciais você pode fazer sozinho.
A quem se destina este guia: revendedores com Revenda de Hospedagem cPanel em Linux da Domain Name API que estão transferindo o site de um cliente a partir de outro fornecedor. Tempo de trabalho: 30–90 minutos para um site pequeno. Propagação DNS: pode demorar mais algumas horas. Última atualização: 4 de outubro de 2026
Este guia usa example.com como site, 192.0.2.10 como novo servidor e 198.51.100.20 como fornecedor antigo. São valores reservados para documentação; utilize os dados das suas próprias informações de serviço.
O caminho curto: uma migração segura para o cPanel em 12 passos
Todos os guias de migração da Domain Name API seguem o mesmo padrão de segurança. A ordem nunca muda: cada passo só começa depois de o anterior estar verificado, e o DNS é sempre a última coisa em que mexe.

| Passo | O que vai fazer | Onde |
|---|---|---|
| 1 | Fazer o inventário, guardar os registros DNS e baixar o TTL | Fornecedor antigo e fornecedor de DNS |
| 2 | Fazer cópias completas e parciais e transferi-las | cPanel antigo › Backup |
| 3 | Criar o pacote e a nova conta cPanel | WHM › Packages, Create a New Account |
| 4 | Transferir os arquivos do site | Novo cPanel › Backup ou File Manager |
| 5 | Transferir os bancos de dados, criar o usuário e atualizar o arquivo de configuração | Novo cPanel › MySQL Databases, phpMyAdmin |
| 6 | Criar as contas de email e, se necessário, transferir as mensagens | Novo cPanel › Email Accounts |
| 7 | Definir a versão de PHP, os limites e as tarefas cron | Novo cPanel › MultiPHP, Cron Jobs |
| 8 | Testar o site sem alterar o DNS | Arquivo hosts do seu computador |
| 9 | Apontar o DNS para o novo servidor | Gestão do domínio ou fornecedor de DNS |
| 10 | Verificar o SSL, o email e as funções do site | Novo cPanel › SSL/TLS Status, Email Deliverability |
| 11 | Manter os dois ambientes ativos durante a observação | Registros, email, feedback do cliente |
| 12 | Encerrar a hospedagem antiga quando os critérios forem cumpridos | Fornecedor de hospedagem antiga |
Que método de migração devo usar?
O método certo depende do acesso que tem na origem. O que exige permissões no nível do servidor não pode ser feito com uma conta de revenda; para esses passos, abre um pedido de suporte.

O que uma conta de revenda não pode fazer
A Transfer Tool e o Restore a Full Backup/cpmove File do WHM pertencem ao administrador do servidor e não aparecem no WHM de revenda. Se não os vê, é o esperado.
Se quiser migrar com uma cópia completa, prepare o arquivo de cópia e abra um pedido de suporte. Antes de começar, confirme com a equipe de suporte o escopo e o prazo da ajuda na migração.
Passo 1: Faça o inventário antes de começar
Quase tudo o que se perde em uma migração se perde porque ninguém anotou: um subdomínio, um registro TXT adicionado para um serviço de email ou uma tarefa cron que roda de madrugada. Comece por registrar o seguinte na origem.
| Elemento | Onde ver na origem | Porque é importante |
|---|---|---|
| Domínio principal, domínios adicionais e subdomínios | cPanel › Domains | Cada um tem a sua raiz de documentos; se esquecer um, esse site não abre. |
| Arquivos do site e raízes de documentos | File Manager › public_html e outras pastas | Arquivos na pasta errada mostram um 404 ou uma página padrão. |
| Bancos de dados e respectivos usuários | MySQL Databases | O site se conecta com um nome de banco de dados, um usuário e uma senha. |
| Contas de email e cotas | Email Accounts | Se as contas não forem recriadas, o email recebido é devolvido. |
| Reencaminhamentos, respostas automáticas, filtros | Forwarders, Autoresponders, Email Filters | Não se veem, mas quebram fluxos de trabalho. |
| Registros DNS (A, CNAME, MX, TXT) | Zone Editor ou o fornecedor de DNS atual | Se perder SPF, DKIM, DMARC ou registros de verificação, o email e os serviços falham. |
| Onde está hospedado o email | O endereço no registro MX | Se for Microsoft 365 ou Google Workspace, o MX não deve mudar. |
| Versão e definições de PHP | MultiPHP Manager, MultiPHP INI Editor ou Select PHP Version | Uma versão de PHP diferente pode causar erros 500. |
| Tarefas cron | Cron Jobs | O faturamento, as cópias e as newsletters não se transferem sozinhos. |
| SSL e redirecionamentos | SSL/TLS Status, Redirects, .htaccess | O HTTPS e o redirecionamento com www precisam ser verificados de novo no novo servidor. |
| Contas FTP | FTP Accounts | O acesso do cliente ou do desenvolvedor não deve ser cortado. |
| Integrações externas | Gateways de pagamento, chaves API, listas de IP autorizados | Alguns serviços autorizam por IP do servidor; precisam do novo. |
Guarde os registros DNS e baixe o TTL
- Faça uma captura de tela ou uma exportação de todos os registros DNS atuais. Faz parte do seu plano de reversão.
- Baixe o TTL dos registros A e MX para um valor curto, como 300 segundos, idealmente pelo menos um dia antes da mudança.
- Se mudar sem baixar o TTL, alguns visitantes podem continuar com o IP antigo em cache durante todo o TTL anterior.
Verificação do passo
O que deve ver: Uma lista escrita de tudo o que vai transferir e uma cópia dos registros DNS.
O erro mais comum aqui: Anotar apenas public_html e esquecer os domínios adicionais, os reencaminhamentos de email e as tarefas cron.
Passo seguinte: Faça o backup da origem.
Passo 2: Faça a cópia de segurança do alojamento de origem
O backup tem duas funções: é o material que vai migrar e é o ponto ao qual pode voltar se algo der errado. Não o deixe apenas no servidor antigo; transfira-o para o seu computador.
Se a origem for cPanel
- No cPanel antigo, abra Files › Backup.
- Use Download a Full Account Backup para criar uma cópia completa. Receberá uma notificação quando estiver pronta; o arquivo é criado no diretório principal como
backup-...tar.gz. - Em Partial Backups, na mesma tela, transfira também o Home Directory, cada banco de dados de MySQL Databases e ainda Email Forwarders e Email Filters.
- Confirme que o que transferiu cabe no espaço em disco do novo pacote.
Se a origem for outro painel
No Plesk, no DirectAdmin ou em um painel próprio, siga a mesma lógica: transfira todos os arquivos web em um único arquivo, exporte cada banco de dados como dump .sql e anote as contas de email. Se tiver apenas acesso FTP, use um cliente FTP para os arquivos e o phpMyAdmin para o banco de dados.
Uma nota sobre senhas
As senhas de email e de bancos de dados não podem ser lidas a partir de uma cópia. As contas restauradas a partir de uma cópia completa mantêm as senhas. Em uma migração manual vai definir novas senhas de email e compartilhá-las com o seu cliente, por isso combine isto com ele antes de começar.
Verificação do passo
O que deve ver: Uma cópia completa no seu computador, além das cópias do diretório principal e dos bancos de dados.
O erro mais comum aqui: Deixar a única cópia no servidor que vai encerrar.
Passo seguinte: Prepare a nova conta cPanel.
Passo 3: Crie o pacote e a conta cPanel no WHM
Prepare o novo ambiente antes de transferir qualquer conteúdo. No cPanel, cada site vive em uma conta cPanel, e o pacote define os limites dessa conta.
- Faça login no WHM com o seu usuário de revenda (HTTPS na porta 2087, ou acesso direto a partir do painel de revenda).
- Em Packages › Add a Package, crie um pacote que cubra a origem: o espaço em disco e o número de bancos de dados, contas de email e domínios adicionais devem ser pelo menos os que a origem usa.
- Em Account Functions › Create a New Account, crie a conta. Insira em Domain o domínio real do site (
example.com) e escolha o pacote. - Anote o nome de usuário. O cPanel o adiciona como prefixo aos nomes dos bancos de dados e dos respectivos usuários, o que é importante no passo 5.
Guias relacionados: Como criar um pacote no WHM · Como criar uma conta de cliente no WHM
Verificação do passo
O que deve ver: A nova conta com o pacote correto em WHM › List Accounts.
O erro mais comum aqui: Criar a conta com um domínio temporário e tentar mudá-lo depois. Use o domínio real; o site em produção não é afetado até o DNS mudar.
Passo seguinte: Transfira os arquivos.
Passo 4: Transfira os ficheiros do site
Pode transferir os arquivos de duas formas. Se a origem também for cPanel, restaurar a cópia do diretório principal é o caminho com menos erros.
Via A: restaurar a cópia do diretório principal (origem cPanel)
- Abra o cPanel da nova conta (WHM › List Accounts › ícone cP).
- Carregue a cópia do diretório principal em Files › Backup › Restore a Home Directory Backup.
- A restauração escreve o diretório principal, incluindo
public_html, as pastas dos domínios adicionais e os dados de email. Se a nova conta já tiver arquivos que queira manter, faça antes uma cópia.
Via B: carregar com o File Manager ou por FTP
- Junte os arquivos da origem em um único arquivo
.zip. - No File Manager do novo cPanel, abra a raiz de documentos correta. Para o domínio principal é normalmente
public_html; as raízes dos domínios adicionais aparecem em Domains. - Carregue o arquivo, clique nele com o botão direito e escolha Extract; depois, exclua o arquivo.
- Em sites grandes, o FTP ou SFTP é mais fiável, porque pode retomar se a ligação cair.
Não se esqueça dos arquivos ocultos
Os arquivos que começam com ponto, como .htaccess, .env e .user.ini, estão ocultos por predefinição. Ative Settings › Show Hidden Files (dotfiles) no File Manager.
Verifique os caminhos absolutos nos arquivos de configuração. Um caminho como /home/olduser/public_html na origem deve passar a /home/newuser/public_html.
As permissões devem ser normalmente 755 para pastas e 644 para arquivos. 777 é um risco de segurança e causa erros 500 em alguns servidores.
Verificação do passo
O que deve ver: As pastas do site, os arquivos ocultos e index.php ou index.html na raiz de documentos.
O erro mais comum aqui: Extrair para uma subpasta, de modo que o site fica em example.com/site/ e o endereço principal parece vazio.
Passo seguinte: Transfira os bancos de dados.
Passo 5: Transfira as bases de dados
Um site dinâmico (WordPress, loja online, uma aplicação sob medida) não abre sem a seu banco de dados. Transferir um banco de dados tem cinco partes: criar o banco de dados, criar um usuário, dar acesso a ele, importar o conteúdo e atualizar o arquivo de configuração do site.
- No novo cPanel, abra Databases › MySQL Database Wizard e crie o banco de dados. O cPanel adiciona o nome de usuário como prefixo, por exemplo
newuser_wp. - No mesmo assistente, crie um usuário do banco de dados com uma senha forte.
- Atribua ao usuário ALL PRIVILEGES sobre o banco de dados.
- Abra o phpMyAdmin, selecione o novo banco de dados e carregue o dump
.sqlna aba Import. - 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 atualizar |
|---|---|---|
| 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 |
| Aplicação à medida | O arquivo que o seu desenvolvedor utiliza | Dados de ligação e quaisquer caminhos absolutos |
Se o nome de usuário mudar
Um banco de dados chamado olduser_wp na origem passa a newuser_wp na nova conta. É por isso que Backup › Restore a MySQL Database Backup só funciona sem problemas quando o usuário cPanel é o mesmo. Se for diferente, crie o banco de dados com o novo nome no assistente, importe-o com o phpMyAdmin e atualize o arquivo de configuração com o novo nome.
Bases de dados grandes
O phpMyAdmin tem um limite de upload, indicado na tela Import. Se o seu dump for maior, compacte-o como .sql.gz; se mesmo assim não couber, peça ajuda ao suporte. Uma importação incompleta deixa tabelas em falta, e os erros costumam aparecer mais tarde.
Verificação do passo
O que deve ver: O mesmo número de tabelas no phpMyAdmin que na origem, 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 dar acesso ao usuário. O site mostra "Error establishing a database connection".
Passo seguinte: Transfira o email.
Passo 6: Transfira as contas de email e as mensagens
Criar uma conta de email no novo cPanel não significa que as mensagens do servidor antigo foram transferidas. A conta e as mensagens que contém são duas coisas diferentes. Antes de alterar o DNS, combine com o seu cliente se as mensagens existentes precisam ser transferidas.
| Situação | O que fazer |
|---|---|
| Restaurou a cópia do diretório principal (Via A) | Os dados de email vêm com a cópia. Confirme que as contas aparecem em Email Accounts com as cotas corretas. |
| Transferiu os arquivos manualmente (Via B) | Recrie cada endereço em Email Accounts › Create. Transfira as mensagens antigas à parte por IMAP (ver abaixo). |
| O email está no Microsoft 365 ou no Google Workspace | Não crie caixas de e-mail neste servidor. Em Email Routing, escolha Remote Mail Exchanger e mantenha os registros MX exatamente como estavam. |
Transferir mensagens antigas por IMAP
- Adicione o mesmo endereço duas vezes em um cliente de email (o Thunderbird, por exemplo): uma conexão com o servidor antigo e outra com o novo. Como o DNS ainda não mudou, use para o novo o endereço de servidor indicado nos dados do seu serviço.
- Arraste as pastas da conta antiga para a nova. Se houver muitas caixas de e-mail, uma ferramenta de sincronização IMAP é mais rápida.
- Depois da mudança de MX, repita uma vez para as mensagens que chegaram tarde ao servidor antigo.
Recrie também os reencaminhamentos (Forwarders), as respostas automáticas (Autoresponders) e os filtros (Email Filters). Se a origem for cPanel, pode restaurar as cópias de encaminhamentos e filtros a partir da tela Backup.
Verificação do passo
O que deve ver: Uma caixa de e-mail para cada endereço no novo servidor e, quando necessário, as pastas transferidas.
O erro mais comum aqui: Deixar o email local ativo no cPanel para um cliente que usa o Microsoft 365. As notificações do formulário de contato enviadas pelo site acabam na caixa local em vez do serviço externo.
Passo seguinte: Defina o PHP e as tarefas cron.
Passo 7: Verifique as definições de PHP e as tarefas cron
Versão e limites de PHP
- Compare a versão de PHP da origem com a que anotou. No novo cPanel, defina a versão em MultiPHP Manager. Se o seu painel tiver Select PHP Version, a versão e as extensões são gerenciadas aí.
- Confirme que as extensões de PHP de que precisa (por exemplo
intl,gd,imagick,zip) estão ativas. - Em MultiPHP INI Editor, ajuste
memory_limit,upload_max_filesize,post_max_sizeemax_execution_timeao que a origem precisa. Os valores não podem ultrapassar os limites de recursos do pacote.
Tarefas cron
As tarefas cron não se transferem sozinhas e, mesmo quando vêm com uma cópia completa, os caminhos precisam ser verificados. Recrie cada tarefa em Advanced › Cron Jobs no novo cPanel e atualize os caminhos do comando para o novo nome de usuário.
Não deixe a mesma tarefa correr duas vezes
Se a mesma tarefa cron correr no servidor antigo e no novo durante a mudança, os clientes podem receber emails em duplicado e a mesma fatura pode ser emitida duas vezes. Ative as tarefas no novo servidor no momento da mudança de DNS e pare as antigas nesse mesmo momento.
Verificação do passo
O que deve ver: A mesma versão de PHP da origem, as extensões necessárias e as tarefas cron com os novos caminhos.
O erro mais comum aqui: Testar o site sem verificar a versão de PHP e culpar os arquivos por um erro 500.
Passo seguinte: Teste o site sem alterar o DNS.
Passo 8: Teste o site sem alterar o DNS
A forma mais confiável de ver o site no novo servidor antes de alterar o DNS é acrescentar uma linha ao arquivo hosts do seu próprio computador. Essa linha não afeta mais ninguém; os demais visitantes continuam na hospedagem antiga.

| Sistema operacional | Arquivo | Como abrir |
|---|---|---|
| Windows | C:\Windows\System32\drivers\etc\hosts | Abra o Bloco de Notas com Executar como administrador e depois abra o arquivo. |
| macOS | /etc/hosts | No Terminal: sudo nano /etc/hosts |
| Linux | /etc/hosts | No Terminal: sudo nano /etc/hosts |
# Teste do novo servidor cPanel (apagar depois do teste)
192.0.2.10 example.com www.example.com Guarde, limpe a cache DNS (ipconfig /flushdns no Windows) e abra o site em uma janela privada. Para confirmar que está no novo servidor, pode colocar temporariamente na raiz de documentos um arquivo chamado test-new-server.txt; se esse endereço abrir, está no lugar certo.
O que testar
- A página inicial e algumas páginas interiores
- O acesso à área de administração (por exemplo
/wp-admin) - Uma ação que escreva no banco de dados: um comentário, um registro ou um rascunho
- Os formulários de contato e de pedidos
- O upload de arquivos
- Imagens, CSS e arquivos JavaScript
- As ligações de pagamento ou a API externas (em modo de teste)
- Os domínios adicionais e subdomínios, se existirem
Um aviso de SSL aqui é normal
Nesta fase, o navegador pode mostrar o aviso "a sua conexão não é particular". O AutoSSL emite normalmente o certificado depois de o domínio apontar para o novo servidor. Pode avançar para testar, mas não insira dados de pagamento reais.
Verificação do passo
O que deve ver: O site e a área de administração a funcionar sem erros no novo servidor.
O erro mais comum aqui: Esquecer de apagar a linha do arquivo hosts depois do teste. Vai continuar vendo um resultado diferente durante algum tempo após a mudança de DNS e procurar o problema no lugar errado.
Passo seguinte: Se o site for dinâmico, planeje primeiro a sincronização final e depois altere o DNS.
Evite perder dados em sites dinâmicos
Em lojas online, sites de membros, reservas, fóruns ou CRM, os novos pedidos e registros continuam chegando ao servidor antigo entre a primeira cópia e a mudança de DNS. Se não os transferir, eles serão perdidos.
- Escolha uma janela de manutenção com pouco tráfego e informe o seu cliente.
- Quando começar, ative o modo de manutenção ou pare as escritas no site antigo (sem novos pedidos nem registros).
- Faça um último dump do banco de dados e volte a importá-lo no novo servidor (sincronização final). Copie também os arquivos enviados nesse meio-tempo.
- Altere o DNS e desative o modo de manutenção no novo servidor.
Isto reduz o tempo de indisponibilidade, mas não o elimina. Em vez de prometer zero interrupções, informe o seu cliente sobre uma janela de manutenção curta e planejada.
Passo 9: Aponte o DNS para o novo servidor
A mudança de DNS é o único passo difícil de reverter, por isso fica para o fim. Não precisa transferir o domínio: continua onde está registrado e apenas muda para onde aponta. Também não é necessário alterar os servidores de nomes em todas as migrações.
| Cenário | O que muda | Quando escolher |
|---|---|---|
| A. Passar para servidores de nomes privados | Os servidores de nomes do domínio passam a ser ns1.example.net e ns2.example.net. A partir daí, os registros DNS são gerenciados no Zone Editor do novo cPanel. | Quando vai gerenciar o DNS do cliente. |
| B. Atualizar apenas os registros | No fornecedor de DNS atual (Cloudflare, por exemplo), defina o registro A como 192.0.2.10 e atualize os registros www e AAAA se necessário. | Quando o DNS está hospedado em outro lugar e vai continuar lá. |
Guia relacionado: Como criar servidores de nomes privados no Alojamento de Revenda cPanel
No cenário A, mantenha os registros de email e de verificação
Quando os servidores de nomes mudam, passa a valer a zona DNS do novo cPanel. A zona criada com a conta tem apenas registros padrão; não inclui os registros personalizados do DNS antigo.
Antes de alterar os servidores de nomes, recrie no Zone Editor os registros MX, SPF (TXT), DKIM, DMARC e os TXT de verificação do Google, Microsoft, Meta e serviços semelhantes que guardou no passo 1.

Verificação do passo
O que deve ver: O novo IP (192.0.2.10) em nslookup example.com; no cenário A, os novos servidores de nomes em nslookup -type=NS example.com.
O erro mais comum aqui: Alterar o DNS antes de testar, ou alterar os servidores de nomes antes de adicionar os registros personalizados à nova zona.
Passo seguinte: Verifique o SSL, o email e as funções do site.
Passo 10: Verifique o SSL, o email e as funções do site
SSL e HTTPS
- Quando o DNS apontar para o novo servidor, abra Security › SSL/TLS Status no novo cPanel.
- Se não houver certificado para o domínio e para
www, use Run AutoSSL. O certificado antigo não passa sozinho para a nova conta. - Para o redirecionamento HTTPS, use Force HTTPS Redirect na tela Domains. Se o
.htaccesstambém redirecionar, ativar ambos pode causar um ciclo de redirecionamentos. - Verifique o cadeado, o site com e sem
wwwe os avisos de conteúdo misto.
- Envie uma mensagem nova e receba outra de um endereço externo (um email pessoal, por exemplo).
- Verifique o estado de SPF e DKIM em Email › Email Deliverability. Se o DNS for gerenciado em outro lugar, adicione lá os registros sugeridos.
- Confirme que o registro DMARC mantém o valor anterior.
Lista de verificação pós-migração
"O site abre" não significa que a migração correu bem. É preciso verificar tudo o que se segue:
- O domínio aponta para o novo servidor
- HTTPS com certificado válido (incluindo
www) - Página inicial e páginas interiores
- Acesso à área de administração
- Leitura e escrita no banco de dados
- Formulários e upload de arquivos
- Imagens, CSS e JavaScript
- Redirecionamentos
- Tarefas cron (ativas no novo servidor, paradas no antigo)
- Envio e recepção de email
- Registros MX, SPF, DKIM, DMARC
- Domínios adicionais e subdomínios
- Integrações externas (pagamentos, API, listas de IP autorizados)
- Registros de erros (cPanel › Metrics › Errors)
Passo 11: Mantenha os dois ambientes ativos durante a observação
Depois da mudança de DNS, alguns visitantes e servidores de email podem continuar usando o endereço antigo durante algum tempo. Em vez de um número fixo de dias, procure estes sinais:
- Não há mais tráfego significativo nos registros de acesso do servidor antigo.
- Não chega email novo ao servidor antigo, e o que chegou já foi transferido.
- Tudo o que está na lista de verificação foi confirmado e o seu cliente confirmou que o site funciona.
- Em sites críticos para o negócio, pelo menos um ciclo completo (um pedido, uma fatura, uma newsletter) foi concluído no novo servidor.
Passo 12: Encerre o alojamento antigo no fim
- Faça uma última cópia completa da hospedagem antiga e guarde-a.
- Confirme que as tarefas cron do servidor antigo estão paradas.
- Desative a renovação da hospedagem antiga ou cancele a conta. Se o domínio estiver na mesma empresa, certifique-se de que encerra apenas o serviço de hospedagem e não o domínio.
Plano de reversão
Antes de começar, quatro condições precisam ser atendidas: a hospedagem antiga está ativa, você tem uma cópia completa, os registros DNS antigos estão guardados e os passos de reversão estão escritos. Reverter antes da mudança de DNS é fácil; nada mudou ainda. Depois da mudança, apontar o DNS de volta pode não bastar: os pedidos, registros e emails que chegaram ao novo servidor precisam ser levados de volta para o antigo.
Resolução de problemas
| Problema | Causa provável | Solução |
|---|---|---|
| 403 Forbidden | Não há arquivo de índice na raiz de documentos, permissões erradas, ou uma regra do .htaccess bloqueia o acesso | Confirme que os arquivos estão na pasta certa com permissões 644/755; mude temporariamente o nome do .htaccess e tente de novo. |
| 500 Internal Server Error | Versão de PHP incompatível, extensão em falta, diretiva errada no .htaccess | Iguale a versão de PHP à da origem; leia o erro em Metrics › Errors. |
| "Error establishing a database connection" | Nome do banco de dados, usuário ou senha errados na configuração, ou o usuário não tem privilégios | Verifique os nomes com prefixo (newuser_...) e ALL PRIVILEGES. |
| Aparece a página predefinida do cPanel | Os arquivos estão na raiz de documentos errada ou a linha do hosts tem o IP errado | Confirme a raiz de documentos em Domains; verifique o IP na sua linha do hosts. |
| O site continua abrindo a partir do servidor antigo | O DNS ainda não se propagou, o TTL é alto, ou a linha do hosts continua lá | Verifique com nslookup, apague a linha do hosts e limpe a cache DNS. |
| Ciclo de redirecionamentos (demasiados redirecionamentos) | O Force HTTPS e um redirecionamento no .htaccess ou na aplicação estão ativos ao mesmo tempo | Mantenha o redirecionamento em um único lugar. |
| O aviso de SSL persiste | O AutoSSL ainda não correu ou o domínio aponta para outro IP | Confirme o DNS e use Run AutoSSL; se houver registro CAA, verifique se permite a autoridade de certificação. |
| O email recebido não chega | O MX aponta para o servidor antigo ou o Email Routing está errado | Verifique o MX e a definição de Email Routing. |
| O email enviado vai para spam | Falta SPF ou DKIM | Adicione os registros sugeridos em Email Deliverability. |
| A importação do banco de dados para no meio | O arquivo excede o limite do phpMyAdmin | Comprima-o como .sql.gz; se mesmo assim não couber, peça ajuda ao suporte. |
| Uma tarefa cron não corre | O caminho ainda contém o usuário antigo | Atualize os caminhos do comando para /home/newuser/.... |
| Aviso de limite de disco ou de recursos | O pacote é mais pequeno do que o site de origem | Aumente o pacote no WHM ou passe a conta para um pacote adequado. |
Erros comuns
- Começar sem backup, ou deixá-lo apenas no servidor que vai encerrar.
- Transferir os arquivos e esquecer o banco de dados.
- Achar que criar uma conta de email transfere as mensagens.
- Tratar ferramentas no nível do servidor que o WHM de revenda não mostra (Transfer Tool) como ferramentas de revenda.
- Alterar o DNS antes de testar.
- Não verificar a versão de PHP nem as extensões.
- Esquecer as tarefas cron, ou deixá-las a correr nos dois servidores.
- Perder os registros MX, SPF, DKIM e de verificação ao mudar os servidores de nomes.
- Saltar a sincronização final em sites dinâmicos.
- Encerrar a hospedagem antiga antes de a verificação estar concluída.
- Não verificar o SSL nem o endereço com
www.
Perguntas frequentes
Como migro um site para o cPanel?
Faça o inventário da origem e uma cópia completa, crie o pacote e a conta cPanel no WHM e transfira os arquivos, os bancos de dados, o email e as tarefas cron. Teste o site através do arquivo hosts sem alterar o DNS. Quando os testes derem certo, aponte o DNS para o novo servidor, verifique o SSL e o email e encerre a hospedagem antiga no fim.
Posso restaurar sozinho uma cópia completa do cPanel em uma conta de revenda?
Não com uma conta de revenda. Restaurar uma cópia completa (cpmove) e a Transfer Tool do WHM exigem permissões de administrador do servidor. Prepare o arquivo de cópia e abra um pedido de suporte. Se preferir fazê-lo sozinho, restaure as cópias parciais do diretório principal e do MySQL a partir da tela Backup da nova conta cPanel.
Preciso transferir o domínio para mudar de hospedagem?
Não. O domínio pode continuar no registrador atual. Apenas muda para onde aponta: ou define os servidores de nomes do novo fornecedor, ou atualiza o registro A no seu fornecedor de DNS atual com o IP do novo servidor. A transferência do domínio é um processo separado e opcional.
É obrigatório mudar os servidores de nomes?
Não. Se o seu DNS for gerenciado em outro lugar, como a Cloudflare, basta atualizar o registro A (e os registros www e AAAA, se necessário) para o novo IP. Se mudar os servidores de nomes, a gestão do DNS passa para o novo cPanel, por isso adicione antes à nova zona os registros MX, SPF, DKIM e de verificação.
O email é transferido automaticamente?
Depende do método. Se restaurar uma cópia do diretório principal do cPanel, os dados de email vêm com ela. Em uma migração manual, criar a conta no novo cPanel não traz as mensagens antigas; transfira-as separadamente com um cliente de email ou uma ferramenta de sincronização IMAP. Em ambos os casos, verifique as contas e as cotas.
Como transfiro um banco de dados para o cPanel?
Exporte o banco de dados na origem como dump .sql. No novo cPanel, crie um banco de dados e um usuário com o MySQL Database Wizard, atribua ao usuário ALL PRIVILEGES e importe o dump no phpMyAdmin. Depois atualize o nome do banco de dados, o usuário e a senha no arquivo de configuração do site; o cPanel adiciona o nome de usuário como prefixo a esses nomes.
Posso testar o site sem alterar o DNS?
Sim. Acrescente ao arquivo hosts do seu computador uma linha com o IP do novo servidor e o seu domínio, e o site abre a partir do novo servidor apenas no seu computador. Os demais visitantes continuam na hospedagem antiga. No fim, apague a linha e limpe o cache DNS.
O certificado SSL é transferido automaticamente?
O certificado antigo não passa para a nova conta. No novo cPanel, o AutoSSL emite um certificado quando o domínio aponta para o novo servidor. Depois da mudança de DNS, verifique o SSL/TLS Status e use Run AutoSSL se necessário. Se tiver um certificado pago, instale o certificado e a chave privada à parte.
Quando devo encerrar a hospedagem antiga?
Não há um número fixo de dias. Encerre-o quando o servidor antigo já não receber tráfego significativo nem email novo, a lista de verificação estiver confirmada e o seu cliente tiver aprovado o site. Antes disso, faça uma última cópia completa e confirme que as tarefas cron do servidor antigo estão paradas.
Como evito perder dados durante a migração?
Faça uma cópia completa e mantenha a hospedagem antiga ativa. Em sites que escrevem constantemente no banco de dados, como lojas e sites de membros, planeje uma janela de manutenção curta: pare as escritas, leve o banco de dados mais recente para o novo servidor e só depois altere o DNS. Essa sincronização final evita a perda dos dados criados após a primeira cópia.
Como migro um site WordPress para o cPanel?
Os mesmos passos se aplicam: transfira os arquivos e o banco de dados, atualize os dados do banco de dados no wp-config.php e teste o site através do arquivo hosts. Se o domínio se mantiver, não é preciso alterar URL. Se o domínio também mudar, atualize as URLs antigas no banco de dados com uma ferramenta segura de procurar e substituir.
Quanto tempo demora uma migração?
Em um site pequeno, o trabalho demora normalmente entre 30 e 90 minutos. Arquivos e bancos de dados grandes, muitas caixas de e-mail e a transferência de mensagens prolongam o processo. A propagação DNS pode demorar mais algumas horas; baixar o TTL com antecedência a encurta.
Guias relacionados
- Como criar servidores de nomes privados no Alojamento de Revenda cPanel
- Como criar um pacote no WHM
- Como criar uma conta de cliente no WHM
- Como migrar um site para o Plesk no Alojamento de Revenda
Se ficar bloqueado, indique no pedido de suporte o domínio que está transferindo, o painel de origem e o passo em que está, para que a nossa equipe possa continuar exatamente a partir desse ponto.
Venda hospedagem com a sua própria marca
Veja os pacotes de Revenda de Hospedagem cPanel para vender hospedagem com a sua própria marca.
Ver o Alojamento de Revenda cPanel