blog
WordPress

Migrar WordPress para outra hospedagem sem sair do ar

Checklist reutilizável de agência: o que copiar, o que ajustar no wp-config.php e como testar o domínio real no servidor novo antes de encostar no DNS.

JR · · 12 min de leitura · 3 tabelas · 10 blocos de código

Resposta curta: não existe migração sem janela; existe janela de zero indisponibilidade para o visitante. O caminho é copiar arquivos e banco, testar o domínio real pelo arquivo hosts local e só então trocar o registro A, com o TTL reduzido para 300 segundos de 24 a 48 horas antes.

Neste artigo
  1. O que "sem sair do ar" realmente significa
  2. Nove itens para levantar antes de copiar qualquer arquivo
  3. Copiar arquivos e banco para o servidor cPanel
  4. wp-config.php e as URLs que não devem ser substituídas
  5. Testar o domínio real no servidor novo pelo arquivo hosts
  6. A sequência de TTL, de 48 horas antes a 15 dias depois
  7. O e-mail é a parte que machuca na propagação
  8. O que fazer depois da virada e quando desligar o servidor antigo

Trocar de hospedagem com o site no ar é um problema de ordem, não de dificuldade técnica. Cada etapa isolada é simples: copiar arquivos, importar banco, ajustar credenciais. O que derruba site de cliente é fazer isso na ordem errada, sobretudo trocar o DNS antes de saber se o WordPress sequer abre no servidor novo.

Este artigo é documental. Não há medição de laboratório aqui. O procedimento se apoia na documentação oficial do cPanel sobre migrar uma instalação WordPress para um servidor cPanel, citada nos pontos em que ela define o passo, e no que se acumula de operação: onde o processo costuma travar e como explicar isso ao cliente sem parecer que algo deu errado.

O que "sem sair do ar" realmente significa

Zero indisponibilidade quer dizer que nenhum visitante vê erro de conexão, tela branca ou certificado inválido durante a troca. Não quer dizer que nada muda para o cliente. Existe uma janela de congelamento de conteúdo: o período entre a última cópia do banco de dados e o momento em que o DNS já converge para o servidor novo. Nessa janela, qualquer post publicado, comentário aprovado ou pedido recebido no servidor antigo pode se perder na virada.

Para site institucional, blog e vitrine, essa janela pode ter horas sem consequência nenhuma. Para loja com pedidos entrando o tempo todo, a honestidade manda dizer o seguinte: ou você aceita alguns minutos de modo manutenção no servidor antigo enquanto sincroniza o delta final, ou você aceita o risco de precisar transportar pedidos manualmente. Não existe terceira opção limpa quando o banco continua recebendo escrita dos dois lados.

A parte que de fato pode ficar em zero indisponibilidade é o site público. E ela fica, desde que você teste tudo antes de encostar no DNS.

Ordem segura de uma migração sem quedaInventárioPHP, DNS, e-mail, licençasCópiaArquivos e banco no destinoTeste por hostsDomínio real, só para vocêVirada de DNSRegistro A aponta ao novoPós-viradaSSL, cache, cron, logs
A ordem é o que garante site no ar: o DNS só muda depois que tudo passa no teste por hosts.

Nove itens para levantar antes de copiar qualquer arquivo

Meia hora de inventário evita a migração que só falha às 23h de sexta. Rode este levantamento no servidor antigo e no painel de DNS antes de começar.

Item Onde conferir na origem Por que trava a migração
Versão do PHP Painel da hospedagem ou phpinfo() Tema ou plugin antigo quebra em PHP mais novo, e o servidor destino raramente entrega a mesma versão por padrão
Versão do MySQL/MariaDB phpMyAdmin, rodapé da tela inicial Dump gerado em versão nova pode falhar ao importar em versão antiga
Prefixo das tabelas wp-config.php, linha $table_prefix Nem sempre é wp_, e o ajuste de URLs depende disso
Tamanho de wp-content/uploads du -sh wp-content/uploads Define se dá para subir por FTP ou se precisa de compactação e SSH
Registros de DNS atuais Zona do domínio MX, TXT de SPF, DKIM e CNAME de serviços externos precisam ser recriados antes da virada
Contas de e-mail e aliases Painel de e-mail Cada caixa recriada no destino é senha nova para o cliente configurar
Certificado SSL Navegador, cadeado O certificado do destino só é emitido depois que o DNS aponta para lá
Tarefas agendadas Cron do painel Backup, importador de XML e integração fiscal somem se ninguém olhar
Chaves de licença de plugin Painel dos plugins pagos Alguns licenciam por domínio, outros por IP ou instalação

