Base de Conhecimento

Migração de site WordPress: passo a passo seguro

  • migração de site wordpress, wp-cli, wp-config.php, banco de dados, troca de domínio, uploads
  • Usuários acharam útil: 0

Tutorial para migrar um WordPress: o que copiar, três caminhos, a troca de endereço no banco sem quebrar dados serializados e o que conferir no fim.

Por Redação Eleven Host · @robson.direitodigital · Atualizado em 18 de outubro de 2026 · 8 min de leitura

Capa da Eleven Host: janela de terminal com o título migração de site WordPress

Arquivos, banco e troca de endereço com WP-CLI: a migração do WordPress passo a passo. Arte: Eleven Host

Migração de site WordPress é mover os arquivos, o banco de dados e o wp-config.php para o servidor novo e, se o domínio mudar, trocar o endereço salvo no banco. Faça pelo WP-CLI ou à mão e confira login, imagens e formulário antes de apontar o DNS.

WordPress tem um detalhe que sites comuns não têm: o endereço do site fica gravado dentro do banco, inclusive em dados serializados. Por isso, um erro de substituição quebra o site por dentro. Para o conceito de WordPress em si, veja o que é WordPress e para que serve. Este guia cuida do que é específico da migração.

O que você vai mover

Um WordPress tem quatro partes, e esquecer uma delas deixa o site incompleto no destino:

  • wp-content: a pasta com themes (temas), plugins e uploads (imagens e arquivos enviados). É a parte insubstituível.
  • Banco de dados: posts, páginas, usuários, configurações e, numa loja, pedidos e clientes.
  • wp-config.php: o arquivo que diz ao WordPress qual banco usar.
  • Regras do servidor: o .htaccess (em servidores Apache) ou o bloco de configuração do site (em Nginx), que guardam redirecionamentos e links permanentes.

Os arquivos do núcleo do WordPress (as pastas wp-admin e wp-includes) podem ser reinstalados, mas copiá-los junto evita diferença de versão.

Antes de começar

Faça uma cópia completa do site de origem, com o método do guia de backup de site. Depois, anote a versão do PHP (php -v) e do WordPress (wp core version) no servidor atual e confirme que o novo roda a mesma versão de PHP ou uma que seus plugins aceitam. Limpe o cache do site e, se houver CDN, deixe a limpeza preparada para o dia da troca.

Para a parte de DNS, TTL e a técnica de manter os dois servidores no ar, veja o guia para migrar sem tirar o site do ar. Aqui o foco é o WordPress.

Três caminhos para migrar

Manual, com SFTP e exportação do banco

  1. Baixe a pasta do site (inclusive wp-content e wp-config.php) por SFTP.
  2. Exporte o banco pela ferramenta de banco que você usa, ou por linha de comando com mysqldump.
  3. No servidor novo, crie o banco e o usuário e envie os arquivos para a pasta do site.
  4. Importe o arquivo .sql no banco novo.
  5. Edite o wp-config.php (veja a seção seguinte).
  6. Teste pelo arquivo hosts, sem mudar o DNS.

Funciona em qualquer servidor, mas dá trabalho em sites grandes e deixa a conferência por sua conta.

Com WP-CLI

O WP-CLI é a ferramenta de linha de comando do WordPress. Ele lê as credenciais do wp-config.php, então a senha do banco não aparece na linha de comando. Rode como o usuário dono do site; como root, ele exige --allow-root. No servidor de origem, dentro da pasta do site:

wp db export meusite-2026-10-18.sql

Copie o arquivo e a pasta do site para o destino. No servidor novo, com o wp-config.php já ajustado, importe:

wp db import meusite-2026-10-18.sql

Esses comandos dependem do cliente de banco instalado no servidor, porque o WP-CLI usa o mysqldump e o mysql por baixo. Se o domínio vai mudar, o próximo comando é o que separa quem migra com segurança de quem estraga o site, e ele está na seção a seguir.

Com plugin de migração

Existem plugins que empacotam site e banco em um arquivo e o restauram no destino. Pesam a favor a ausência de linha de comando e, em alguns plugins, a troca de endereço embutida (confira se a do seu trata dados serializados). Antes de escolher, confira três coisas na descrição do plugin: o limite de tamanho do arquivo (versões gratuitas podem ter limite: veja na página do plugin), as versões de WordPress e PHP aceitas e se ele leva banco e uploads juntos. Depois de restaurar, faça as mesmas conferências finais deste guia.

Não troque o endereço do site com localizar e substituir em um editor de texto. O WordPress guarda o tamanho de cada texto junto com ele, e a conta deixa de bater.

Domínio novo ou o mesmo domínio

Mesmo domínio: não há o que substituir no banco. Copie, teste pelo hosts e troque o DNS. É o cenário mais simples.

Domínio novo: o banco ainda guarda o endereço antigo em posts, opções e configurações de tema. O comando abaixo troca em todas as tabelas e respeita dados serializados. Rode primeiro em simulação, que só mostra o que mudaria:

wp search-replace 'https://antigo.exemplo.com' 'https://novo.exemplo.com' --all-tables --skip-columns=guid --dry-run

