<p>Nginx 中可通过 expires 1y 为图片设置一年缓存,需在 location ~* .(jpg|jpeg|png|gif|webp|ico|svg)$ 块中配置,并补充 add_header Cache-Control "public, immutable";必须确保 location 优先级高于通用规则、资源由 Nginx 直接响应且 URL 带哈希以避免更新失效。</p>

在 Nginx 中,可以通过 expires 指令为图片等静态资源设置浏览器缓存时间,比如缓存一年。这不需要额外加载模块——expires 是 Nginx 的核心模块(ngx_http_headers_module)内置功能,只要 Nginx 正常安装就可用。
确认图片资源匹配规则
要让 expires 生效,需确保请求确实命中了你配置的 location 块。常用做法是按文件后缀匹配图片资源:
location ~* \.(jpg|jpeg|png|gif|webp|ico|svg)$ { ... }-
~*表示不区分大小写的正则匹配 - 注意避免和更宽泛的 location(如
/或^~ /static/)产生冲突,优先级高的会覆盖低优先级的 expires 设置
设置 expires 为 1 年
在匹配图片的 location 块中添加 expires 指令:
location ~* \.(jpg|jpeg|png|gif|webp|ico|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}-
expires 1y表示设置Expires响应头为当前时间 + 1 年,同时自动添加Cache-Control: max-age=31536000 - 建议加上
add_header Cache-Control "public, immutable":其中public允许中间代理缓存,immutable告诉浏览器该资源内容不会变更(配合版本化文件名更有效) - 注意:
expires只对状态码为 200、201、204、206、301、302、303、304、307 的响应生效
验证缓存头是否生效
重启 Nginx 后,用浏览器开发者工具或 curl 检查响应头:
curl -I https://your-site.com/logo.png
应看到类似:
Cache-Control: public, immutable, max-age=31536000Expires: [未来某年某月某日]
若未出现,检查是否被其他 location 或 upstream(如反向代理)覆盖了响应头;也可临时加 add_header X-Debug "cached" 辅助定位配置是否命中。
注意事项与常见问题
实际使用中需注意几个关键点:
- 修改配置后必须执行
nginx -t && nginx -s reload,仅 restart 不够可靠 - 如果图片 URL 不带版本号或哈希(如
logo.png?v=1.2或logo.a1b2c3.png),更新图片后用户可能因强缓存看不到新图——建议配合构建工具生成带哈希的文件名 -
expires对动态生成的图片(如 PHP 输出的 png)无效,除非它们也返回 200 状态且未被 proxy_pass 等指令拦截响应头 - 某些 CDN 或前端代理可能清除或重写
Cache-Control,需在对应层同步配置


















