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，提升写入效率

二、精准启用缓存：按后缀匹配 + 分级有效期

只对明确静态资源启用，避免误缓存动态内容：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 用正则精准匹配：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