图片迁到对象存储与 CDN 之后:路径不变反代、缓存头冲突与防盗链只该有一处

站点的图片越来越多,本地磁盘三番五次告警,于是把附件挪到对象存储 + CDN —— 这是几乎所有个人站长都会走的一步。真正麻烦的不是迁移那两天,而是迁移之后:原来的访问链路只有「浏览器 → Nginx → 本地文件」三段,现在变成了「浏览器 → CDN → 对象存储 → 回源站」,中间凭空多出两个可以缓存、可以出错、可以悄悄改写内容的环节。图片打不开、微信里发出去变裂图、图片站被别的站直接拿去用,绝大多数不是迁移本身失败,而是迁移完没把这条新链路管起来。

一、迁移后先别急着删本地文件

最常见的「事故」是这样发生的:脚本把 8000 张图片推到对象存储,全站替换成 Bucket 域名,测试首页正常,第二天删掉本地 uploads 目录省空间。两周后有人反馈「三年前那篇老文章图片是空白的」,一查是那批文件名里带中文,上传时被客户端编码成 %E4%B8%AD,而页面里写的是原字符,两边对不上,所以一张都没传上去。本地文件已经删了,原始图片只能从备份里翻。

所以迁移的正确顺序是:先全量上传并逐条校验 → 切换前台链接 → 观察至少两周的图片 404 与对象存储访问日志 → 确认长期无回落到本地 → 才清理本地原件。清理前至少保留一份离线的完整打包(tar + 校验文件),因为「图片还在不在」这件事,事后只能用原始备份来回答。

判断能不能删,有一个很硬的指标:对象存储的访问日志里,仍然有请求打到「回源到本地」的路径上,就说明还有页面没替换干净。别只看首页,站点里最老的那批文章才是雷区。

二、URL 规则:路径要「看起来还是老路径」

替代链接有两种写法,差别在长期的维护成本上。

第一种是直接把 的 src 换成 Bucket 域名,路径拼接规则散落在模板、正文 HTML、编辑器插件三处。第二种是保持 /uploads/2024/05/xxx.jpg 这个路径不变,只在 Nginx 上把这一类前缀反代到对象存储。第二种明显更好:正文里的链接一行都不用改,将来再换服务商也只是改一处 Nginx 配置。

location ^~ /uploads/ {
    proxy_pass https://bucket.example.com;
    proxy_set_header Host bucket.example.com;
    proxy_ssl_server_name on;
    proxy_hide_header x-amz-request-id;
    proxy_hide_header x-amz-id-2;
    proxy_intercept_errors on;
    error_page 404 = @local_uploads;
}

location @local_uploads {
    root /home/wwwroot/www.zz1984.com;
    try_files $uri =404;
}

几个要点:^~ 是为了不让后面的正则 location(比如 ~ \.(jpg|png)$ 之类)抢走这个前缀;proxy_ssl_server_name on 是访问 https 上游的必需项,不开的话握手时 SNI 是空的,部分对象存储会直接返回证书错误;proxy_intercept_errors 配合 error_page 才能把上游的 404 兜回到本地目录 —— 这是迁移期的安全网,等确认全部图片都在对象存储上之后再删掉。

注意 error_page 404 只处理 404,上游返回 403(常见的签名或权限错误)会原样透传,这个设计是对的:权限配置错应该暴露出来,而不是被本地文件掩盖。

如果坚持用独立域名(img.example.com),就要在 https 上多一个证书、多一次 DNS 解析,好处是将来可以单独给它上 CDN 而不影响主站。个人站图片量不大时,推荐还是走同域前缀反代,链路短、少一类证书问题。

三、一条反代链路会多出四类「看起来是 CDN 的问题」

迁移完成后最常见的报障是「图片时好时坏」。分层看,原因通常在这四处:

  • 缓存头被覆盖。对象存储会给每个对象带上自己的 Cache-Control,Nginx 反代时如果你又加了一条 add_header Cache-Control,浏览器会看到两个值,不同 CDN 取第一个还是最后一个并不统一。要么用 proxy_hide_header Cache-Control 再显式给一个,要么干脆不管,让对象存储的元数据说话。
  • Content-Type 判断错。有些对象存储按扩展名推断 MIME,文件名是 .jpg 但实际是 WebP,浏览器就会因为类型不符拒绝渲染;反向如果扩展名丢了(上面说的中文名编码),会返回 application/octet-stream,图片变成「下载」。
  • 回源请求丢 Host。反代时忘了 proxy_set_header Host,上游收到的是本站域名,签名的虚拟主机匹配不上,直接 400 或 403。
  • 防盗链规则两处打架。Nginx 上有一份 Referer 白名单,CDN 上又有一份,规则不一致时就会出现「主站能看、分享到微信打不开」。这类问题只应有一处权威配置,另一处要么全放行要么关掉。

