이 블로그 서버에서는 매일 아침 점검 스크립트가 돌면서 플러그인 업데이트가 있는지 확인합니다. 11월 초에 Jetpack 16.3.1 → 16.4, 다음 날 WP Fastest Cache 1.5.4 → 1.5.5 업데이트가 떴는데, 관리자 화면의 “지금 업데이트” 버튼 대신 서버에서 직접 업데이트했습니다.
이 글은 그때 실제로 실행한 명령과 결과를 그대로 정리한 것입니다. 핵심은 세 가지입니다.
- 받은 파일이 워드프레스 공식 배포본과 똑같은지 체크섬으로 확인하고
- 바꾸기 전에 기존 플러그인을 통째로 백업하고
- 문제가 생기면 바로 되돌릴 수 있게 교체합니다.
테스트 환경: Ubuntu 24.04, nginx, PHP 8.3-FPM, WordPress 7.1
왜 수동으로 업데이트했나
- 관리자 화면에 로그인하지 않고 서버 작업만으로 끝낼 수 있습니다.
- 설치 전에 파일 하나하나가 공식 배포본과 같은지 확인할 수 있습니다. 대시보드 업데이트는 이 과정을 보여 주지 않습니다.
- 이전 버전 백업이 내 손에 남습니다. 업데이트 후 사이트가 깨지면 바로 되돌릴 수 있습니다.
1단계: 새 버전 받기
워드프레스 공식 플러그인은 https://downloads.wordpress.org/plugin/슬러그.버전.zip 주소로 받을 수 있습니다. 슬러그는 플러그인 폴더 이름(예: wp-fastest-cache)입니다.
mkdir -p /tmp/plugin-update && cd /tmp/plugin-update
curl -sfL -o p.zip https://downloads.wordpress.org/plugin/wp-fastest-cache.1.5.5.zip
Jetpack 16.4 zip은 33,067,984바이트(약 32MB)였습니다.
압축은 보통 unzip으로 풀지만, 제 서버에는 설치돼 있지 않았습니다.
$ unzip -q jetpack.zip -d x
/bin/bash: line 11: unzip: command not found
sudo apt install unzip으로 설치해도 되고, 파이썬만 있으면 설치 없이 풀 수 있습니다.
python3 -c "import zipfile,sys; zipfile.ZipFile(sys.argv[1]).extractall(sys.argv[2])" p.zip x
grep -m1 "Version:" x/wp-fastest-cache/wpFastestCache.php
Version: 1.5.5
2단계: 체크섬으로 공식 배포본인지 확인
워드프레스는 플러그인 버전마다 모든 파일의 해시값 목록을 공개합니다.
curl -sf -o sums.json https://downloads.wordpress.org/plugin-checksums/wp-fastest-cache/1.5.5.json
받아 보면 이런 구조입니다. files 안에 파일 176개의 md5와 sha256이 들어 있습니다.
{"plugin": "wp-fastest-cache", "version": "1.5.5",
"source": "https://plugins.svn.wordpress.org/wp-fastest-cache/tags/1.5.5/",
"files": { ...176개... } }
"wpFastestCache.php": {"md5": "c3d2334bf5930019c7d9229adc75bdf1",
"sha256": "12d84134e59c825c1004291429cee8aad8cb9dd955c6ea63d7c5a76202e6d047"}
이 목록과 압축을 푼 파일을 하나씩 비교하는 짧은 스크립트입니다.
python3 - wp-fastest-cache <<'EOF'
import json, hashlib, os, sys
slug = sys.argv[1]
s = json.load(open("sums.json"))["files"]
bad = []
for f, h in s.items():
p = f"x/{slug}/{f}"
hs = h["sha256"]; hs = [hs] if isinstance(hs, str) else hs # 값이 목록인 경우도 있음
if not os.path.exists(p) or hashlib.sha256(open(p, "rb").read()).hexdigest() not in hs:
bad.append(f)
print("checked", len(s), "bad", len(bad), bad[:5])
EOF
실제 결과입니다. 두 플러그인 모두 틀린 파일이 0개였습니다.
# WP Fastest Cache 1.5.5
checked 176 bad 0 []
# Jetpack 16.4
checked 4296 bad 0 []
Jetpack은 파일이 4,296개나 되지만 검사는 몇 초면 끝났습니다.
실수담: 압축을 안 풀고 검사하면
처음 Jetpack을 할 때는 unzip이 없다는 걸 모르고 검사까지 한 번에 돌렸습니다. 결과가 이랬습니다.
checked 0 mismatch/missing 4296
압축이 안 풀려서 파일이 하나도 없으니 4,296개 전부가 “없음”으로 나온 겁니다. 이런 결과를 보면 놀라지 말고 먼저 압축이 제대로 풀렸는지 확인하세요. 거꾸로, 검사 스크립트를 “없는 파일은 건너뛰기”로 짜면 아무것도 검사하지 않고 통과할 수 있으니, 없는 파일도 실패로 세는 게 안전합니다.
3단계: 기존 플러그인 백업
P=/var/www/wordpress/wp-content/plugins
sudo tar -czf ~/backups/wp-fastest-cache-1.5.4_$(date +%F).tar.gz -C $P wp-fastest-cache
ls -l ~/backups/wp-fastest-cache-1.5.4_*.tar.gz
-rw-r--r-- 1 root root 1557479 Nov 5 23:27 /home/.../backups/wp-fastest-cache-1.5.4_2026-11-05.tar.gz
파일 이름에 이전 버전 번호와 날짜를 넣어 두면 나중에 무엇을 되돌릴지 헷갈리지 않습니다. 백업 크기는 WP Fastest Cache가 약 1.5MB, Jetpack이 약 27MB(27,806,951바이트)였습니다.
-C $P를 줘서 wp-fastest-cache/ 폴더 기준으로 묶었기 때문에, 되돌릴 때 같은 위치에 그대로 풀면 됩니다.
$ tar -tzf wp-fastest-cache-1.5.4_2026-11-05.tar.gz | head -3
wp-fastest-cache/
wp-fastest-cache/uninstall.php
wp-fastest-cache/readme.txt
4단계: 폴더 이름 바꾸기로 교체
기존 폴더 위에 새 파일을 덮어쓰면, 새 버전에서 삭제된 파일이 그대로 남는 문제가 생깁니다. 그래서 새 폴더를 옆에 준비한 뒤 이름만 바꿔서 한 번에 교체했습니다.
sudo cp -a x/wp-fastest-cache $P/wp-fastest-cache.new
sudo chown -R www-data:www-data $P/wp-fastest-cache.new # 웹서버 사용자에 맞춤
sudo mv $P/wp-fastest-cache $P/.wpfc.old # 기존 것 치우고
sudo mv $P/wp-fastest-cache.new $P/wp-fastest-cache # 새 것 넣기
sudo grep -m1 "Version:" $P/wp-fastest-cache/wpFastestCache.php
Version: 1.5.5
mv는 같은 디스크 안에서는 이름만 바꾸는 작업이라 거의 즉시 끝납니다. 파일이 반쯤 복사된 상태로 방문자가 들어올 틈이 거의 없습니다.chown을 빠뜨리면 플러그인이 캐시 파일을 못 쓰거나, 다음 업데이트를 관리자 화면에서 못 하게 될 수 있습니다. 우분투의 nginx/PHP-FPM 기본 사용자는www-data입니다.- 이전 폴더 이름을 점(.)으로 시작하게 바꾼 이유는, 플러그인 폴더에 그대로 두면 워드프레스가 같은 플러그인이 두 개 있다고 인식할 수 있기 때문입니다. 확인이 끝나면 지웁니다.
5단계: 사이트가 살아 있는지 확인
교체 직후 주요 주소의 응답 코드와 시간을 확인했습니다. WP Fastest Cache는 캐시 플러그인이라 캐시를 비우고 확인했습니다.
B=https://내블로그주소
for p in / / "/?nc=$RANDOM" /wp-login.php /wp-admin/ /wp-json/; do
printf "%-18s %sn" "$p" "$(curl -sk -o /dev/null -w '%{http_code} %{time_total}s' "$B$p")"
done
/ 200 0.163773s
/ 200 0.021416s
/?nc=23545 200 0.130764s
/wp-login.php 200 0.071933s
/wp-admin/ 302 0.146183s
/wp-json/ 200 0.111286s
- 홈을 두 번 부른 이유는 캐시 확인용입니다. 첫 번째(0.16초)에 캐시가 새로 만들어지고, 두 번째는 0.02초로 캐시에서 나왔습니다. 캐시 플러그인이 정상 동작한다는 뜻입니다.
/wp-admin/의 302는 로그인 화면으로 보내는 정상 응답입니다.- 페이지 맨 아래 주석에서도 캐시가 새 버전으로 만들어진 걸 확인할 수 있었습니다.
$ curl -sk "$B/" | tail -c 300 | grep -o "WP Fastest Cache[^>]*"
WP Fastest Cache file was created in 0.144 seconds, on 2026년 11월 06일 @ 8:27 am --
Jetpack은 Jetpack 연결 상태 API까지 확인했습니다.
/ 200 91596B
/wp-login.php 200 8168B
/wp-json/ 200 588977B
/wp-json/jetpack/v4/connection 200 236B
마지막으로 nginx 오류 로그에 PHP Fatal error가 없는지 보고, 이상이 없으면 이전 폴더를 지웁니다.
sudo tail -n 20 /var/log/nginx/error.log | grep -iE "fatal|php"
sudo rm -rf $P/.wpfc.old
주의: “치명적” 검색은 엉뚱하게 걸릴 수 있다
업데이트 직후 홈페이지 HTML에서 오류 문구를 찾으려고 grep -ciE "fatal error|critical error|치명적"을 돌렸더니 1건이 걸렸습니다. 열어 보니 오류가 아니라, 홈에 걸린 보안 소식 글 요약에 들어 있던 “치명적인 결함”이라는 단어였습니다. 한국어 블로그라면 이런 일반 단어는 빼고 Fatal error, Parse error 같은 PHP 오류 문구와 응답 코드로 판단하는 게 정확합니다.
롤백: 문제가 생기면 되돌리기
업데이트 뒤 화면이 깨지거나 500 오류가 나면, 백업을 원래 자리에 풀면 됩니다.
P=/var/www/wordpress/wp-content/plugins
sudo mv $P/wp-fastest-cache $P/.wpfc.broken
sudo tar -xzf ~/backups/wp-fastest-cache-1.5.4_2026-11-05.tar.gz -C $P
sudo chown -R www-data:www-data $P/wp-fastest-cache
sudo grep -m1 "Version:" $P/wp-fastest-cache/wpFastestCache.php # 1.5.4로 돌아왔는지 확인
이번 두 번의 업데이트는 문제가 없어서 롤백을 실제로 하지는 않았습니다. 관리자 화면조차 안 열릴 정도로 깨졌다면, 우선 해당 플러그인 폴더 이름만 바꿔도 워드프레스가 그 플러그인을 비활성화 상태로 취급해서 사이트가 다시 열립니다.
정리: 한 번에 보는 순서
- 받기:
downloads.wordpress.org/plugin/슬러그.버전.zip - 검증:
plugin-checksums/슬러그/버전.json과 sha256 비교 → bad 0 확인 - 백업:
tar -czf 슬러그-이전버전_날짜.tar.gz - 교체: 새 폴더 준비 → chown → mv로 이름 바꾸기
- 확인: 응답 코드, 캐시, 오류 로그 → 이상 없으면 이전 폴더 삭제
이 업데이트 알림은 매일 아침 돌아가는 점검 스크립트가 잡아 줬습니다. 그 설정은 systemd timer로 매일 작업 돌리기에 정리했습니다.