Tutoriais de VPS
Migrar WordPress para VPS: backup, DNS e rollback (2026)
Migre um site WordPress preservando URLs: faça backup de arquivos e banco, sincronize escritas finais, teste HTTPS, troque DNS e valide ou reverta sem perder pedidos e uploads.

Uma migração WordPress pode parecer pronta e deixar pedidos recentes no banco antigo ou copiar só parte das imagens e configurações. Este roteiro cobre um site, domínio e URLs preservados, com SSH no servidor antigo e no VPS novo: backup completo, sincronização, testes prévios, troca de DNS e rollback. Sem SSH na hospedagem, exporte pelo painel e mantenha as mesmas verificações. Multisite, mudança de domínio e lojas de alto volume precisam de plano específico.
As instruções WordPress exigem arquivos e banco ao trocar servidor sem mudar URLs. Atualize wp-config.php se mudam credenciais. O XML de Ferramentas → Exportar não é backup completo: confira temas, plugins, uploads, usuários, ajustes e tabelas de plugins.
Guarde a lista fora do servidor, sem senhas em chamados ou conversas:
| Item | Registrar | Risco se esquecer |
|---|---|---|
| URLs | home, siteurl, prefixo www, HTTP/HTTPS | Loops ou conteúdo misto |
| Dados | Nome/prefixo/tamanho do banco e tamanho de wp-content/uploads | Pedidos, comentários ou imagens perdidos |
| Ambiente | PHP/MySQL/MariaDB, extensões e regras Nginx/Apache | Plugins falham ou permalinks retornam 404 |
| Dependências | Objetos, SMTP, pagamentos, webhooks, cron e CDN | Página inicial funciona, negócio falha |
| DNS | A, AAAA, www, proxy e TTL | Visitantes continuam no servidor antigo |
Reserve disco para arquivos, banco, backup temporário e crescimento. Site institucional pequeno pode ser avaliado desde 2 vCPU, 4 GB RAM e 40 GB SSD; imagens/WooCommerce exigem dimensionar por volume e pico. Não são mínimos oficiais. Instale web, PHP-FPM, banco e WP-CLI, verificando plugins/PHP. Exponha 80/443 e SSH com origens restritas; mantenha banco privado. WordPress Docker e Caddy ajuda a preparar outra pilha, mas os exemplos usam PHP-FPM nativo e banco local. Em contêineres, adapte caminhos e docker compose exec.
Exemplos usam origem /var/www/example.com, destino /srv/www/example.com, domínio example.com, IP NEW_IP e usuário SSH deploy. Substitua antes de executar. Confira diretórios, permissões e modo de operação existentes antes de sobrescrever.
No servidor antigo, confira caminho e conexão. wp db export lê wp-config.php e chama mysqldump; WP-CLI aceita opções como --single-transaction. SQL fica no diretório privado do usuário, nunca na raiz web:
wp core is-installed --path=/var/www/example.com
wp option get home --path=/var/www/example.com
wp option get siteurl --path=/var/www/example.com
du -sh /var/www/example.com /var/www/example.com/wp-content/uploads
umask 077
mkdir -p /home/deploy/wp-migration
wp db export /home/deploy/wp-migration/preflight.sql \
--single-transaction --path=/var/www/example.com
test -s /home/deploy/wp-migration/preflight.sql
tar -C /var/www -czf /home/deploy/wp-migration/files-preflight.tar.gz example.com
tar -tzf /home/deploy/wp-migration/files-preflight.tar.gz | head
sha256sum /home/deploy/wp-migration/preflight.sql \
/home/deploy/wp-migration/files-preflight.tar.gz
Copie os dois arquivos e hashes para armazenamento independente e teste extração/restauração. test -s apenas confirma arquivo não vazio. Para pedidos, assinaturas e formulários, identifique processos externos que escrevem e escolha horário tranquilo. E-mail, DNS e registro do domínio normalmente estão fora dos arquivos/banco WordPress: trate separadamente.
No VPS novo, crie diretório e banco vazios sem rodar instalador WordPress. Permita utf8mb4. Troque credenciais; localhost corresponde ao DB_HOST=localhost de wp-config.php. Confirme banco vazio para não sobrescrever outra aplicação.
sudo install -d -o deploy -g www-data -m 2750 /srv/www/example.com
sudo mysql <<'SQL'
CREATE DATABASE wordpress_live CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wordpress_live'@'localhost' IDENTIFIED BY 'REPLACE_WITH_LONG_RANDOM_PASSWORD';
GRANT ALL PRIVILEGES ON wordpress_live.* TO 'wordpress_live'@'localhost';
SQL
Faça pré-cópia pelo servidor antigo para transferir só incrementos na janela final. --no-owner --no-group evita transportar UID/GID antigos. Não se usa --delete, pois caminho errado poderia apagar destino. Repita se existem muitos arquivos. Restrinja o site novo a testadores para impedir escrita antecipada.
rsync -a --no-owner --no-group --exclude='.maintenance' \
/var/www/example.com/ deploy@NEW_IP:/srv/www/example.com/
Confira wp-config.php e altere somente a conexão do banco. Não regenere salts nem substitua domínios no SQL inteiro. Ajuste usuário web e escrita apenas em uploads/caches necessários:
sudo chown -R deploy:www-data /srv/www/example.com
sudo find /srv/www/example.com -type d -exec chmod 755 {} \;
sudo find /srv/www/example.com -type f -exec chmod 644 {} \;
sudo chmod 640 /srv/www/example.com/wp-config.php
sudo find /srv/www/example.com/wp-content/uploads -type d -exec chmod 2775 {} \;
sudo find /srv/www/example.com/wp-content/uploads -type f -exec chmod 664 {} \;
São permissões para site comum. Se plugin usa wp-content/cache ou caminho próprio, conceda escrita caso a caso; evite chmod -R 777. Ajuste raiz, socket FPM e permalinks, valide configuração web e mantenha banco local/rede controlada.
A regra é um banco recebendo escrita por vez. Pare callbacks de pagamento, filas e cron que contornam a página de manutenção; depois habilite manutenção na origem. Os comandos de manutenção não bloqueiam todos os escritores externos.
wp maintenance-mode activate --path=/var/www/example.com
wp maintenance-mode status --path=/var/www/example.com
umask 077
wp db export /home/deploy/wp-migration/final.sql \
--single-transaction --path=/var/www/example.com
test -s /home/deploy/wp-migration/final.sql
rsync -a --no-owner --no-group --exclude='.maintenance' --exclude='wp-config.php' \
/var/www/example.com/ deploy@NEW_IP:/srv/www/example.com/
scp /home/deploy/wp-migration/final.sql \
deploy@NEW_IP:/home/deploy/wp-migration-final.sql
Pare processos de escrita direta antes de exportar. --single-transaction não congela o negócio inteiro nem serve para todo mecanismo de armazenamento. Preserve snapshot completo; não apague banco ou VPS antigo ainda.
No destino, confira wp-config.php antes de importar. wp db import não cria banco automaticamente. Depois mova SQL para backup controlado e limpe cópias temporárias desnecessárias.
chmod 600 /home/deploy/wp-migration-final.sql
wp db import /home/deploy/wp-migration-final.sql --path=/srv/www/example.com
wp db check --path=/srv/www/example.com
wp core is-installed --path=/srv/www/example.com
wp option get home --path=/srv/www/example.com
wp option get siteurl --path=/srv/www/example.com
home e siteurl continuam com valores produtivos. Não substitua URLs se não mudaram. Se domínio, protocolo ou caminho também muda, faça backup do banco novo, confira wp search-replace '旧地址' '新地址' --dry-run --skip-columns=guid e remova --dry-run só para aplicar. Search-replace WP-CLI respeita serialização PHP; SQL REPLACE() pode corrompê-la.
Confira logs PHP, banco, página inicial, posts, imagens, admin e fluxos do negócio. Com certificado válido obtido por DNS-01 ou outro método, teste localmente sem DNS público:
curl -I --resolve example.com:443:NEW_IP https://example.com/
curl -I --resolve example.com:443:NEW_IP https://example.com/wp-login.php
--resolve altera só o destino dessa chamada; TLS valida example.com. Sucesso com curl -k não comprova HTTPS válido. Emita antes por DNS-01 ou preveja janela após a troca. Com CDN/proxy, confira HTTPS da origem e loops em modos como Flexible SSL.
Revise registros com antecedência de pelo menos um TTL antigo. Reduza TTL de A/AAAA DNS-only conforme provedor. Registros com proxy Cloudflare usam 300 segundos automáticos, sem redução manual; caches locais podem durar mais. Confira www, AAAA e origem CDN, além do A.
- Mantenha origem em manutenção; confirme SQL e arquivos incrementais finais no destino.
- Aponte A/AAAA ou origem CDN ao VPS sem mudar MX desnecessariamente.
- Confira várias redes com
dig +short example.com A,dig +short example.com AAAA,curl -I https://example.com/. Com proxy,digretorna IPs CDN: verifique origem no painel. - Valide HTTPS, login, uploads, formulários, pagamentos de teste/pequenos controlados e callbacks. Remova restrições de ensaio e habilite escrita. Pare agendamentos antigos antes de iniciar os novos.
DNS não garante indisponibilidade zero: resolvedores, navegador e CDN mudam em momentos diferentes. Preserve origem pelo menos 48–72 horas. Registre destino de pedidos/pagamentos/assinaturas novos; nunca deixe os dois bancos recebendo transações.
Se falha antes de novas escritas, volte DNS/CDN à origem, desative sua manutenção e confira extensões, regras e permissões. Após novos pedidos, comentários ou uploads, congele destino e exporte banco/arquivos novos. Voltar apenas DNS perderia dados posteriores. Planeje conciliação ou restauração antes de decidir onde retomar.
| Sintoma | Conferir |
|---|---|
| Error establishing a database connection | DB_HOST em wp-config.php, credenciais e serviço |
| Inicial funciona, posts 404 | Regras Nginx/Apache e compatibilidade de .htaccess |
| Imagens/uploads falham | wp-content/uploads completo, permissões e objetos |
| Loop HTTPS | URLs, cabeçalhos repassados, TLS CDN e redirecionamento |
| Plugin retorna 500 | PHP/extensões/logs e wp-content; não exponha erros em produção |
| E-mail/agendamentos falham | SMTP, DNS de e-mail e responsabilidades cron/WP-Cron |
Um 200 não basta. Confira posts/imagens recentes, login/logout, uploads, formulários e pagamentos. Compare contagens e horário do SQL final; observe 24 horas de 4xx/5xx, PHP-FPM e banco. Valide backup externo e restauração antes de desligar origem. Veja migração VPS com baixa interrupção.
Precisa reinstalar WordPress? Não com o mesmo domínio. Prepare ambiente compatível, copie arquivos/banco e atualize conexão.
Basta wp-content? Não: inclua banco, wp-config.php, código próprio, web/cron e dependências externas.
Por que aparece o site antigo? Cache de resolvedor, navegador ou CDN. Confira AAAA e www; preserve manutenção até o tráfego residual acabar.
Trocar URLs no banco inteiro? Só se domínio/protocolo/caminho mudar, com ferramenta compatível com serialização, backup e dry-run.