直接设置 use_temp_path=off 可跳过临时目录写入与跨目录 rename，消除双倍 i/o 和跨设备错误，提升缓存效率；默认 on 会先写 proxy_temp_path 再 rename，导致性能开销和失败风险。

直接在 proxy_cache_path 中设置 use_temp_path=off 即可跳过临时目录写入与跨目录 rename 步骤，消除移动开销、避免跨文件系统错误，并提升缓存写入效率。

为什么默认 use_temp_path=on 会带来开销

默认开启时，Nginx 先将响应内容写入 proxy_temp_path（如 /var/tmp/nginx_temp），再调用 rename() 移动到最终缓存目录。这个过程存在两个主要问题：

• 双倍磁盘 I/O：数据被完整写入一次临时路径，再整体移动（本质是拷贝+删除）
• 跨设备限制：若临时路径与缓存路径不在同一挂载点（例如系统盘 vs 用户 SSD、APFS 加密卷 vs 主分区），rename 系统调用直接失败，导致缓存写入中断、返回 502 或静默降级为 BYPASS

正确配置 use_temp_path=off

只需在 proxy_cache_path 指令末尾显式关闭，无需额外定义 proxy_temp_path：

FastAPI Flask Proxy

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

下载

proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=mycache:10m max_size=2g inactive=60m use_temp_path=off;

• 确保 /data/nginx/cache 目录存在且 Nginx 进程有读写权限（如 chown nginx:nginx /data/nginx/cache）
• 该目录所在分区需预留足够空间——因为所有缓存内容将直接落盘于此，不再分摊到临时路径
• 重启 Nginx 后，可通过 curl -I 查看响应头中 X-Proxy-Cache 是否稳定出现 HIT，验证生效

关闭后需注意的配套事项

use_temp_path=off 虽简单高效，但需同步检查运行环境：

• 确认缓存目录所在文件系统支持原子写入（主流 ext4/xfs/APFS 均支持；NFS 或某些加密卷可能受限）
• 若部署在 macOS 或多磁盘环境，尤其要检查 df -T 输出，确保缓存路径与系统默认 temp 不跨挂载点
• 日志中若仍见 Invalid cross-device link，说明配置未生效或存在多个 proxy_cache_path 指令覆盖

性能收益与典型场景

实测显示，关闭 use_temp_path 可降低缓存写入延迟 30% 以上，对 SSR 页面（如 Next.js）、API 响应缓存等高吞吐场景尤为明显：

• Next.js 托管常用配置：proxy_cache_path /var/cache/nginx/nextjs ... use_temp_path=off;
• 本地开发环境（如 macOS 用户目录挂载独立 SSD）必须关闭，否则极易触发跨设备错误
• 容器化部署中，若缓存卷与临时卷映射不同路径，也建议统一设为 off 并挂载到同一存储层