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 稳定运行