Nginx proxy_cache基础磁盘缓存配置需两步：一是在http块中用proxy_cache_path定义路径、levels、keys_zone、max_size、inactive等参数并确保目录权限；二是在location中通过proxy_cache引用该zone，且必须配合proxy_pass使用伪代理路径，不可直接与root混用。
配置 Nginx proxy_cache 的基础磁盘缓存目录，关键在于两步：先在 http 块顶层定义缓存路径与内存区，再在具体 location 中启用该缓存。它不是“开箱即用”的功能，必须显式声明路径、权限、层级和策略。
1. 在 http 块中定义 proxy_cache_path
这条指令必须放在 http { ... } 最外层，不能嵌套在 server 或 location 里，否则会报 unknown directive 错误。
-
手动创建缓存目录：比如
/var/cache/nginx/static_cache，并确保 Nginx worker 进程用户（如www-data或nginx）有读写权限：sudo mkdir -p /var/cache/nginx/static_cachesudo chown www-data:www-data /var/cache/nginx/static_cache -
推荐基础配置写法：
proxy_cache_path /var/cache/nginx/static_cache levels=1:2 keys_zone=static_cache:10m max_size=1g inactive=60m use_temp_path=off; -
各参数含义：
—levels=1:2：生成两级子目录（如a/1f/），避免单目录文件过多导致性能下降
—keys_zone=static_cache:10m：分配 10MB 内存存储缓存键的哈希索引，约可容纳 8 万个 key
—max_size=1g：磁盘总容量上限，超出后自动按 LRU 清理旧缓存
—inactive=60m：缓存项 60 分钟内未被访问，就标记为可淘汰（由后台进程清理）
—use_temp_path=off：禁用临时路径，直接写入目标目录，减少 IO 和锁竞争，线上必加
2. 在 location 中启用缓存
proxy_cache 只能配合 proxy_pass 使用，即使你只是服务本地静态文件，也得走“伪代理”路径。
- 不能这样写（无效）：
location /static/ { root /var/www; proxy_cache static_cache; } - 正确做法是：用内部
location+proxy_pass指向一个本地 URI，再在该块中启用缓存。例如：
location /static/ {<br>
proxy_pass http://127.0.0.1:8080/_static/;<br>
proxy_cache static_cache;<br>
proxy_cache_valid 200 301 302 1h;<br>
proxy_cache_valid 404 1m;<br>
add_header X-Cache-Status $upstream_cache_status;<br>
}
然后加一个内部匹配的 location 处理真实文件：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location = /_static/ {<br>
alias /var/www/static/;<br>
}
这样首次请求会通过 proxy_pass 走到 /_static/，Nginx 就能捕获响应并写入磁盘缓存；后续请求直接从缓存返回。
3. 验证与调试要点
配置完 reload 后，别急着测效果，先确认是否真正加载成功：
- 运行
nginx -T | grep proxy_cache_path，看输出是否包含你写的路径 - 检查缓存目录下是否生成了类似
d/07/的子目录（说明哈希路径已生效） - 用
curl -I http://your.site/static/test.js查看响应头是否有X-Cache-Status: HIT或MISS - 注意：缓存文件名是哈希值，无法直接对应原始 URL，不要试图用
ls找文件名来验证命中
4. 补充建议：搭配 open_file_cache 提升元数据效率
proxy_cache 缓存的是响应内容，而 open_file_cache 缓存的是文件元数据（是否存在、大小、修改时间等）。两者互补：
open_file_cache max=10000 inactive=60s;<br> open_file_cache_valid 30s;<br> open_file_cache_min_uses 2;<br> open_file_cache_errors on;
放在 http 块中即可，对所有静态资源生效，能显著降低高并发下的 stat() 系统调用开销。
