use_temp_path=off是nginx代理缓存的核心优化开关，它使缓存文件直接写入proxy_cache_path指定目录，避免跨文件系统rename失败、减少一次磁盘i/o和inode操作，并需配合目录权限、空间预留及location中proxy_cache等指令共同生效。
Nginx 代理场景下的“临时文件缓存策略”实际指向两个密切相关但职责不同的机制：一是 proxy_buffering 与 proxy_buffers 控制的内存缓冲行为，二是 use_temp_path=off 配合 proxy_cache_path 所管理的磁盘缓存临时文件路径策略。它不指代某种独立的“临时文件缓存”，而是代理过程中请求/响应数据在内存不足时落盘行为的配置组合。
核心目标是：避免无序写入、减少 inode 压力、提升小响应吞吐，并防止磁盘 I/O 成为瓶颈。
✅ 关键配置项及其作用逻辑
use_temp_path=off 是最常被误解也最关键的开关。
它不是禁用临时文件，而是让 Nginx 直接把缓存文件写入 proxy_cache_path 指定的主目录（如 /var/cache/nginx），而非先写到 /tmp 或其他临时路径再移动。
好处很实在：
- 避免
rename()系统调用（跨文件系统移动会失败，且触发额外 inode 操作） - 减少一次磁盘写 + 一次元数据更新
- 缓存命中路径更稳定，便于运维清理和监控
必须配合 proxy_cache_path 使用，单独设置无效。
✅ 推荐的代理缓存+临时路径组合配置
放在 http 块中：
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_proxy_cache:20m max_size=5g inactive=30m use_temp_path=off;
说明：
-
/var/cache/nginx：确保目录存在且nginx用户可写（chown -R nginx:nginx /var/cache/nginx） -
levels=1:2：生成两级子目录（如a/1f/xxx），避免单目录下海量文件导致查找慢 -
keys_zone=my_proxy_cache:20m：20MB 内存存缓存键哈希表，支持约 10 万～15 万个缓存条目（按平均键长估算） -
max_size=5g：磁盘总上限，超限时 Nginx 自动 LRU 清理 -
inactive=30m：30 分钟未被访问的缓存项会被自动删除（注意：不是 TTL，不依赖后端响应头） -
use_temp_path=off：✅ 强制关闭独立临时路径，所有缓存文件直写主目录
✅ 代理 location 中需配套启用的指令
在 location 块内（例如反向代理后端 API 或静态资源）：
location /api/ {
proxy_pass http://backend;
proxy_cache my_proxy_cache;
proxy_cache_valid 200 302 5m;
proxy_cache_valid 404 1m;
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
# 缓存键建议包含关键变量（避免 GET 参数差异被忽略）
proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args";
# 启用缓冲（默认 on），但需合理设大小
proxy_buffering on;
proxy_buffers 8 64k; # 8 个 buffer，每个 64KB → 共 512KB 内存缓冲
proxy_buffer_size 128k; # response header 单独缓冲区，需大于后端返回头体积
proxy_busy_buffers_size 256k;
# 可选：禁止缓存含 Set-Cookie 的响应（除非你明确需要 session 级缓存）
proxy_ignore_headers Set-Cookie;
proxy_hide_header Set-Cookie;
}
⚠️ 注意：
-
proxy_buffering off会禁用所有缓冲，响应直接流式转发 —— 此时use_temp_path不生效，也就谈不上“临时文件缓存策略” - 若响应体较大（如文件下载），应调大
proxy_buffers和proxy_max_temp_file_size（默认 1G），否则可能因缓冲不足频繁落盘
✅ 验证是否按预期工作
- 查看缓存目录结构：
ls -1 /var/cache/nginx/??/??/ | head -n 5，确认有两级子目录且文件存在 - 检查响应头：命中缓存时应含
X-Proxy-Cache: HIT（需配add_header X-Proxy-Cache $upstream_cache_status;） - 观察磁盘写入：
iotop -p $(pgrep nginx)，高并发下不应出现大量小块随机写（说明use_temp_path=off+levels生效） - 查看 Nginx 日志中是否有
*XX open() "/var/cache/nginx/..." failed (2: No such file or directory)类错误（常见于权限或路径未创建）
不需要额外模块，ngx_http_proxy_module 默认内置。只要 use_temp_path=off 与 proxy_cache_path 同时存在且路径有效，Nginx 就会把缓存文件直接、有序地写入指定目录，不再经由 /tmp 中转。
