<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>플러그인 수동 업데이트 Archives - pigletstory 블로그</title>
	<atom:link href="https://pigletstory.co.kr/tag/%ed%94%8c%eb%9f%ac%ea%b7%b8%ec%9d%b8-%ec%88%98%eb%8f%99-%ec%97%85%eb%8d%b0%ec%9d%b4%ed%8a%b8/feed/" rel="self" type="application/rss+xml" />
	<link></link>
	<description>pigletstory</description>
	<lastBuildDate>Tue, 30 Nov -001 00:00:00 +0000</lastBuildDate>
	<language>ko-KR</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.5</generator>
<site xmlns="com-wordpress:feed-additions:1">221109878</site>	<item>
		<title>워드프레스 플러그인 수동 업데이트: 체크섬 검증, 백업, 롤백까지 (실제 기록)</title>
		<link>https://pigletstory.co.kr/2679/</link>
					<comments>https://pigletstory.co.kr/2679/#respond</comments>
		
		<dc:creator><![CDATA[]]></dc:creator>
		<pubDate></pubDate>
				<category><![CDATA[IT 정보]]></category>
		<category><![CDATA[Linux]]></category>
		<category><![CDATA[Jetpack]]></category>
		<category><![CDATA[sha256]]></category>
		<category><![CDATA[WP Fastest Cache]]></category>
		<category><![CDATA[워드프레스 롤백]]></category>
		<category><![CDATA[워드프레스 플러그인 업데이트]]></category>
		<category><![CDATA[체크섬]]></category>
		<category><![CDATA[플러그인 수동 업데이트]]></category>
		<guid isPermaLink="false">https://pigletstory.co.kr/?p=2679</guid>

					<description><![CDATA[<p>이 블로그 서버에서는 매일 아침 점검 스크립트가 돌면서 플러그인 업데이트가 있는지 확인합니다. 11월 초에 Jetpack 16.3.1 → 16.4, 다음 날 WP Fastest Cache 1.5.4 → 1.5.5 업데이트가 떴는데, 관리자 화면의 &#8220;지금 업데이트&#8221; 버튼 대신 서버에서 직접 업데이트했습니다. 이 글은 그때 실제로 실행한 명령과 결과를 그대로 정리한 것입니다. 핵심은 세 가지입니다. 받은 파일이 워드프레스 공식 배포본과 ... <a title="워드프레스 플러그인 수동 업데이트: 체크섬 검증, 백업, 롤백까지 (실제 기록)" class="read-more" href="https://pigletstory.co.kr/2679/" aria-label="워드프레스 플러그인 수동 업데이트: 체크섬 검증, 백업, 롤백까지 (실제 기록)에 대해 더 자세히 알아보세요">더 읽기</a></p>
<p>The post <a href="https://pigletstory.co.kr/2679/">워드프레스 플러그인 수동 업데이트: 체크섬 검증, 백업, 롤백까지 (실제 기록)</a> appeared first on <a href="https://pigletstory.co.kr">pigletstory 블로그</a>.</p>
]]></description>
										<content:encoded><![CDATA[<p>이 블로그 서버에서는 매일 아침 점검 스크립트가 돌면서 플러그인 업데이트가 있는지 확인합니다. 11월 초에 <strong>Jetpack 16.3.1 → 16.4</strong>, 다음 날 <strong>WP Fastest Cache 1.5.4 → 1.5.5</strong> 업데이트가 떴는데, 관리자 화면의 &#8220;지금 업데이트&#8221; 버튼 대신 <strong>서버에서 직접</strong> 업데이트했습니다.</p>
<p>이 글은 그때 실제로 실행한 명령과 결과를 그대로 정리한 것입니다. 핵심은 세 가지입니다.</p>
<ol>
<li>받은 파일이 <strong>워드프레스 공식 배포본과 똑같은지 체크섬으로 확인</strong>하고</li>
<li>바꾸기 전에 <strong>기존 플러그인을 통째로 백업</strong>하고</li>
<li>문제가 생기면 <strong>바로 되돌릴 수 있게</strong> 교체합니다.</li>
</ol>
<p>테스트 환경: Ubuntu 24.04, nginx, PHP 8.3-FPM, WordPress 7.1</p>
<h2>왜 수동으로 업데이트했나</h2>
<ul>
<li><strong>관리자 화면에 로그인하지 않고</strong> 서버 작업만으로 끝낼 수 있습니다.</li>
<li>설치 전에 <strong>파일 하나하나가 공식 배포본과 같은지</strong> 확인할 수 있습니다. 대시보드 업데이트는 이 과정을 보여 주지 않습니다.</li>
<li>이전 버전 백업이 <strong>내 손에 남습니다.</strong> 업데이트 후 사이트가 깨지면 바로 되돌릴 수 있습니다.</li>
</ul>
<h2>1단계: 새 버전 받기</h2>
<p>워드프레스 공식 플러그인은 <code>https://downloads.wordpress.org/plugin/슬러그.버전.zip</code> 주소로 받을 수 있습니다. 슬러그는 플러그인 폴더 이름(예: <code>wp-fastest-cache</code>)입니다.</p>
<pre><code>mkdir -p /tmp/plugin-update &amp;&amp; cd /tmp/plugin-update
curl -sfL -o p.zip https://downloads.wordpress.org/plugin/wp-fastest-cache.1.5.5.zip</code></pre>
<p>Jetpack 16.4 zip은 33,067,984바이트(약 32MB)였습니다.</p>
<p>압축은 보통 <code>unzip</code>으로 풀지만, 제 서버에는 설치돼 있지 않았습니다.</p>
<pre><code>$ unzip -q jetpack.zip -d x
/bin/bash: line 11: unzip: command not found</code></pre>
<p><code>sudo apt install unzip</code>으로 설치해도 되고, 파이썬만 있으면 설치 없이 풀 수 있습니다.</p>
<pre><code>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</code></pre>
<pre><code>Version: 1.5.5</code></pre>
<h2>2단계: 체크섬으로 공식 배포본인지 확인</h2>
<p>워드프레스는 플러그인 버전마다 <strong>모든 파일의 해시값 목록</strong>을 공개합니다.</p>
<pre><code>curl -sf -o sums.json https://downloads.wordpress.org/plugin-checksums/wp-fastest-cache/1.5.5.json</code></pre>
<p>받아 보면 이런 구조입니다. <code>files</code> 안에 파일 176개의 md5와 sha256이 들어 있습니다.</p>
<pre><code>{"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"}</code></pre>
<p>이 목록과 압축을 푼 파일을 하나씩 비교하는 짧은 스크립트입니다.</p>
<pre><code>python3 - wp-fastest-cache &lt;&lt;'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</code></pre>
<p>실제 결과입니다. 두 플러그인 모두 <strong>틀린 파일이 0개</strong>였습니다.</p>
<pre><code># WP Fastest Cache 1.5.5
checked 176 bad 0 []

# Jetpack 16.4
checked 4296 bad 0 []</code></pre>
<p>Jetpack은 파일이 4,296개나 되지만 검사는 몇 초면 끝났습니다.</p>
<h3>실수담: 압축을 안 풀고 검사하면</h3>
<p>처음 Jetpack을 할 때는 unzip이 없다는 걸 모르고 검사까지 한 번에 돌렸습니다. 결과가 이랬습니다.</p>
<pre><code>checked 0 mismatch/missing 4296</code></pre>
<p>압축이 안 풀려서 파일이 하나도 없으니 <strong>4,296개 전부가 &#8220;없음&#8221;</strong>으로 나온 겁니다. 이런 결과를 보면 놀라지 말고 먼저 압축이 제대로 풀렸는지 확인하세요. 거꾸로, 검사 스크립트를 &#8220;없는 파일은 건너뛰기&#8221;로 짜면 <strong>아무것도 검사하지 않고 통과</strong>할 수 있으니, 없는 파일도 실패로 세는 게 안전합니다.</p>
<h2>3단계: 기존 플러그인 백업</h2>
<pre><code>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</code></pre>
<pre><code>-rw-r--r-- 1 root root 1557479 Nov  5 23:27 /home/.../backups/wp-fastest-cache-1.5.4_2026-11-05.tar.gz</code></pre>
<p>파일 이름에 <strong>이전 버전 번호와 날짜</strong>를 넣어 두면 나중에 무엇을 되돌릴지 헷갈리지 않습니다. 백업 크기는 WP Fastest Cache가 약 1.5MB, Jetpack이 약 27MB(27,806,951바이트)였습니다.</p>
<p><code>-C $P</code>를 줘서 <code>wp-fastest-cache/</code> 폴더 기준으로 묶었기 때문에, 되돌릴 때 같은 위치에 그대로 풀면 됩니다.</p>
<pre><code>$ 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</code></pre>
<h2>4단계: 폴더 이름 바꾸기로 교체</h2>
<p>기존 폴더 위에 새 파일을 덮어쓰면, 새 버전에서 <strong>삭제된 파일이 그대로 남는</strong> 문제가 생깁니다. 그래서 새 폴더를 옆에 준비한 뒤 <strong>이름만 바꿔서</strong> 한 번에 교체했습니다.</p>
<pre><code>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</code></pre>
<pre><code>Version: 1.5.5</code></pre>
<ul>
<li><code>mv</code>는 같은 디스크 안에서는 이름만 바꾸는 작업이라 거의 즉시 끝납니다. 파일이 반쯤 복사된 상태로 방문자가 들어올 틈이 거의 없습니다.</li>
<li><code>chown</code>을 빠뜨리면 플러그인이 캐시 파일을 못 쓰거나, 다음 업데이트를 관리자 화면에서 못 하게 될 수 있습니다. 우분투의 nginx/PHP-FPM 기본 사용자는 <code>www-data</code>입니다.</li>
<li>이전 폴더 이름을 <strong>점(.)으로 시작</strong>하게 바꾼 이유는, 플러그인 폴더에 그대로 두면 워드프레스가 같은 플러그인이 두 개 있다고 인식할 수 있기 때문입니다. 확인이 끝나면 지웁니다.</li>
</ul>
<h2>5단계: 사이트가 살아 있는지 확인</h2>
<p>교체 직후 주요 주소의 응답 코드와 시간을 확인했습니다. WP Fastest Cache는 캐시 플러그인이라 캐시를 비우고 확인했습니다.</p>
<pre><code>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</code></pre>
<pre><code>/                  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</code></pre>
<ul>
<li>홈을 두 번 부른 이유는 캐시 확인용입니다. 첫 번째(0.16초)에 캐시가 새로 만들어지고, <strong>두 번째는 0.02초</strong>로 캐시에서 나왔습니다. 캐시 플러그인이 정상 동작한다는 뜻입니다.</li>
<li><code>/wp-admin/</code>의 302는 로그인 화면으로 보내는 정상 응답입니다.</li>
<li>페이지 맨 아래 주석에서도 캐시가 새 버전으로 만들어진 걸 확인할 수 있었습니다.</li>
</ul>
<pre><code>$ curl -sk "$B/" | tail -c 300 | grep -o "WP Fastest Cache[^&gt;]*"
WP Fastest Cache file was created in 0.144 seconds, on 2026년 11월 06일 @ 8:27 am --</code></pre>
<p>Jetpack은 Jetpack 연결 상태 API까지 확인했습니다.</p>
<pre><code>/                                   200 91596B
/wp-login.php                       200 8168B
/wp-json/                           200 588977B
/wp-json/jetpack/v4/connection      200 236B</code></pre>
<p>마지막으로 nginx 오류 로그에 PHP <code>Fatal error</code>가 없는지 보고, 이상이 없으면 이전 폴더를 지웁니다.</p>
<pre><code>sudo tail -n 20 /var/log/nginx/error.log | grep -iE "fatal|php"
sudo rm -rf $P/.wpfc.old</code></pre>
<h3>주의: &#8220;치명적&#8221; 검색은 엉뚱하게 걸릴 수 있다</h3>
<p>업데이트 직후 홈페이지 HTML에서 오류 문구를 찾으려고 <code>grep -ciE "fatal error|critical error|치명적"</code>을 돌렸더니 <strong>1건이 걸렸습니다.</strong> 열어 보니 오류가 아니라, 홈에 걸린 보안 소식 글 요약에 들어 있던 &#8220;치명적인 결함&#8221;이라는 단어였습니다. 한국어 블로그라면 이런 일반 단어는 빼고 <code>Fatal error</code>, <code>Parse error</code> 같은 PHP 오류 문구와 응답 코드로 판단하는 게 정확합니다.</p>
<h2>롤백: 문제가 생기면 되돌리기</h2>
<p>업데이트 뒤 화면이 깨지거나 500 오류가 나면, 백업을 원래 자리에 풀면 됩니다.</p>
<pre><code>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로 돌아왔는지 확인</code></pre>
<p>이번 두 번의 업데이트는 문제가 없어서 롤백을 실제로 하지는 않았습니다. 관리자 화면조차 안 열릴 정도로 깨졌다면, 우선 해당 플러그인 폴더 이름만 바꿔도 워드프레스가 그 플러그인을 비활성화 상태로 취급해서 사이트가 다시 열립니다.</p>
<h2>정리: 한 번에 보는 순서</h2>
<ol>
<li><strong>받기</strong>: <code>downloads.wordpress.org/plugin/슬러그.버전.zip</code></li>
<li><strong>검증</strong>: <code>plugin-checksums/슬러그/버전.json</code>과 sha256 비교 → bad 0 확인</li>
<li><strong>백업</strong>: <code>tar -czf 슬러그-이전버전_날짜.tar.gz</code></li>
<li><strong>교체</strong>: 새 폴더 준비 → chown → mv로 이름 바꾸기</li>
<li><strong>확인</strong>: 응답 코드, 캐시, 오류 로그 → 이상 없으면 이전 폴더 삭제</li>
</ol>
<p>이 업데이트 알림은 매일 아침 돌아가는 점검 스크립트가 잡아 줬습니다. 그 설정은 <a href="https://pigletstory.co.kr/2676/">systemd timer로 매일 작업 돌리기</a>에 정리했습니다.</p>
<p>The post <a href="https://pigletstory.co.kr/2679/">워드프레스 플러그인 수동 업데이트: 체크섬 검증, 백업, 롤백까지 (실제 기록)</a> appeared first on <a href="https://pigletstory.co.kr">pigletstory 블로그</a>.</p>
]]></content:encoded>
					
					<wfw:commentRss>https://pigletstory.co.kr/2679/feed/</wfw:commentRss>
			<slash:comments>0</slash:comments>
		
		
		<post-id xmlns="com-wordpress:feed-additions:1">2679</post-id>	</item>
	</channel>
</rss>
