blog
Painéis

Transferir conta cPanel sem root na hospedagem antiga

O root dispensado é o do servidor antigo, não o do novo. Veja quem executa o script, o que a conta leva junto, o que precisa ser refeito e como testar no IP de destino antes de mexer no DNS.

JR · · 7 min de leitura · 2 tabelas · 5 blocos de código

Resposta curta: sem root na origem, use o script transfer_account_as_user do cPanel & WHM, executado como root no servidor de destino com o usuário e a senha do cPanel antigo; ele traz arquivos, bancos, e-mails e zona DNS da conta, mas não configurações do servidor nem serviços externos.

Neste artigo
  1. O que muda quando você só tem usuário e senha do cPanel
  2. O que conferir antes de rodar o script
  3. Qual comando rodar no destino e o que checar depois
  4. O que a conta leva consigo e o que fica no servidor antigo
  5. Validar pelo destino antes de apontar o DNS
  6. Em que ordem apontar o DNS e desligar a origem
  7. O que dizer ao cliente sobre queda do site e do e-mail

O que muda quando você só tem usuário e senha do cPanel

O cenário é comum em agência: o cliente chega com o site em outra hospedagem, manda o login do cPanel e mais nada. Sem root no servidor de origem, a ferramenta de transferência do WHM no modo tradicional não serve, porque ela pede acesso administrativo ao servidor remoto.

Para esse caso, o cPanel & WHM tem o script transfer_account_as_user. Segundo a documentação oficial, ele transfere uma conta de um servidor cPanel remoto usando as credenciais da própria conta. O detalhe que pega muita gente: o script roda no servidor de destino, como root. Você dispensa o root da origem, não o do destino.

Na prática, isso define quem executa:

Cenário Quem roda o script
VPS ou dedicado com root Você mesmo, via SSH
Revenda ou hospedagem compartilhada O suporte da hospedagem de destino, a seu pedido
Origem sem cPanel (Plesk, painel próprio) Ninguém: o script não se aplica, a migração é manual

Se você é revendedor, mande ao suporte do destino o domínio, o usuário de origem e o host de origem. A senha vai por canal seguro, nunca no corpo de um ticket aberto, e deve ser trocada depois da migração.

Quem executa a transferênciaA origem é cPanel?Não: migração manual, o script não se aplicaVocê tem root no destino?Sim: rode você mesmo via SSHSem root no destinoPeça ao suporte do destino, a seu pedido
Quem executa o script, conforme o acesso que você tem.

O que conferir antes de rodar o script

Vale padronizar este checklist num modelo de tarefa, porque ele se repete em todo cliente novo:

  1. Confirme que a origem é cPanel. Peça um print da tela inicial ou acesse você mesmo. Sem cPanel na origem, pare aqui.
  2. Teste o login. Entre no cPanel de origem com a senha recebida antes de agendar a janela. O script se autentica com usuário e senha da conta, conforme a documentação. Se houver autenticação de dois fatores ativa, a recomendação operacional da equipe é pedir ao cliente que desative o 2FA só durante a transferência e reative logo depois, junto com a troca de senha.
  3. Verifique o espaço. O destino precisa comportar a conta inteira. Recomendação operacional: deixe folga além do tamanho da conta. Este guia não traz medição de quanto espaço extra o processo ocupa durante a transferência.
  4. Anote o que é externo. DNS em Cloudflare ou no registro.br, e-mail em Google Workspace ou Microsoft 365, CDN, cron que chama serviços de fora. Nada disso vem junto.
  5. Baixe o TTL dos registros que serão alterados, com antecedência, onde o DNS realmente está hospedado.
  6. Avise o cliente sobre o congelamento. Conteúdo publicado na origem depois da cópia se perde, a menos que você sincronize de novo.

Qual comando rodar no destino e o que checar depois

O caminho do script é o padrão dos scripts do cPanel. Pela documentação oficial, a execução recebe o nome que a conta terá no destino, o host de origem e o usuário do cPanel de origem. A senha não vai na linha de comando: o script a pede de forma interativa. A forma geral fica assim (valores fictícios):

/usr/local/cpanel/scripts/transfer_account_as_user usuario_destino origem.exemplo.com.br usuario_origem

Antes de rodar em produção, confirme a ordem dos argumentos e as opções aceitas na ajuda da versão instalada:

/usr/local/cpanel/scripts/transfer_account_as_user --help

Se a ajuda mostrar outra ordem ou outros argumentos, vale a ajuda.

Não copie parâmetros de tutorial de terceiros sem bater com a ajuda da versão instalada no seu servidor. Opções mudam entre versões do cPanel & WHM, e um erro de sintaxe aqui só custa tempo, mas um parâmetro mal entendido pode sobrescrever uma conta existente no destino.

Duas regras operacionais que evitam retrabalho:

Depois de concluir, confira no WHM em Listar contas se a conta aparece com o domínio principal e os domínios adicionais esperados.

O que a conta leva consigo e o que fica no servidor antigo

O script move a conta de cPanel, ou seja, o que vive dentro dela. A lista exata do que é incluído está na documentação; a tabela abaixo organiza o que você precisa conferir em cada lado. As linhas "Vem com a conta" seguem o que a documentação descreve como conteúdo da conta. As linhas "Fica de fora" e a coluna de conferência são recomendação operacional da equipe, derivada do fato de o script mover a conta e não o servidor.