Confira o relatório e rode de novo sem o --dry-run. A opção --skip-columns=guid preserva os identificadores dos posts, que não devem mudar. Se a diferença for só de http para https, o procedimento é o mesmo, com os dois endereços escritos por completo.

Sem WP-CLI, o plugin de migração ou um plugin dedicado a substituir texto no banco faz o mesmo trabalho, desde que trate dados serializados.

Ajustes no wp-config.php

No servidor novo, abra o wp-config.php e confirme estas linhas com os dados do banco novo (valores de exemplo):

define( 'DB_NAME', 'nome_do_banco' );

define( 'DB_USER', 'usuario_do_banco' );

define( 'DB_PASSWORD', 'defina-a-senha-aqui' );

define( 'DB_HOST', 'localhost' );

O DB_HOST é localhost quando o banco roda no mesmo servidor do site; se estiver em outro, use o endereço dele. Confira também o prefixo das tabelas, na linha $table_prefix: ele precisa ser igual ao das tabelas que você importou, senão o WordPress acha que o banco está vazio e oferece uma instalação nova.

Entenda

Três ajustes definem o resultado: o banco importado por inteiro, o wp-config.php apontando para ele e, se o endereço mudou, a troca feita com ferramenta que entende dados serializados.

Vai receber o WordPress em um servidor administrado por você? Ver planos de VPS

Depois da cópia: o que conferir

  1. Links permanentes: no painel do WordPress, abra as configurações de links permanentes e salve de novo, sem mudar nada. Isso regrava as regras de endereço. Pelo terminal, em servidor Apache, wp rewrite flush --hard faz o mesmo (sem o --hard, o arquivo .htaccess não é regravado).
  2. Cache e CDN: limpe o cache do plugin de cache e o da CDN, se houver. Ao testar, versões antigas confundem.
  3. HTTPS: confira os endereços do site em Configurações, no painel (ou com wp option get siteurl e wp option get home) e procure aviso de conteúdo misto no navegador.
  4. Login no painel: entre com um usuário administrador.
  5. Mídia: abra posts antigos e veja se as imagens aparecem.
  6. Formulário: envie uma mensagem de teste.
  7. E-mail do site: use a recuperação de senha de um usuário de teste e confira se a mensagem chega.

Erros que quebram um WordPress migrado

  • Substituir o endereço com editor de texto: dados serializados guardam o número de caracteres de cada texto. Mudar o endereço sem atualizar o número corrompe a opção, e plugins e widgets perdem configurações.
  • Esquecer a pasta uploads: o site abre, mas as imagens dão erro. Compare a contagem de arquivos de wp-content/uploads nos dois lados.
  • PHP diferente: um plugin que funcionava na versão antiga pode dar tela branca na nova.
  • Permissões erradas: o WordPress não consegue gravar. Uma configuração de referência é pastas com 755 e arquivos com 644, com dono igual ao usuário do servidor web (em Debian e Ubuntu, www-data).

Se precisar acertar as permissões, rode dentro da pasta do site. Antes, confira com pwd onde você está: em pasta errada, o comando muda permissões de arquivos que não eram o alvo.

find . -type d -exec chmod 755 {} \;

find . -type f -exec chmod 644 {} \;

Três exemplos

Blog pessoal. Poucas páginas e nenhum pedido. Copie, importe, teste pelo hosts e troque o DNS no mesmo dia.

Loja com WooCommerce. Pare os pedidos durante a troca: pedido feito no servidor antigo depois da exportação não aparece no novo. Faça a exportação final com a loja pausada, troque o DNS e mantenha a loja antiga pausada até o fim da propagação (pode levar de minutos a horas, conforme o TTL e os provedores). Só então reabra a loja no servidor novo. Teste um pedido de ponta a ponta, inclusive o e-mail de confirmação.

Site de agência com vários plugins. Rode wp plugin list nos dois servidores e compare versões. Plugins que dependem de extensão do PHP exigem conferir se ela existe no destino. Para o roteiro geral por datas, veja o passo a passo de migração de site.

Dúvida sobre os serviços da Eleven antes de migrar? Falar com a equipe

Entenda

Em uma VPS, prepare-se para cuidar de atualização, backup e segurança, e confirme com a equipe o que a Eleven faz. Valores da loja em outubro de 2026, para confirmar antes de contratar: Prata (2 vCPU, 8 GB de RAM, 50 GB NVMe) a R$ 34,00/mês. A Eleven faz migração para clientes? O texto do site não diz: pergunte à equipe.

Perguntas frequentes

Posso copiar só o wp-content?

Só se você instalar o WordPress limpo no destino e ainda importar o banco. Sem o banco, ficam de fora posts, páginas e configurações.

Preciso mudar algo no WordPress se o domínio continua o mesmo?

O endereço no banco não muda. Mas confira o wp-config.php, o PHP e os links permanentes.

O site fica fora do ar durante a migração?

Não precisa ficar, desde que você teste o servidor novo antes de trocar o DNS e mantenha o antigo ligado.

Plugin de migração dispensa a conferência final?

Não. Faça as mesmas conferências: login, mídia, formulário e e-mail do site.

Esta resposta lhe foi útil?

Artigos Relacionados