定位时最快的做法是绕开一层:curl -sI 直接打对象存储的原始地址,再打经过 CDN 的地址,对比状态码、Content-Type、Content-Length 和 Age。三个值一致就说明问题在前端或页面本身,不一致就是链路上某一层改写了响应。

四、防盗链要做对,而不是只加一条 Referer 判断

图片站最现实的损失不是被人扒走内容,而是带宽账单。基础做法是 Nginx 上的 valid_referers:

location ^~ /uploads/ {
    valid_referers none blocked server_names *.zz1984.com;
    if ($invalid_referer) {
        return 403;
    }
}

三个容易写错的地方:一是 none 意味着「没有 Referer 头的请求放行」,它会同时放过直接在地址栏打开的用户和用脚本抓图的程序;二是白名单里写 *.example.com 时,Nginx 的匹配是后缀匹配,*.zz1984.com 也会匹配 evilzz1984.com,正确写法要带上点号边界并加 ~ 启用正则,或者干脆逐条列全;三是移动端 WebView 和部分隐私浏览器默认不发 Referer,白名单太严会把正常读者挡在外面。

真正有效的组合是三件事一起做:Referer 拦掉明面上的盗链、CDN 层面按 IP 做速率限制挡住批量抓图、对确实的盗链来源单独统计(按 Referer 聚合日志)并在必要时拉黑。只靠 Referer 是拦不住有心人的,它的价值在于过滤掉大多数「顺手贴个链接」的低成本盗用。

另外一个常被忽略的点:/uploads/ 目录如果还允许执行 PHP,那迁移就是白做。反代到对象存储的前缀分支里不要出现 fastcgi_pass,同时本地兜底目录要确认 location ~ \.php$ 对它是拒绝的。

五、日志要改成能回答「哪张图在打我的带宽」

迁移后带宽从哪里来,只有日志能回答。在图片 location 上单独开一份日志,字段至少包含字节数、Referer、状态码和上游缓存状态:

log_format img '$remote_addr $time_iso8601 "$request" $status $body_bytes_sent '
               '"$http_referer" $upstream_cache_status $request_time';

location ^~ /uploads/ {
    access_log /var/log/nginx/img.log img buffer=32k flush=10s;
}

消费端就三条聚合,一周跑一次基本能看清全貌:

# 1. 单张图被请求最多的前 20
awk '{print $7}' /var/log/nginx/img.log | sort | uniq -c | sort -rn | head -20

# 2. 按 Referer 汇总流量(外站来源暴露这里)
awk '{gsub(/[“”]/,"",$6); if($6=="-") print "NOSRC"; else print $6}' \
  /var/log/nginx/img.log | sort | uniq -c | sort -rn | head -20

# 3. 状态码分布,403 突然变多通常是防盗链打到了自己人
awk '{print $4}' /var/log/nginx/img.log | sort | uniq -c | sort -rn

判读规则:$upstream_cache_status 里 MISS 比例长期很高,说明 CDN 缓存键里混进了随机参数(统计脚本给图片加 ?v= 时最容易出);NOSRC 占比高说明有一批抓取程序在无 Referer 直取;403 占比高要看是哪里来的 Referer 被误伤。

六、缩略图与响应式图片的边界

图片上 CDN 之后,很多人想顺手做「按需要生成缩略图」,让 CDN 或 Nginx 动态裁剪。个人站要慎重:动态裁剪需要把原图取回来做 CPU 计算,缓存命中率一低就成了性能黑洞;更稳的做法是上传时就生成三档尺寸(列表 400、正文 800、原图),三份都传到对象存储,页面里用 srcset 让浏览器自选。

需要保留原图的理由只有两个:将来可能重新生成尺寸、以及文章里允许点击看大图。如果两个都不需要,只留正文尺寸能省掉一大半存储成本。这条决定要在迁移前定,迁移后再删原图,成本和风险都高得多。

七、验收清单

迁移完成,按顺序跑一遍,全部通过再宣布结束:

  • 随机抽 20 张图(包含最老文章的、文件名带中文的、文件名带空格的),用 curl -sI 直连对象存储,状态码必须 200,Content-Type 必须是 image/*。
  • 同一批图走 CDN 地址再打一遍,看 Age 是否存在、第二遍是否命中。
  • 站点地图与文章正文里搜 http:// 开头的图片地址,历史遗留的混合协议一定会被浏览器拦。
  • 关闭 Nginx 上的本地兜底 error_page,跑一轮全站页面,看图片 404 有没有冒出来 —— 这一步等价于「假装删掉本地文件」,是最真实的演练。
  • 确认对象存储的读权限是「公开读」而不是「公共读写」,写权限只留给那一条上传用的密钥,密钥要能随时轮换。

这套流程里没有一步是「新技术」,但每一项都对应过真实的故障。个人站做这类基础设施改造,值得花半天时间把链路和验收写下来,因为下次换服务商时,你面对的是同一套问题。

Last modification:November 19th, 2026 at 01:35 pm

Leave a Comment