nginx proxy_cache通过路径定义、键值匹配、分级过期和更新机制四者协同实现静态资源本地缓存，有效降低源站压力并提升访问速度；需在http块声明proxy_cache_path，location中绑定keys_zone，按状态码设proxy_cache_valid，配合cache_bypass、cache_lock、cache_revalidate及x-cache-status响应头验证命中率。
直接用 proxy_cache 给静态资源做本地缓存，是降低源站压力、提升用户访问速度最有效的手段之一。关键不在于堆参数，而在于路径、键值、过期逻辑和更新机制四者协同。
一、定义可靠缓存区：路径、内存与清理策略
缓存区必须独立声明在 http 块中，且路径需有写权限：
proxy_cache_path /var/cache/nginx/static levels=1:2 keys_zone=static_cache:10m max_size=1g inactive=1d use_temp_path=off;-
levels=1:2防止单目录文件爆炸，建议保留 -
keys_zone名称（如static_cache）后续 location 中要精确引用 -
inactive=1d表示 1 天未被访问的缓存自动淘汰，比max_size更主动控制空间 -
use_temp_path=off关键优化，跳过临时文件中转，减少磁盘 IO
二、精准启用缓存：按资源类型绑定与分级过期
在 server 或 location 块中启用，避免全局误伤：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 匹配常见静态后缀：
location ~* \.(js|css|png|jpg|gif|woff2|svg|eot|ttf)$ - 绑定缓存区：
proxy_cache static_cache; - 按响应状态码设定缓存时长：
proxy_cache_valid 200 302 1h; proxy_cache_valid 404 1m; - 对带查询参数的请求跳过缓存：
proxy_cache_bypass $args;（如/logo.png?v=2不缓存） - 配合
add_header Cache-Control "public, immutable"向浏览器透传不可变性，避免重复校验
三、保障缓存新鲜度：避免陈旧内容的关键机制
静态资源更新后，用户看到旧文件，往往不是缓存没生效，而是没失效：
- 最优解是构建时生成哈希文件名（如
app.a1b2c3.js），URL 变则缓存自然失效 - 若无法改名，启用
proxy_cache_purge模块（需编译时加--with-http-cache-purge-module），通过脚本或接口清除指定 URL 缓存 - 开启
proxy_cache_lock on;防止高并发下多个请求同时回源，造成“缓存雪崩” - 开启
proxy_cache_revalidate on;，让 Nginx 在缓存即将过期前，用If-None-Match向后端确认是否需要更新，兼顾性能与一致性
四、验证与调优：从命中率到响应头
上线后必须观察实际效果，不能只看配置是否生效：
- 在响应头中添加
add_header X-Cache-Status $upstream_cache_status;，返回HIT/MISS/BYPASS便于定位问题 - 用
curl -I https://example.com/style.css查看X-Cache-Status和Cache-Control是否符合预期 - 监控缓存命中率：理想应 >90%，若长期低于 70%，检查
proxy_cache_key是否含无关变量（如随机 token、会话 ID）导致碎片化 - 可微调
proxy_cache_key "$host$request_uri"，默认已足够，一般无需额外加$args，除非明确需区分参数
