WordPress 图片同步 OSS 完整教程:ossutil 增量同步,解决缩略图 NoSuchKey

WordPress 站点接 OSS 之后,最常见的故障不是「图片打不开」,而是图片在本地有、在 OSS 上没有。

典型表现:媒体库里缩略图是裂的,访问返回 NoSuchKey,但服务器上确实躺着那个文件。

原因很简单:生成缩略图是本地行为,OSS 不会自动同步。下面这套流程,能把本地新增的图片一次性补齐。

一、先确认差多少

# 本地图片总数
find /www/wwwroot/你的站点/wp-content/uploads -type f | wc -l

# 按年月看分布
du -sh /www/wwwroot/你的站点/wp-content/uploads/*/* 2>/dev/null | tail -12

二、装 ossutil

cd /root
wget -q https://gosspublic.alicdn.com/ossutil/1.7.18/ossutil64.zip
unzip -o ossutil64.zip
chmod +x ossutil64

# 配置(建议用子账号,权限只给目标 Bucket)
./ossutil64 config
# endpoint: oss-cn-shenzhen.aliyuncs.com
# accessKeyID / accessKeySecret

三、增量同步(关键)

./ossutil64 sync \
  /www/wwwroot/你的站点/wp-content/uploads/ \
  oss://你的bucket/wp-content/uploads/ \
  --update

参数说明:

  • --update:只同步比 OSS 更新的文件,已存在且没变的跳过
  • 绝对不要加 --delete:本地没有的会被从 OSS 删掉,一次误操作就是灾难

四、放后台跑

图片多的时候同步很慢,别让它卡住终端:

nohup /root/ossutil64 sync \
  /www/wwwroot/你的站点/wp-content/uploads/ \
  oss://你的bucket/wp-content/uploads/ \
  --update > /tmp/oss_sync.log 2>&1 &

# 看进度
tail -f /tmp/oss_sync.log

五、验证

# 抽查一张缩略图
./ossutil64 ls oss://你的bucket/wp-content/uploads/2026/11/ | grep 150x150 | head

# 或者直接访问
curl -s -o /dev/null -w "%{http_code}" "https://你的CDN域名/wp-content/uploads/2026/11/xxx-150x150.png"

六、设成定时任务

宝塔 → 计划任务 → Shell 脚本,每 30 分钟跑一次:

#!/bin/bash
/root/ossutil64 sync \
  /www/wwwroot/你的站点/wp-content/uploads/ \
  oss://你的bucket/wp-content/uploads/ \
  --update >> /tmp/oss_sync.log 2>&1

三个必须注意的坑

  1. CDN 缓存了旧的 404。文件同步上去了,但 CDN 还返回 404 —— 去 CDN 控制台刷新那个 URL,或者加随机参数测试。
  2. 目录权限。ossutil 用 root 跑没问题,但如果站点文件属于 www 用户,同步时读权限要够。
  3. AccessKey 泄露风险。配置存在 ~/.ossutilconfig,别把它提交到 Git,也别放在网站根目录下。

小结

「本地有、OSS 没有」这个问题,本质是把「本地存储」和「对象存储」当成了一回事。WordPress 不知道 OSS 的存在,缩略图生成也不会通知 OSS。

所以必须有一条独立的同步链路,定期把本地新增的东西推上去。上面这套流程,跑通一次之后就是自动的。

© 版权声明
THE END
喜欢就支持一下吧
点赞20 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容