proxy_temp_path不用于缓存，而是暂存超出内存缓冲的代理响应体；必须配置绝对路径、手动创建目录并赋权、指定层级（如1 2），且需配合proxy_buffering生效。
Nginx 中 proxy_temp_path 并不用于设置缓存目录，而是指定代理请求时临时存放响应体的路径。它和真正的缓存（如 proxy_cache）无关，混淆这两者容易导致配置错误或磁盘空间异常增长。
proxy_temp_path 的真实作用
当 Nginx 作为反向代理，后端返回的响应体较大（超过 proxy_buffer_size + proxy_buffers 总和）时，Nginx 会把超出部分写入磁盘临时文件。这个存放位置就由 proxy_temp_path 指定。它只是“中转暂存”，不是缓存命中可复用的数据。
- 默认路径通常是
/var/cache/nginx/proxy_temp（取决于编译选项或系统包） - 该路径必须由 Nginx 工作进程有读写权限
- 临时文件在响应传输完成后自动清理，但若连接中断或 worker 异常退出，可能残留
如何正确设置代理临时文件目录
在 http、server 或 location 块中配置：
proxy_temp_path /data/nginx/proxy_temp 1 2;
其中三个参数含义：
- 第一项：根目录路径（必须存在且可写）
- 第二项：一级子目录数（16 进制，如 1 → 16 个子目录）
- 第三项：二级子目录数（如 2 → 每级再分 256 个子目录）
例如 proxy_temp_path /tmp/proxy 2 3; 会生成类似 /tmp/proxy/ab/cd/efghijklmnop 的嵌套结构，避免单目录下文件过多影响性能。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
真正控制缓存的指令是 proxy_cache
如果你目标是启用响应缓存，请使用以下组合：
-
proxy_cache_path：定义缓存存储路径、大小、失效策略等（必需） -
proxy_cache：在 location 中启用某块缓存区 -
proxy_cache_valid：设定不同状态码的缓存时间
示例：
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
注意：/data/nginx/cache 是缓存数据主目录，与 proxy_temp_path 完全独立，不应混用。
排查与优化建议
如果发现 proxy_temp_path 目录持续膨胀：
- 检查是否后端响应未设置
Content-Length或使用 chunked 编码，导致 Nginx 更频繁落盘 - 确认
proxy_buffering on;（默认开启），关闭后将禁用缓冲，所有响应直接流式转发，不产生 temp 文件 - 增大
proxy_buffers和proxy_busy_buffers_size可减少落盘频率，但需权衡内存占用 - 定期清理残留临时文件（如配合 logrotate 或定时脚本），但根本应确保 worker 稳定运行
