直接在proxy_cache_path中设use_temp_path=off可跳过临时路径写入与跨设备rename，消除io毛刺；需确保缓存目录空间充足、权限正确且文件系统支持原子写入。

直接在 proxy_cache_path 中设 use_temp_path=off，就能跳过临时路径写入与跨设备 rename()，从根源上消除因跨文件系统移动引发的 IO 毛刺。这不是锦上添花的调优，而是 macOS、Docker 挂载卷、多磁盘部署或 APFS 加密卷环境下的必要配置。

为什么默认 use_temp_path=on 会制造 IO 毛刺

默认行为是：Nginx 先把响应体写进 proxy_temp_path（如 /var/tmp/nginx_temp），再用 rename() 移到你定义的缓存目录。但 rename() 是原子操作，仅在同一挂载点内有效——一旦临时路径和缓存路径分属不同磁盘、分区或加密卷（例如 /var/tmp 在系统盘，/ssd/cache 在 NVMe SSD），系统就会返回 Invalid cross-device link (errno 18)。

这个失败不是静默忽略，而是触发重试、回退或降级，导致：

• 单次缓存写入耗时陡增，出现毫秒级甚至百毫秒级 IO 延迟尖峰
• 大量未完成的 .tmp 文件堆积在临时目录，引发 inode 或空间争抢
• 并发请求下毛刺被放大，表现为响应时间 P95 突然上扬、连接排队、X-Proxy-Cache 长期显示 BYPASS

正确关闭 use_temp_path 的三步操作

无需额外配 proxy_temp_path，也不用改全局设置，只需在 http 块中一行搞定：

• 确保缓存目录已创建且权限正确：mkdir -p /ssd/nginx_cache && chown nginx:nginx /ssd/nginx_cache
• 在 proxy_cache_path 指令末尾显式关闭：proxy_cache_path /ssd/nginx_cache levels=1:2 keys_zone=static:20m max_size=10g inactive=1h use_temp_path=off;
• 重载 Nginx：sudo nginx -s reload

关闭后必须同步验证的两个硬条件

use_temp_path=off 把所有写入压力集中到目标目录，环境必须匹配这一变化：

• 缓存目录所在分区需预留 ≥1.5 倍 max_size 的空闲空间——因为峰值流量下全部原始响应体将直写此处，不再由系统临时区分摊
• 文件系统必须支持原子写入：主流 ext4/xfs/APFS 支持良好；但 NFS、APFS 加密卷、某些 overlayfs 容器卷可能不兼容。可快速验证：touch /ssd/nginx_cache/test && mv test test2，若报错则不宜关闭

如何确认 IO 毛刺已被消除

从日志、磁盘行为与响应头三方面交叉验证：

• 检查 error.log：不再出现 rename() ... failed (18: Invalid cross-device link)
• 观察 /var/tmp/：不再持续生成或堆积 .tmp 文件
• 压测同一资源多次：curl -I http://example.com/logo.png，确认 X-Proxy-Cache 稳定返回 HIT，且响应时间分布平滑、无明显离群值