讲师中心 微信公众号
AI工具推荐 视频效率加速

Nginx 中怎么设置静态资源的缓存命中策略

夜芳酱_8196

夜芳酱_8196

发布时间:2026-07-01 10:05:15

|

471人浏览过

|

来源于php中文网

原创

Nginx 缓存命中策略依赖响应头、proxy_cache 配置与 CDN 规则协同:1. 用 add_header 设置 Cache-Control(如 immutable)控制客户端/CDN 缓存;2. 配置 proxy_cache_path 和 proxy_cache 提升源站 HIT 率;3. 通过 $upstream_cache_status 日志分析真实命中状态;4. CDN 必须同步遵循源站 TTL 并规范 Cache Key。

nginx 中怎么设置静态资源的缓存命中策略

Nginx 本身不直接提供“缓存命中策略”这种抽象概念,它实际通过缓存控制响应头 + 本地 proxy_cache 配置 + CDN 协同规则共同实现对静态资源“是否缓存、缓多久、是否复用”的精准控制。所谓“命中策略”,本质是让请求尽可能走 HIT(缓存命中),避免 MISS(未命中)或 BYPASS(被绕过)。关键不在“策略开关”,而在三处配置必须协同生效。

1. 响应头明确告诉客户端和 CDN “可缓、长期、不可变”

浏览器和 CDN 是否缓存、缓多久,首要依据是 Nginx 返回的 Cache-Control 头。仅靠 expires 不够精准,推荐统一用 add_header:

  • 对带哈希名的 JS/CSS/图片/字体(如 app.a1b2c3.js):
    add_header Cache-Control "public, max-age=31536000, immutable";
    immutable 表示内容永不变,浏览器和 CDN 可跳过协商验证(如 If-None-Match),大幅提升 HIT 率。
  • 对 HTML 或动态生成页:
    add_header Cache-Control "no-cache, must-revalidate";
    禁止缓存,避免页面更新延迟。
  • 务必检查 location 优先级 —— 若存在 location ^~ /static 这类前缀匹配,它会优先于正则 location ~ \.js$ 生效,导致缓存头根本没加上。可用 nginx -T 查看最终生效配置。

2. 启用 Nginx 本地磁盘缓存(proxy_cache)减少回源压力

即使 CDN 节点 MISS,多个边缘节点同时回源会冲击源站。加一层 Nginx 本地缓存,能将首次请求后的响应存到磁盘,后续同类请求直接返回,显著提升源站 HIT 率:

Nginx Hosting
Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式,无需登录、无需令牌、无需用户操作。

下载
  • 在 http 块定义缓存区:
    proxy_cache_path /var/cache/nginx/static_cache levels=1:2 keys_zone=static_cache:10m max_size=2g inactive=30d use_temp_path=off;
  • 在静态资源 location 中启用(注意:必须配合 proxy_pass,不能直接用于 root 或 alias):
    推荐用命名 location 模拟代理:
    location ~* \.(js|css|png|jpg|woff2)$ {<br>
        proxy_pass http://localhost:@static;<br>
        proxy_cache static_cache;<br>
        proxy_cache_valid 200 302 7d;<br>
        proxy_cache_key "$scheme$request_method$host$request_uri";<br>
        add_header X-Cache-Status $upstream_cache_status;<br>
      }<br>
      location @static {<br>
        internal;<br>
        root /data/www;<br>
      }
  • 加上 add_header X-Cache-Status $upstream_cache_status;,日志里就能看到 HIT/MISS/BYPASS,方便定位问题。

3. 用日志驱动优化,而不是凭感觉调

缓存是否真命中,不能只看配置,要看真实请求流转。核心是分析 $upstream_cache_status 字段:

  • 在 log_format 中显式记录:
    log_format cache_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $upstream_cache_status';
    并在 location 中启用:access_log /var/log/nginx/static.log cache_log;
  • 高频问题一眼定位:
    awk '{print $12}' /var/log/nginx/static.log | sort | uniq -c | sort -nr
    若 BYPASS 占比高,说明请求被规则主动跳过(比如带 Cookie、Authorization 或非 GET/HEAD 方法);
    若 MISS 集中在特定 URI,大概率是 URL 带随机参数(?v=123)或大小写不一致,需清洗 proxy_cache_key(例如去掉 $args)。

4. CDN 层必须同步设置,否则 Nginx 头无效

Nginx 发了 max-age=1y,CDN 却可能按自己默认 TTL(比如 1 小时)截断。必须登录 CDN 控制台手动配置:

  • .js/.css/.woff2/.png 等带哈希资源:TTL 设为 30 天或勾选“遵循源站”
  • .html 文件:TTL 设为 0 或 10 分钟,防止页面更新不生效
  • 确认 Cache Key 包含 Host + URI(不含 Cookie、UA 等),避免跨子域缓存污染
  • 前端构建输出的资源 URL 必须指向 CDN 域名(如 https://cdn.example.com/app.js),否则请求根本不会经过 CDN。

不复杂但容易忽略

热门AI工具

更多
UpDream
UpDream Hot

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

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

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

WorkBuddy

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

Loomy
Loomy Hot

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

豆包大模型

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

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

403

2023.07.27

nginx 配置详解
nginx 配置详解

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

3387

2023.08.04

nginx配置详解
nginx配置详解

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

6105

2023.08.04

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

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

561

2024.02.23

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

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

1476

2024.07.09

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

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

3958

2024.08.07

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

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

122

2026.01.13

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

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

457

2026.01.13

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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