0

0

Nginx利用expires指令实现图片资源永久缓存

舞夢輝影

舞夢輝影

发布时间:2026-03-13 16:45:31

|

639人浏览过

|

来源于php中文网

原创

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

nginx利用expires指令实现图片资源永久缓存

图片资源设为“永久缓存”在 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,一旦你替换了文件,用户缓存不会自动失效,仍看到旧图。

Rose.ai
Rose.ai

一个云数据平台,帮助用户发现、可视化数据

下载
  • 正确做法:构建时生成带哈希的文件名,如 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。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

248

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

522

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

610

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

713

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3618

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

56

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

72

2026.01.13

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号