如何通过 `proxy_temp_path` 设置代理临时文件路径-Nginx-PHP中文网

proxy_temp_path 必须在 http 块中配置绝对路径、手动创建目录并赋权、指定层级（如 1 2），三者缺一不可；它仅暂存超出缓冲的代理响应体，不负责缓存，需配合 proxy_buffering 和 proxy_cache_path 协同工作。

如何通过 `proxy_temp_path` 设置代理临时文件路径

直接在 http 块中写一行 proxy_temp_path 指令就能生效，但路径必须是绝对路径、提前创建好、且 Nginx 工作进程（如 nginx 或 www-data 用户）有完整读写权限。它不负责缓存，只管代理响应体超出内存缓冲时的临时落盘。

缺一不可，否则会报错或静默失效：

绝对路径：不能用相对路径或环境变量，例如 /data/nginx/proxy_temp 可以，./proxy_temp 或 $HOME/proxy_temp 无效；
手动创建目录并赋权：Nginx 不会自动建目录，需执行 mkdir -p /data/nginx/proxy_temp，再运行 chown nginx:nginx /data/nginx/proxy_temp（用户组名按实际 worker 进程身份调整）；
指定层级结构：推荐加 1 2，例如 proxy_temp_path /data/nginx/proxy_temp 1 2;，这样文件会散列到类似 /data/nginx/proxy_temp/7/ab/xxx.tmp 的子目录，避免单目录堆积海量文件拖慢查找。

配置后仍出问题，大概率卡在这几个点：

FastAPI Flask Proxy

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

下载

Permission denied：SELinux 或 AppArmor 拦截、目录属主不是 worker 用户、或父目录缺少执行（x）权限——逐级检查 ls -ld /data /data/nginx /data/nginx/proxy_temp；
Invalid cross-device link：当同时启用 proxy_cache 且 proxy_cache_path 和 proxy_temp_path 不在同一挂载点时，Nginx 会在写缓存前尝试 rename() 临时文件，跨磁盘失败即静默降级为 MISS；解决方法是二者挂同一块盘，或更彻底地在 proxy_cache_path 中设 use_temp_path=off；
磁盘写满或 I/O 卡顿：大文件并发回源时临时文件瞬时暴增，建议把路径挂到独立 SSD，并预留 ≥ 单次最大响应体 × 并发连接数 × 1.5 的空间。

proxy_temp_path 不是孤立工作的，它依赖缓冲行为触发：

默认 proxy_buffering on; 时，响应体超过 proxy_buffer_size + proxy_buffers 总和才会写临时文件；
若设 proxy_buffering off;，则该路径基本不被使用（响应直通，不暂存）；
启用缓存（proxy_cache）且未命中时，也会先写 proxy_temp_path，再移到 proxy_cache_path，所以二者路径协同很重要。

改完配置重启 Nginx 后，快速确认两件事：

访问一个明显大于内存缓冲的大文件（如 100MB 视频），然后 ls -l /data/nginx/proxy_temp/**/* 查看是否有新生成的 .tmp 文件；
查 error.log，确认没有 open() ... failed (13: Permission denied) 或 rename() failed (18: Invalid cross-device link) 类报错。