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
三个必须注意的坑
- CDN 缓存了旧的 404。文件同步上去了,但 CDN 还返回 404 —— 去 CDN 控制台刷新那个 URL,或者加随机参数测试。
- 目录权限。ossutil 用 root 跑没问题,但如果站点文件属于 www 用户,同步时读权限要够。
- AccessKey 泄露风险。配置存在
~/.ossutilconfig,别把它提交到 Git,也别放在网站根目录下。
小结
「本地有、OSS 没有」这个问题,本质是把「本地存储」和「对象存储」当成了一回事。WordPress 不知道 OSS 的存在,缩略图生成也不会通知 OSS。
所以必须有一条独立的同步链路,定期把本地新增的东西推上去。上面这套流程,跑通一次之后就是自动的。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END




















暂无评论内容