워드프레스 서버 이전 체크리스트로 마이그레이션 실수와 다운타임을 줄입니다

워드프레스 서버 이전 마이그레이션 체크리스트가 필요했던 건 병원 사이트를 공유호스팅에서 VPS로 이전할 때 wp-config.php의 DB 정보를 업데이트했는데도 사이트가 흰 화면만 나왔고, 알고 보니 DB 안에 저장된 URL이 이전 도메인 그대로였기 때문입니다. URL 불일치는 워드프레스 이전 실수 중 가장 흔한 원인입니다.

이전 전 준비

# 1. 현재 서버에서 전체 백업
# 파일 백업
tar -czf /tmp/wp-backup-$(date +%Y%m%d).tar.gz /var/www/html/

# DB 백업
mysqldump --defaults-file=/root/.my.cnf hospital_wp | gzip > /tmp/wp-db-$(date +%Y%m%d).sql.gz

# 2. 현재 사이트 URL 확인
mysql -u root -p -e "SELECT option_value FROM hospital_wp.wp_options WHERE option_name IN ('siteurl','home');"

새 서버로 이전

# 3. 파일 복사 (rsync 이용)
rsync -avz /tmp/wp-backup-*.tar.gz user@새서버:/tmp/

# 4. 새 서버에서 압축 해제
ssh user@새서버
tar -xzf /tmp/wp-backup-*.tar.gz -C /var/www/html/ --strip-components=3

# 5. DB 복원
zcat /tmp/wp-db-*.sql.gz | mysql -u root -p 새DB명

# 6. wp-config.php 수정
sudo nano /var/www/html/wp-config.php
# DB_NAME, DB_USER, DB_PASSWORD, DB_HOST 업데이트

URL 업데이트 (핵심)

# 7. DB 내부 URL 교체 (WP-CLI 이용)
wp search-replace '구도메인.com' '신도메인.com' \
    --all-tables \
    --path=/var/www/html \
    --allow-root

# 확인
wp option get siteurl --path=/var/www/html --allow-root
wp option get home --path=/var/www/html --allow-root

# 8. 캐시 및 퍼마링크 초기화
wp cache flush --path=/var/www/html --allow-root
wp rewrite flush --path=/var/www/html --allow-root

이전 후 확인

# DNS 전환 전 hosts 파일로 미리 확인
# Windows: C:\Windows\System32\drivers\etc\hosts
# 192.168.1.1 신도메인.com

# 사이트 접속 확인
curl -I https://신도메인.com

# SSL 인증서 발급
sudo certbot --nginx -d 신도메인.com

URL 교체는 wp search-replace로 직렬화된 PHP 데이터까지 자동으로 처리해줍니다. 수동으로 SQL UPDATE하면 직렬화 데이터의 문자열 길이가 맞지 않아 오류가 생기므로 반드시 WP-CLI를 사용하세요.