调优 proxy_buffers 不能直接减少物理内存溢出，需控制单请求内存上限、禁用临时文件、设 proxy_busy_buffers_size 为总量1/4～1/2且≥单块大小、配合 vm.swappiness=1 与 proxy_buffering off（流式场景）协同缓解 oom。

调优 proxy_buffers 本身不能“配合缓存写入”来减少物理内存溢出，反而不当配置会直接加剧内存压力——关键在于控制单请求内存占用上限、避免临时文件刷盘引发的内核 page cache 污染，并与系统级内存策略协同，才能真正缓解 OOM 风险。

按响应特征设总量，不堆数量也不抠大小

每个活跃请求独占一组缓冲区，总量 = 数量 × 单块大小。高并发下这是内存消耗主因：

• 中小响应（API/HTML，平均 50–200KB）：用 proxy_buffers 8 256k（总 2MB），够用且单 worker 不易突破 512MB RSS
• 大响应（报表导出、镜像回源，几十 MB）：可设 proxy_buffers 16 512k（总 8MB），但必须同步限并发或改用流式转发
• 禁用极端值：如 proxy_buffers 64 4m 单请求吃 256MB，10 并发就压垮 2GB 内存机器

严格约束“已收未发”数据驻留上限

proxy_busy_buffers_size 控制正在发送但尚未清空的缓冲区内存上限，它从 proxy_buffers 总量中划出。设错会直接导致后端写阻塞或内存堆积：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• 必须 ≤ proxy_buffers 总量，且 ≥ 单块 buffer 大小（如单块 256k，则 busy 值不能低于 256k）
• 推荐设为总量的 1/4～1/2：总量 2MB → 设 proxy_busy_buffers_size 1m；总量 8MB → 设 2m 或 4m
• 设太小（如沿用默认 8k）会导致几轮响应就暂停接收，后端 socket write 阻塞上升

禁用落盘或强制走内存盘，切断 swap 触发链

频繁写临时文件会污染 page cache、拖慢内存回收，是间接触发 swap 的关键环节：

• 内存充足且响应大小可控时：proxy_max_temp_file_size 0，超限直接返回 502，暴露瓶颈而非掩盖
• 必须允许落盘时：proxy_temp_path /dev/shm/nginx_temp 1 2 挂载到 /dev/shm，避开磁盘 IO 对 page cache 的干扰
• 同时调大写入粒度：proxy_temp_file_write_size 256k，降低 write() 系统调用频次

配套系统级与 Nginx 行为收敛

仅调 buffer 参数不够，需让 Nginx 行为与 Linux 内存管理对齐：

• 调低换页倾向：vm.swappiness=1（抑制内核主动换出匿名页）
• 流式场景彻底绕过缓冲：proxy_buffering off（SSE、大文件下载等），此时所有 buffer 参数失效，零落盘、零 swap 风险
• 监控验证：cat /proc/<nginx-pid>/status | grep VmRSS</nginx-pid>，确认单 worker 实际 RSS 是否稳定在预期范围