Item Situação esperada O que conferir
Arquivos da home (public_html, subdomínios) Vem com a conta Tamanho total e permissões
Bancos MySQL e usuários Vem com a conta Site conecta com o mesmo wp-config
Caixas de e-mail e mensagens Vem com a conta Login no webmail do destino
Zona DNS da conta Vem com a conta Registros customizados (SPF, DKIM, verificações)
Configuração global do servidor de origem Fica de fora Versão de PHP, extensões, limites de memória
Regras personalizadas de servidor web ou firewall Fica de fora Redirects ou bloqueios que não estavam no .htaccess
Serviços externos (DNS de terceiros, e-mail de terceiros, CDN) Fica de fora Onde cada registro realmente aponta
Certificado SSL Confira no destino: os instalados na conta podem vir junto Certificado presente; AutoSSL renova ou reemite após o DNS apontar

O ponto que mais gera surpresa é o PHP. Se o domínio tinha versão fixada no MultiPHP da conta, essa definição pertence à conta e acompanha a transferência. O problema aparece quando o domínio herda o padrão do sistema: o padrão da origem fica para trás, e se o destino tiver outro, o WordPress pode abrir com erro fatal mesmo com arquivos e banco íntegros. Antes de migrar, abra o MultiPHP Manager na origem e anote a versão de cada domínio (fixada ou herdada) e as extensões em uso; no destino, ajuste antes de testar.

Outro ponto: a zona DNS que chega ao destino só vale alguma coisa se o domínio for apontar para os nameservers do destino. Se o DNS do cliente fica no Cloudflare, a zona copiada é só referência; quem manda continua sendo o Cloudflare.

Validar pelo destino antes de apontar o DNS

Não aponte nada sem ver o site rodando no servidor novo. O método mais confiável é forçar a resolução do domínio para o IP do destino, sem tocar no DNS público.

Como testar o site no destino com curl e dig

Troque exemplo.com.br e 203.0.113.10 pelo domínio e pelo IP do destino (valores fictícios):

curl -sI --resolve exemplo.com.br:443:203.0.113.10 https://exemplo.com.br/

Um HTTP/2 200 ou HTTP/1.1 200 indica que o servidor novo responde pelo domínio. Se o certificado da conta veio junto e está válido, o teste passa sem ajuste. Se ele não veio ou estava vencido, erro de certificado é esperado até o AutoSSL emitir um novo depois do apontamento; nesse caso, adicione -k só para o teste.

Para conferir a zona que chegou, consulte o nameserver da hospedagem nova (o ns1 informado por ela), não necessariamente o IP do site. Em revenda e compartilhada, o DNS costuma rodar em outro IP; só use o IP do site se for o mesmo servidor. Com ns1.destino.example como exemplo fictício:

dig @ns1.destino.example exemplo.com.br MX +short
dig @ns1.destino.example exemplo.com.br TXT +short

Compare com a saída dos mesmos comandos apontados para o DNS atual. Diferença em MX ou TXT (SPF, DKIM) é o que derruba e-mail depois da troca.

Como testar o site no destino pelo arquivo hosts

Edite o arquivo hosts da sua máquina com a linha 203.0.113.10 exemplo.com.br e navegue normalmente: login no wp-admin, formulário de contato, checkout se houver loja. Remova a linha ao terminar, ou você vai continuar vendo o servidor novo e achar que a propagação acabou.

Como confirmar o WordPress no destino com WP-CLI

Se tiver SSH no destino, dentro da pasta do site:

wp option get siteurl
wp db check

O siteurl precisa ser o domínio de produção, e o db check não deve listar tabelas com erro.

Em que ordem apontar o DNS e desligar a origem

Com tudo validado, a ordem que menos perde dados é esta:

  1. Congele publicações e pedidos na origem pelo tempo da virada.
  2. Se houve conteúdo novo desde a cópia, sincronize banco e uploads (ou repita a transferência, se o destino permitir sobrescrever com segurança).
  3. Aponte o DNS, seja trocando os nameservers, seja alterando os registros A e MX onde a zona vive.
  4. Acompanhe o AutoSSL no destino até o certificado sair.
  5. Mantenha a origem ativa por alguns dias. E-mail que chegar lá durante a propagação precisa ser recuperado, e a origem é seu plano de volta se algo aparecer tarde.
  6. Troque a senha do cPanel de origem, ou peça ao cliente que troque, e só então cancele.
Ordem da virada do DNSCongelar origemPare publicações e pedidos durante a viradaSincronizar conteúdo novoBanco e uploads desde a cópiaApontar o DNSNameservers ou registros A e MXAguardar AutoSSLAcompanhe até o certificado sairManter origem ligadaPor alguns dias, como plano de volta
Ordem que menos perde dados na troca de endereço.

O que dizer ao cliente sobre queda do site e do e-mail

O cliente quer saber se o site sai do ar e se o e-mail some. Uma frase que costuma resolver:

E deixe por escrito o que não vem junto: e-mail ou DNS em outro provedor, configurações que eram do servidor antigo e não da conta. Isso evita que um problema de Google Workspace vire, na cabeça do cliente, culpa da migração.

Se a origem não for cPanel ou o suporte do destino não puder rodar o script, a saída é a migração manual: backup completo, exportação dos bancos e recriação das caixas de e-mail. Dá mais trabalho, mas o checklist de validação acima continua igual.

Referências

  1. Documentação oficial (cpanel) — The transfer_account_as_user Script | cPanel & WHM Documentation. Consultado em 2026-10-28.
Leia também