nginx 通过 proxy_cache 构建静态资源边缘缓存层，需配置缓存区、按后缀精准启用、定制 cache key、开启缓存锁与 stale 机制，并通过 x-cache-status 响应头验证命中状态。
用 proxy_cache 在 Nginx 上构建静态资源分发加速层，本质是让 Nginx 充当一个轻量、可控的边缘缓存节点，把后端（如 OSS、源站、对象存储或内部文件服务）返回的 JS/CSS/图片等资源暂存本地，后续请求直接响应，大幅减少回源次数和源站压力。
一、定义可靠缓存区：路径、内存与自动清理
缓存区域必须在 http 块顶层声明，不可放在 server 或 location 内：
proxy_cache_path /var/cache/nginx/static levels=1:2 keys_zone=static_cache:128m max_size=20g inactive=7d use_temp_path=off;-
/var/cache/nginx/static需手动创建，并赋予 Nginx 进程（如nginx或www-data）读写权限 -
keys_zone=static_cache:128m表示分配 128MB 内存存缓存索引，支撑约百万级 key，静态资源多时建议 ≥64m -
inactive=7d指 7 天未被访问的缓存条目自动淘汰，比仅靠max_size更主动控空间 -
use_temp_path=off强制跳过临时目录中转，避免多余 IO，提升写入效率
二、精准启用缓存：按后缀匹配 + 分级有效期
只对明确静态资源启用，避免误缓存动态内容：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 用正则精准匹配：
location ~* \.(js|css|png|jpg|gif|webp|woff2|ttf|svg|eot)$ - 绑定缓存区：
proxy_cache static_cache; - 按状态码设缓存时长：
proxy_cache_valid 200 301 302 1y;（静态资源建议设为 1 年）proxy_cache_valid 404 1m;（防频繁探测） - 忽略干扰响应头：
proxy_ignore_headers Set-Cookie Expires;，防止后端错误设置导致不缓存 - 允许客户端强制跳过：
proxy_cache_bypass $arg_nocache $http_cache_control;（便于调试）
三、优化缓存键与回源行为：去噪、防击穿、保可用
默认缓存键易受 URL 参数或请求头影响，需显式精简并加固逻辑：
- 定制 cache key：
proxy_cache_key "$scheme$request_method$host$uri";
去掉$args和$cookie_*等易变字段，避免缓存碎片化 - 开启缓存锁：
proxy_cache_lock on; proxy_cache_lock_timeout 3s;，防高并发下多个请求同时回源 - 源站异常时仍可响应旧缓存：
proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504 updating; - 启用再验证机制：
proxy_cache_revalidate on;，缓存即将过期前自动带If-None-Match向后端校验，兼顾新鲜度与性能
四、可观测与验证：命中状态、响应头与实际效果
配置生效≠真正缓存，必须通过响应头和日志确认：
- 添加标识头：
add_header X-Cache-Status $upstream_cache_status;
返回值为HIT（命中）、MISS（未命中）、BYPASS（被跳过）或EXPIRED（过期待更新） - 检查缓存文件是否生成：
ls -l /var/cache/nginx/static/，可见按levels=1:2规则分布的哈希子目录 - 配合
proxy_pass http://origin_backend;（建议用upstream定义），确保后端地址稳定、健康 - 若后端是 OSS 或云存储，注意其响应头中是否含
Cache-Control或Expires，Nginx 默认会尊重；如需覆盖，加proxy_ignore_headers
