Nginx 中“永久缓存”图片需配置 expires max 并添加 Cache-Control: public, immutable,同时资源路径必须带哈希等版本标识以确保更新生效;仅对静态图片扩展名精准匹配,避免误缓存动态资源。

图片资源设为“永久缓存”在 Nginx 中并不存在真正意义上的永久(比如 100 年),但可通过设置极长的 expires 时间(如 max 或具体远期时间)配合正确的 Cache-Control 头,让浏览器长期复用本地副本,达到事实上的“永久缓存”效果。关键在于:资源路径需带版本标识(如哈希值或时间戳),否则更新图片后用户可能无法及时获取新内容。
expires max 是最常用且推荐的方式
expires max 会让 Nginx 发送 Expires 头为 Thu, 31 Dec 2037 23:55:55 GMT(HTTP/1.1 规定的最大可表示时间),同时自动添加 Cache-Control: max-age=315360000(约 10 年)。它简洁、可靠,且兼容所有主流浏览器。
- 配置示例(放在 location 块中):
location ~* \.(jpg|jpeg|png|gif|ico|svg|webp)$ {
expires max;
add_header Cache-Control "public, immutable";
}immutable 是重要补充——告诉浏览器该资源在过期前绝不会变更,可跳过条件请求(如 If-None-Match),进一步提升性能。
务必配合资源指纹化(版本化)路径
如果图片 URL 始终是 /images/logo.png,即使加了 expires max,一旦你替换了文件,用户缓存不会自动失效,仍看到旧图。
- 正确做法:构建时生成带哈希的文件名,如
logo.a1b2c3d4.png;或加查询参数(不推荐,部分 CDN 和代理可能忽略) - 发布新图 → 文件名改变 → URL 变更 → 浏览器视为全新资源,自然绕过旧缓存
- 静态站点生成器(如 Hugo、VuePress)、Webpack、Vite 等默认支持文件哈希输出
注意静态资源目录与动态资源分离
不要对整个 / 或 /images/ 目录无差别启用 expires max,尤其当该目录下混有需要频繁更新的资源(如通过 CMS 上传的运营图)。
- 建议按扩展名精准匹配,如只对
.jpg、.png、.webp等真正静态的图片生效 - 对用户上传目录(如
/uploads/)应使用较短缓存(如expires 1h)或禁用缓存(expires off),避免内容陈旧 - 可结合
map指令实现更灵活的缓存策略,按路径前缀或变量区分
验证是否生效
部署后打开浏览器开发者工具 → Network 标签 → 刷新图片请求,检查响应头:
- 存在
Expires字段(值为远期时间) - 存在
Cache-Control,包含max-age=...和immutable - 第二次访问同一图片时,状态码显示
200 (from memory cache)或200 (from disk cache),而非304
若看到 304 Not Modified,说明浏览器仍在发条件请求,可能缺少 immutable,或服务端未正确返回 ETag/Last-Modified。