Dois pontos merecem atenção especial. O primeiro é a lista de serviços externos que apontam para o domínio: gateway de pagamento com URL de callback, webhook de CRM, integração de ERP. Eles não sabem que o site mudou de servidor, e se o callback chegar no servidor antigo durante a propagação, ele some. O segundo é o e-mail, tratado adiante em seção própria porque é onde a migração machuca o cliente de verdade.

Copiar arquivos e banco para o servidor cPanel

A documentação do cPanel descreve o caminho em três blocos: preparar a conta no destino, transferir os arquivos do WordPress e transferir o banco de dados. A ordem abaixo segue essa lógica.

Preparar a conta no destino com a mesma versão de PHP

Crie a conta ou o domínio adicional no cPanel de destino, ajuste a versão do PHP no MultiPHP Manager para a mesma da origem e confirme o diretório raiz do site, normalmente public_html para o domínio principal. Se a versão de PHP da origem não existir no destino, decida agora se vai atualizar plugins antes ou depois da migração. Fazer as duas coisas no mesmo dia é o clássico erro que impede saber o que quebrou.

Empacotar e transferir os arquivos com SSH ou com FTP

Com SSH na origem, compacte a raiz inteira do WordPress:

cd ~/public_html
tar -czf ~/site.tar.gz .

Envie o arquivo para o destino por SFTP, ou use o File Manager do cPanel para fazer o upload e extrair no lugar certo. Sem SSH na origem, resta o FTP tradicional, e aí vale compactar wp-content/uploads à parte pelo gerenciador de arquivos do painel antigo para não transferir dezenas de milhares de arquivos pequenos um a um.

Depois de extrair no destino, confira permissões: diretórios em 755, arquivos em 644, e wp-config.php mais restrito, em 640 ou 600. Extração feita como usuário errado é causa comum de erro 500 logo no primeiro acesso.

Exportar e importar o banco sem truncar o dump

Na origem, com SSH:

mysqldump -u USUARIO -p BANCO > banco.sql

Sem SSH, exporte pelo phpMyAdmin escolhendo o formato SQL. No destino, crie banco e usuário em MySQL Databases, conceda todos os privilégios ao usuário sobre o banco e importe:

mysql -u NOVO_USUARIO -p NOVO_BANCO < banco.sql

Se o dump for grande demais para o phpMyAdmin, compacte antes e importe por linha de comando. Arquivo .sql truncado por timeout de upload gera site que carrega a home e dá erro em toda página interna, um sintoma que engana muita gente.

wp-config.php e as URLs que não devem ser substituídas

No destino, edite wp-config.php com as credenciais novas. São quatro constantes:

define( 'DB_NAME', 'usuario_wp' );
define( 'DB_USER', 'usuario_wpuser' );
define( 'DB_PASSWORD', 'senha-gerada-no-cpanel' );
define( 'DB_HOST', 'localhost' );

No cPanel, banco e usuário recebem o prefixo da conta, algo como usuario_wp. Os nomes acima são exemplo, use os que o painel mostrar. DB_HOST continua localhost na esmagadora maioria dos casos de hospedagem compartilhada.

Agora o ponto que separa a migração limpa da migração que gera chamado uma semana depois: se o domínio não muda, as URLs no banco não mudam. Os campos siteurl e home na tabela wp_options já estão corretos. Não rode busca e substituição. Não use subdomínio temporário do tipo novo.cliente.com.br para testar, porque o WordPress passa a gravar essa URL em cache de plugin, em campo de page builder, em dado serializado, e você vai caçar resquício dela por meses.

Confira os valores com WP-CLI, se o destino tiver:

wp option get siteurl
wp option get home

