# 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.

> 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.

João Rizzon · 2026-09-17 · WordPress

---

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](https://docs.cpanel.net/knowledge-base/transfers-and-restores/how-to-migrate-a-wordpress-installation-to-a-cpanel-server/), 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.

## 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:

```bash
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:

```bash
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:

```bash
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:

```php
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:

```bash
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

- Windows: `C:\Windows\System32\drivers\etc\hosts`, editado com o bloco de notas aberto como administrador
- macOS e Linux: `/etc/hosts`, com `sudo`

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:

```bash
# 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:

```bash
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:

```bash
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:

```bash
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 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:

- Crie todas as contas de e-mail no servidor novo **antes** da virada, com as mesmas senhas ou com senhas já entregues ao cliente.
- Copie o conteúdo das caixas antigas para as novas antes do corte, por IMAP, com um cliente configurado nas duas contas ao mesmo tempo, arrastando pastas. Depois da virada, repita o processo apenas para o que chegou no meio do caminho.
- Mantenha a conta antiga ativa e acessível por pelo menos uma semana, usando o servidor de entrada pelo hostname direto do provedor antigo e não pelo domínio.
- Se o e-mail estiver em serviço externo, Google Workspace ou similar, os registros MX, SPF, DKIM e DMARC precisam ser recriados na zona nova **antes** de trocar a delegação. Trocar o registro A do site sem recriar o MX equivale a cortar o e-mail da empresa inteira.
- Ainda com MX externo, abra Email Routing no cPanel de destino e marque **Remote Mail Exchanger**. Com a opção automática ou local, o servidor entrega no próprio Exim qualquer mensagem endereçada ao domínio, e o e-mail do formulário de contato para `contato@cliente.com.br` desaparece numa caixa local que ninguém abre. Valide enviando um formulário para um endereço do próprio domínio e conferindo a chegada no Workspace, não no webmail do cPanel.
- Peça ao cliente para não esvaziar a caixa antiga durante a semana de transição.

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:

> **** Vamos transferir o site para a nova hospedagem na [data], às [hora]. O site continuará no ar durante todo o processo, ninguém que acessar vai ver qualquer erro. O único pedido é que ninguém publique posts, edite páginas ou cadastre produtos entre [hora de início] e [confirmação nossa no dia seguinte], porque alterações feitas nessa janela podem não ser transferidas. O e-mail continua funcionando normalmente. Nos primeiros dias, mantenha também a caixa antiga aberta no seu celular ou computador: algumas mensagens podem chegar lá enquanto a mudança se espalha pela internet, e isso é normal.

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.

