Nginx 中怎么配置 proxy_temp_path 临时缓存文件目录-Nginx-PHP中文网

proxy_temp_path是代理响应体超出内存缓冲时的临时落盘路径，非缓存目录；需显式配置绝对路径、手动创建并赋权、指定1 2级子目录，且仅在proxy_buffering on且响应超限时生效。

nginx 中怎么配置 proxy_temp_path 临时缓存文件目录

proxy_temp_path 不是缓存目录，而是代理响应体超出内存缓冲时的临时落盘路径。它只在 proxy_buffering on 且响应体过大时启用，用完即删，不持久保存内容。

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

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

该指令必须放在 http 块中（也可放 server 或 location，但统一在 http 更稳妥），且仅在以下条件下才真正起作用：

FastAPI Flask Proxy

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

下载

proxy_buffering on;（默认开启，但务必确认未被覆盖为 off）；
后端响应体大小超过 proxy_buffer_size + proxy_buffers 总和（例如默认合计约 128KB，大文件下载、图片响应易触发）；
未启用 proxy_cache，或虽启用但缓存未命中——此时响应仍先写入 proxy_temp_path，再移入 proxy_cache_path。

很多问题其实不是 proxy_temp_path 配得不好，而是不该让它工作：

跨设备 rename 失败：当 proxy_temp_path 和 proxy_cache_path 不在同一挂载点，Nginx 默认先写临时文件再 rename() 到缓存目录，失败后静默降级为 MISS，日志只报 Invalid cross-device link；
更优解是关闭中转：在 proxy_cache_path 中直接加 use_temp_path=off，例如：
proxy_cache_path /ssd/nginx/cache levels=1:2 keys_zone=main:64m max_size=10g use_temp_path=off;
此时 proxy_temp_path 完全不生效，响应体直接写入缓存目录，省去双倍 I/O 和跨盘风险；
若必须保留 proxy_temp_path，请确保它和 proxy_cache_path 在同一块物理盘，并挂载在高速本地 SSD 上，预留空间 ≥ 单次最大响应体 × 并发数 × 1.5。

重启 Nginx 后快速确认：

用 curl -I http://your-domain/large-file.zip 请求一个明显大于缓冲区的文件（如 10MB），然后检查 /data/nginx/proxy_temp 下是否生成了带哈希子目录（如 /a/1f/xxx.tmp）的临时文件；
查看 error.log，确认无 Permission denied 或 Invalid cross-device link 报错。