Se por algum motivo o domínio realmente mudar (uma reestruturação de marca junto com a troca de servidor, por exemplo), a substituição precisa respeitar dados serializados. wp search-replace 'https://antigo.com.br' 'https://novo.com.br' --dry-run mostra o que seria alterado antes de gravar. UPDATE direto no SQL quebra arrays serializados de tema e de page builder, e o estrago aparece só nas páginas montadas visualmente.

Testar o domínio real no servidor novo pelo arquivo hosts

Esta é a etapa que compra o zero indisponibilidade. O arquivo hosts da sua máquina resolve o domínio do cliente para o IP do servidor novo apenas para você. O site inteiro responde no domínio real, com as URLs corretas no banco, sem que nenhum visitante seja afetado.

Pegue o IP compartilhado da conta na tela inicial do cPanel de destino, em informações gerais. Depois edite o arquivo hosts.

Onde fica o arquivo hosts no Windows, no macOS e no Linux

Acrescente uma linha com o IP do destino e todos os nomes que o site usa. O IP abaixo é exemplo, use o real:

203.0.113.10 exemplo.com.br www.exemplo.com.br

Limpe o cache de DNS local:

# Windows
ipconfig /flushdns

# macOS
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

# Linux com systemd-resolved
sudo resolvectl flush-caches

Para conferir pelo terminal sem mexer no hosts, o curl aceita forçar a resolução em uma única requisição:

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

O -k é obrigatório nesse momento: o servidor novo ainda responde com um certificado que não cobre o domínio do cliente, e sem ele o curl aborta na validação de TLS antes de mostrar qualquer cabeçalho. Assim que o certificado definitivo for emitido, repita o comando sem o -k para confirmar a cadeia.

Por que o HTTPS reclama durante o teste por hosts

No teste por hosts, o HTTPS vai reclamar. O certificado do domínio ainda não foi emitido no servidor novo, porque a emissão automática depende do DNS já apontar para lá. Isso é esperado. Teste aceitando o aviso do navegador, e planeje a emissão do certificado como a primeira tarefa depois da virada. Não conclua que "o SSL quebrou na migração": ele ainda não existe nesse servidor.

Nove testes para fazer antes de encostar no DNS

O que Como Sinal de falha
Home e páginas internas Navegar clicando, não digitando URL 404 em página interna indica permalink ou .htaccess
Permalinks Abrir um post e uma categoria Se falhar, salvar novamente em Configurações, Links Permanentes
Login no wp-admin Entrar com conta real Redirecionamento infinito costuma ser URL divergente ou cookie
Upload de mídia Subir uma imagem e apagar Erro de permissão em uploads
Formulário de contato Enviar de verdade E-mail que não sai indica SMTP a reconfigurar
Checkout (se houver loja) Ir até a tela de pagamento em sandbox Callback e URL de retorno do gateway
Busca e feed /?s=teste e /feed/ Erro de banco ou de charset
Sitemap e robots.txt Abrir as duas URLs Regra de reescrita ausente
Erros de PHP Log de erros no cPanel Aviso de função removida na versão de PHP nova

Só avance para o DNS quando essa tabela estiver toda verde. Enquanto o hosts estiver apontado, o cliente continua vendo o site antigo, e você tem todo o tempo do mundo.

A sequência de TTL, de 48 horas antes a 15 dias depois

TTL é o tempo que um resolvedor guarda a resposta antes de perguntar de novo. Se o registro A do domínio está com TTL de 4 horas e você troca o IP agora, parte da internet vai continuar mandando visitante para o servidor antigo pelas próximas 4 horas. Por isso o TTL se reduz antes, nunca no mesmo momento da troca.

Momento Ação
48 a 24 horas antes Baixar o TTL dos registros A, AAAA, CNAME e MX para 300 segundos e não mexer em mais nada
24 horas antes Avisar o cliente do congelamento de conteúdo e concluir os testes por hosts
Hora zero Congelar a escrita no servidor antigo (modo manutenção, ou site em leitura apenas, com checkout e publicação desativados), só então exportar o banco de novo, importar no destino, sincronizar arquivos alterados e trocar o registro A
Hora zero mais 15 minutos Emitir o certificado SSL no servidor novo e conferir o cadeado
Primeiras 24 horas Manter o servidor antigo ligado e idêntico, sem alterar nada nele
72 horas depois Restaurar o TTL para o valor normal, na faixa de 3600 segundos
7 a 15 dias depois Verificar acessos residuais no servidor antigo e só então cancelar

