讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Nginx 配置文件结构怎么设置静态资源缓存

云敏酱_3756

云敏酱_3756

发布时间:2026-11-19 19:45:05

|

841人浏览过

|

来源于php中文网

原创

在 nginx 中设置静态资源缓存,核心做法是在 location 块中配置 expires 指令并配合 add_header 添加 cache-control 响应头。通过指定时间(如 1y)或相对时间,nginx 会自动生成标准的 http 缓存控制头,浏览器据此决定是否向服务器发起请求。若需针对特定文件类型(如图片、css)应用不同策略,只需为对应的 location 分别设置即可。

Nginx 配置文件结构怎么设置静态资源缓存

如何为不同类型的静态资源设置不同的缓存策略

针对不同后缀的文件设置差异化缓存,最直接的方法是利用 location 的路径匹配规则。例如,将 HTML 文件设置为不缓存,而将 CSS、JS 和图片设置为长期缓存。这样既保证了页面内容的实时性,又充分利用了浏览器缓存加速资源加载。

Nginx 配置文件结构怎么设置静态资源缓存

server {
    listen 80;
    server_name example.com;

    # HTML 文件:不缓存,每次检查
    location ~ \.html$ {
        root /var/www/html;
        expires -1;
        add_header Cache-Control "no-cache, no-store, must-revalidate";
    }

    # CSS/JS 文件:缓存一年
    location ~* \.(css|js)$ {
        root /var/www/static;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # 图片文件:缓存一个月
    location ~* \.(jpg|jpeg|png|gif|ico)$ {
        root /var/www/images;
        expires 30d;
        add_header Cache-Control "public";
    }
}

上述配置中,expires -1 等同于禁用缓存,强制浏览器每次请求都去服务器验证。对于 CSS 和 JS,使用 immutable 标志告诉浏览器内容永远不会改变,只要文件名不变就不需要重新验证。图片缓存 30 天,适合变化频率较低的资源。实际运行时,浏览器会先读取本地缓存,若未过期则直接使用,不再发送 HTTP 请求,从而显著提升加载速度。

如何在缓存失效时实现平滑过渡而不产生 404

当静态资源更新导致旧缓存失效时,直接替换文件可能导致部分用户请求到正在写入中的新文件,引发 500 错误。解决此问题的标准做法是使用“原子替换”策略:先将新文件保存为临时名称,再通过 mv 命令重命名为正式文件名。由于 Linux 文件系统中原子重命名操作极快,Nginx 几乎不会读到不完整文件。同时,配合 try_files 或 error_page 可以进一步确保请求的稳定性。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

Nginx 配置文件结构怎么设置静态资源缓存

# 部署脚本示例 (伪代码)
cp new_style.css /tmp/style.css.tmp
mv /tmp/style.css.tmp /var/www/static/style.css

# Nginx 配置片段
location ~* \.css$ {
    root /var/www/static;
    expires 1y;
    # 如果文件不存在,尝试返回默认样式或错误页
    try_files $uri =404;
}

这种机制确保了即使在高并发场景下,用户也只会看到完整的旧文件或完整的新文件,不会出现混合内容。结合版本化文件名(如 style.v2.css),可以彻底避免缓存污染问题,因为旧文件不会被删除,新文件拥有唯一标识,浏览器会根据 URL 变化自动获取最新资源。

当浏览器强制刷新时 Nginx 如何处理缓存头

当用户按下 F5 或 Ctrl+F5 强制刷新时,浏览器行为因操作系统和浏览器类型而异。Chrome 在 Windows 上通常发送 If-None-Match 或 If-Modified-Since 条件请求,而在 macOS 上可能完全忽略缓存。Nginx 默认行为是:若客户端发送了条件请求且资源未修改,返回 304 Not Modified;若资源已修改,返回 200 OK 及新内容。对于强缓存(如 expires 1y),浏览器在未过期前通常不会发送任何请求,除非强制刷新。

为了更精细地控制这一过程,可以结合 etag 和 last_modified。Nginx 默认开启 etag,基于文件 inode 和大小生成哈希。若希望减少服务器负载,可关闭 etag 仅依赖 last_modified,但需注意秒级精度可能导致误判。在实际开发中,建议保留默认的 etag 设置,因为它能更准确地检测微小变更,且现代浏览器对 304 响应的处理非常高效,网络开销极小。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4367

2023.08.04

nginx配置详解
nginx配置详解

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

7325

2023.08.04

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

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

601

2024.02.23

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

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

1516

2024.07.09

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

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

3998

2024.08.07

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

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

122

2026.01.13

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

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

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn