Nginx 中怎么设置静态资源的缓存命中策略-Nginx-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实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

在 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）。