proxy_cache_path是nginx反向代理缓存生效的前提，需在http块中配置path（手动创建并赋权）、levels（如1:2优化目录结构）、keys_zone（如my_cache:100m定义内存元数据区）、inactive（如60m清理冷数据）和max_size（如10g磁盘上限），并推荐启用use_temp_path=off。
proxy_cache_path 是 Nginx 反向代理缓存真正起效的前提，光写 proxy_cache 指令没用——路径没配对、内存没划够、目录结构不合理，缓存不是不写入，就是查得慢、清得乱、撑爆磁盘。
缓存路径与目录结构怎么设才高效
缓存根目录（如 /data/nginx/cache）必须手动创建，并确保 Nginx worker 进程用户（如 nginx 或 www-data）有读写权限。别依赖 Nginx 自动建目录，它不会帮你递归授权。
levels 参数决定缓存文件如何散列到子目录，直接影响文件系统性能：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
-
levels=1:2：最通用，取 key 的 MD5 值后 3 位，第一级 1 字符（16 种），第二级 2 字符（256 种），最终路径类似
/cache/7/ab/xyz；适合日均缓存数几万到百万级 - levels=2：只建一层 2 字符目录（共 256 个），路径更扁平，减少 inode 查找开销；适合高并发小文件场景或 NVMe 盘
- 避免 levels=1 或 levels=1:2:2：前者单目录易堆积，后者路径过深，增加 stat 和 open 成本
keys_zone 内存大小怎么估算才不浪费也不卡住
keys_zone 不存响应体，只存 key、状态、过期时间等元数据，全靠它实现毫秒级命中判断。大小设小了，新缓存写入直接被拒；设太大又浪费共享内存。
- 每条元数据约占用 512 字节，1MB ≈ 支持 2000 个活跃 key
- 中等业务建议从 my_cache:100m 起步（≈20 万个 key）；高流量 API 服务可设到 256m
- 名称必须全局唯一，后续在 location 中通过
proxy_cache my_cache引用 - 该内存由 Nginx 启动时一次性分配，不可热扩容
inactive 和 max_size 怎么配合防“缓存失控”
这两个参数一个管“冷数据清理”，一个管“磁盘硬上限”，缺一不可：
- inactive=60m 表示：任何缓存项若 60 分钟内未被访问，无论是否过期，都会被自动清理
- max_size=10g 是整个缓存路径的总容量上限（不是每个 zone 独立限制），超限时 Nginx 按 LRU 清理最久未用项
- SSD 上建议 max_size 不超过物理空间的 70%，HDD 不超过 50%，留足文件系统预留和碎片整理余量
- 注意：inactive 不清理已过期但仍在内存中的元数据，需靠 proxy_cache_valid 或后端响应头控制实际有效期
几个关键优化细节不能漏
这些参数不写不会报错，但一漏就可能让缓存 I/O 效率打五折：
- use_temp_path=off：强制响应体直写缓存目录，避免先写 /tmp 再 rename 的双次落盘，还能防止跨挂载点失败导致静默缓存失效
- 缓存目录务必挂载在本地 SSD 或 NVMe 盘，禁用 NFS、APFS 加密卷、Docker overlay；开发环境可用
/dev/shm（需调大vm.shmmax） - 删掉独立配置的
proxy_temp_path，它在 use_temp_path=off 下已失效 - 若用 XFS 文件系统，挂载时加上
noatime,inode64,logbufs=8,logbsize=256k可显著降低元数据更新开销
