Nginx静态缓存分浏览器端（Cache-Control）和服务端磁盘缓存（proxy_cache）两层：前者通过add_header控制客户端缓存时效与策略，后者借助proxy_pass+proxy_cache_path实现本地SSD缓存，二者协同提升性能。

Nginx 实现静态缓存，核心是分两层：客户端浏览器缓存（靠 Cache-Control 或 expires）和 服务端磁盘缓存（靠 proxy_cache）。两者目的不同、配置方式不同，不能混用，但可协同提升性能。

---

一、浏览器端缓存：让客户端少发请求

这是最常用、最直接的静态缓存方式，适用于 .js、.css、.png、.woff2 等资源。Nginx 不生成文件副本，而是告诉浏览器“这个资源可以本地存多久”。

• 推荐用 add_header Cache-Control，比 expires 更灵活：

  location ~* \.(js|css|png|jpg|jpeg|gif|ico|woff2|ttf|eot|svg)$ {
      add_header Cache-Control "public, max-age=31536000, immutable";
      # 开启高效传输
      sendfile on;
      tcp_nopush on;
      # 文件句柄缓存（减少系统调用）
      open_file_cache max=1000 inactive=20s;
      open_file_cache_valid 30s;
      open_file_cache_errors off;
  }

• immutable 表示内容不会变更，浏览器跳过 If-None-Match 验证，彻底省掉 304 请求。
• max-age=31536000 即 1 年，适合带哈希指纹的资源（如 app.a1b2c3.js）。
• 若资源无版本号、可能被覆盖（如 /static/logo.png），则设为较短时间，例如 max-age=86400（1 天）。

---

二、服务端磁盘缓存：让 Nginx 少读磁盘

当并发高、静态文件 I/O 成瓶颈，或需应对 CDN 回源洪峰时，用 proxy_cache 把首次读取的内容存到本地 SSD，后续请求直接从缓存目录返回。

⚠️ 注意：proxy_cache 必须配合 proxy_pass 使用，不能和 root/alias 直接共存。常见做法是“伪代理”：

1. 定义缓存区（写在 http {} 块）

   proxy_cache_path /var/cache/nginx/static_cache 
       levels=1:2 
       keys_zone=static_cache:50m 
       max_size=5g 
       inactive=30d 
       use_temp_path=off;

2. 设置内部命名 location（处理真实文件服务）

   location @static_disk {
       internal;
       alias /var/www/static/;
       # 或 root /var/www/static; 加上 try_files $uri =404;
   }

3. 主 location 转发并启用缓存

   

   Nginx Hosting

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

   下载

   location ^~ /static/ {
       proxy_cache static_cache;
       proxy_cache_key "$scheme$request_method$host$uri$is_args$args";
       proxy_cache_valid 200 304 30d;
       proxy_cache_use_stale error timeout updating;
       proxy_cache_lock on;
       proxy_pass http://127.0.0.1:8080;  # 指向 @static_disk
       proxy_redirect off;
       proxy_set_header Host $host;
   }
   
   # 内部 server 或 location 提供转发目标
   location = /_static_proxy {
       internal;
       alias /var/www/static/;
   }

   或更简洁地用命名 location：

   location ^~ /static/ {
       proxy_cache static_cache;
       proxy_pass http://127.0.0.1:8080/_static/;  # 后端监听 8080，实际返回文件
       # ……其余 proxy_cache_* 指令同上
   }

---

三、验证与调试技巧

• 查看是否命中缓存：加响应头

  add_header X-Cache-Status $upstream_cache_status;

  返回 HIT / MISS / BYPASS，方便 curl 测试：

  curl -I https://yoursite.com/static/app.js

• 确保缓存路径可写：

  sudo chown -R nginx:nginx /var/cache/nginx/static_cache
  sudo chmod 755 /var/cache/nginx/static_cache

• 避免缓存污染：静态资源建议加版本号或哈希（如 /static/v2/main.css），并在 proxy_cache_key 中包含 $uri，不带 $args（除非真有查询参数影响内容）。

---

不复杂但容易忽略