直接在 proxy_cache_path 中设 use_temp_path=off 可避免跨文件系统 rename 失败及性能损耗，需同步确保缓存目录空间充足并注意文件系统兼容性。
直接在 proxy_cache_path 中设 use_temp_path=off 即可避免缓存写入时跨文件系统移动导致的失败和性能损耗。这是 Nginx 缓存配置中一个轻量但关键的优化点，尤其在 macOS、多磁盘部署或容器化环境中效果明显。
为什么默认行为容易出问题
Nginx 默认会先将响应内容写入临时路径（如 /var/tmp/nginx_temp），再用 rename() 系统调用移入最终缓存目录。但 rename() 要求源与目标必须在同一个挂载点——若临时路径和缓存路径分属不同磁盘、分区或加密卷（比如 /var/tmp 在系统盘，/Users/xxx/cache 在另一块 SSD），操作就会失败。
- 日志中出现
rename() ... failed (18: Invalid cross-device link) -
X-Proxy-Cache响应头长期显示BYPASS或MISS，即使配置正确 -
/var/tmp/下堆积大量未清理的.tmp文件
正确启用 use_temp_path=off
只需在定义缓存路径时显式关闭该选项，无需额外配置 temp_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=my_cache:10m max_size=5g inactive=60m use_temp_path=off;
- 提前创建目录并确保 Nginx 进程有读写权限：
mkdir -p /Users/john/nginx_cache && chown john:staff /Users/john/nginx_cache - Nginx 会跳过中间临时文件，直接把缓存内容写入目标目录，省去一次拷贝+一次跨设备重命名
- 重启 Nginx 后，用
curl -I http://localhost/xxx观察X-Proxy-Cache是否稳定返回HIT
关闭后必须注意的两点
use_temp_path=off 不是“一设就完事”，它改变了数据落盘路径和方式，需同步调整运行环境：
- 缓存目录所在分区必须预留足够空间——峰值流量下所有待写入的缓存数据都会直接落在该目录，不再分摊到系统临时区
- 某些特殊文件系统（如 NFS、APFS 加密卷、部分 overlayfs 场景）可能不完全支持原子写入或
O_DIRECT，此时仍建议保留use_temp_path=on，并统一挂载点（例如将/var/tmp和缓存目录都挂到同一块盘）
配套缓存启用要点
仅配 proxy_cache_path 不生效，还需在 location 中启用缓存逻辑：
- 必须指定
proxy_cache my_cache（名称需与keys_zone一致） -
proxy_cache_valid必须显式设置，否则默认不缓存任何响应（例如proxy_cache_valid 200 302 10m） - 建议加上
add_header X-Proxy-Cache $upstream_cache_status，方便调试缓存命中状态
