proxy_temp_path 必须在 http 块中配置绝对路径、手动创建目录并赋权、指定层级（如 1 2），三者缺一不可；它仅暂存超出缓冲的代理响应体，不负责缓存，需配合 proxy_buffering 和 proxy_cache_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的子目录，避免单目录堆积海量文件拖慢查找。
常见错误与规避方式
配置后仍出问题，大概率卡在这几个点：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
-
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)类报错。
