use_temp_path=off是最有效的优化方式，它让Nginx直接写入缓存目录，避免跨文件系统rename失败导致的IO中断、502错误及静默降级。
直接设 use_temp_path=off 是最有效的方式。它让 Nginx 跳过“先写临时目录、再 rename 到缓存目录”的两步流程，避免因源与目标不在同一文件系统而触发 Invalid cross-device link 错误，从而消除 IO 中断和静默降级问题。
为什么默认行为会拖慢缓存写入
Nginx 默认启用 use_temp_path=on，即把响应体先写入 proxy_temp_path（如 /var/tmp/nginx_temp），再用 rename() 原子移入 proxy_cache_path 目录。但 rename() 在 Linux/macOS 上要求两个路径必须属于同一挂载点——若缓存目录在 /Users/xxx/cache（APFS 卷）、临时目录在 /var/tmp（可能映射到另一块 SSD 或容器卷），操作就会失败。
失败后常见表现包括：
- 错误日志反复出现
rename() "/var/tmp/xxx" to "/path/to/cache/xxx" failed (18: Invalid cross-device link) -
X-Proxy-Cache响应头长期为BYPASS或MISS，即使配置正确 -
/var/tmp下堆积大量未清理的.tmp文件
正确配置 use_temp_path=off
只需在 proxy_cache_path 指令末尾显式关闭：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
proxy_cache_path /Users/john/nginx_cache levels=1:2 keys_zone=mycache:10m max_size=5g inactive=60m use_temp_path=off;
注意要点：
- 无需额外声明
proxy_temp_path；Nginx 会直接将缓存文件写入目标目录 - 确保缓存目录已创建且权限正确：
mkdir -p /Users/john/nginx_cache && chown john:staff /Users/john/nginx_cache - 该参数必须写在
proxy_cache_path行内，不能放在其他位置或单独配置
配套调整不可少
关闭临时路径后，所有缓存写入都落在目标分区，需同步检查：
- 缓存目录所在磁盘剩余空间充足，建议预留至少 20% 空闲，应对突发流量峰值
- 若缓存目录挂载在 NFS、APFS 加密卷或某些容器卷上，需验证其是否支持原子写入；部分场景下仍建议保持
use_temp_path=on并统一proxy_temp_path与proxy_cache_path的挂载点 - 重启 Nginx 后，用
curl -I http://localhost/path观察X-Proxy-Cache是否稳定返回HIT，确认缓存已生效
这个设置简单但影响深远，尤其在 macOS、Docker 挂载或多磁盘部署中几乎是必调项。