O congelamento de escrita na hora zero é o que impede pedido novo de cair no banco antigo depois do dump final. Para site institucional ele dura o tempo do mysqldump. Para loja, é o preço de não transportar pedido na mão.

A redução de TTL para 300 segundos não acelera nada se feita junto com a troca do IP: o resolvedor que já tem a resposta antiga em cache vai respeitar o TTL anterior. Essa é a razão de ser da antecedência.

Para acompanhar a propagação, consulte resolvedores diferentes:

dig +short exemplo.com.br @1.1.1.1
dig +short exemplo.com.br @8.8.8.8

E confirme para qual IP a sua requisição realmente foi, pedindo ao curl o endereço remoto usado na conexão:

curl -sI -o /dev/null -w '%{remote_ip}\n' https://exemplo.com.br

A saída é um único IP. Se for o IP do servidor novo, aquele caminho já convergiu. Se ainda vier o IP antigo, é cache de DNS no seu resolvedor ou na sua máquina, não erro de configuração. Rode o mesmo comando a partir de outra rede (4G do celular, por exemplo) para ter uma segunda leitura.

O que fazer na hora zero, em ordemCongelar escrita na origemModo manutenção ou leitura apenasExportar banco novamenteDump final sem escrita concorrenteImportar e sincronizar arquivosDelta de uploads e bancoTrocar o registro ATTL já reduzido há diasEmitir certificado SSLPrimeira tarefa depois da viradaManter servidor antigo ligadoSem alterar nada nele
Sequência da hora zero. Inverter qualquer par de caixas é o que produz pedido perdido ou cadeado quebrado.

O e-mail é a parte que machuca na propagação

Site fora do ar por dez minutos o cliente perde. E-mail perdido ele lembra por anos. Durante a propagação, mensagens podem ser entregues no servidor antigo por remetentes cujo DNS ainda não atualizou, enquanto outras chegam no novo. Se o cliente estiver olhando só a caixa nova, vai jurar que sumiram mensagens.

Regras de operação que resolvem quase todos os casos:

Se a zona de DNS continua no mesmo provedor e você só edita o registro A, o e-mail externo nem percebe a mudança. O risco maior está em trocar os servidores de nomes do domínio inteiro no registrador, porque aí todos os registros precisam existir no destino desde o primeiro minuto.

O que fazer depois da virada e quando desligar o servidor antigo

Depois que o registro A aponta para o servidor novo, faça na sequência: emitir o certificado SSL, forçar HTTPS, salvar novamente os links permanentes, limpar o cache do plugin de cache e do CDN, recriar as tarefas cron no painel e testar de novo o formulário de contato com o SMTP de produção. Repita rapidamente a tabela de testes, agora sem o arquivo hosts, e remova a linha que você acrescentou nele. Deixar o hosts apontado é a causa de "na minha máquina está no ar" enquanto o cliente vê outra coisa.

Antes de cancelar o plano antigo, olhe o log de acesso do servidor antigo. Se ainda chega tráfego real, alguém ou algum serviço continua resolvendo o IP velho. Cancelar nesse momento gera erro intermitente que ninguém consegue reproduzir.

A mensagem para avisar o cliente sobre a janela de congelamento

O cliente não precisa entender TTL. Precisa entender que existe uma janela em que ele não deve publicar nada. Uma mensagem que funciona:

Padronize esse texto, a tabela de inventário e a tabela de testes num documento único da agência. A migração deixa de ser um evento de risco e vira tarefa de checklist, executável por qualquer pessoa do time, com a mesma qualidade na quinta migração e na quinquagésima.

Quando o volume de migrações justifica, o passo seguinte é concentrar os sites em ambiente próprio com cPanel, o que muda a conversa de "quanto custa esse plano" para "quanto custa cada site no meu servidor". Aí entram decisões de dimensionamento e de localização do datacenter, que afetam latência para o público brasileiro e são assunto de outro tipo de análise.

Referências

  1. Documentação oficial (cpanel) — How to Migrate a WordPress Installation to a cPanel Server. Consultado em 2026-09-16.
Leia também