调优 proxy_buffers 的核心是让常见响应体“稳落在内存里”，需按响应体大小分档设置总量，配套约束 busy 区与落盘行为，匹配后端类型，并验证运行态信号。
调优 proxy_buffers 的核心是让常见响应体“稳落在内存里”，既不因过小被迫落盘加剧 I/O 压力，也不因过大快速吃光 worker 内存引发 swap。它不是孤立参数，必须和响应特征、并发规模、配套缓冲策略一起算总账。
按响应体大小分档设置总量
单个请求的缓冲区占用 = proxy_buffers 数量 × 单块大小，这个总量要覆盖你业务中 90% 以上的响应体：
- 中小响应（API JSON、SSR 首屏 HTML、静态 JS/CSS，平均 50–200KB）：用
proxy_buffers 8 256k（总量 2MB），兼顾 100+ 并发与单请求开销 - 大响应（报表导出、镜像拉取、媒体文件回源，百 MB 级）：可设
proxy_buffers 16 512k（总量 8MB），但需同步限制并发连接数，或改用proxy_buffering off流式转发 - 严禁盲目堆数量：如
proxy_buffers 64 4m单请求就占 256MB，10 个并发即可压垮 2GB 内存机器
配套约束“忙区”与落盘行为
只调 proxy_buffers 不够，必须控制实际驻留内存的数据量：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
-
proxy_busy_buffers_size设为总量的 1/2（例如总量 4MB → 设2m），防止已收未发数据无节制堆积 -
proxy_max_temp_file_size 0彻底禁用临时文件，超限时直接返回 502，比默默落盘更利于暴露瓶颈 - 若必须允许落盘，把
proxy_temp_path指向内存盘：proxy_temp_path /dev/shm/nginx_temp 1 2，避开磁盘 I/O 对 page cache 的干扰
匹配后端类型与传输模式
不同后端对缓冲行为敏感度不同，不能一套参数打天下：
- Next.js / FastAPI / Spring Boot 等 SSR 或 REST API：保持
proxy_buffering on，靠缓冲削峰填谷，提升后端连接复用率 - SSE、日志 tail、LLM token 流：必须
proxy_buffering off，此时所有proxy_buffers参数失效，零落盘、零 swap 风险，但需补proxy_http_version 1.1和延长proxy_read_timeout - 含长 Cookie、JWT 或多
Set-Cookie的响应：单独调大proxy_buffer_size至 16k–32k，它只管响应头，和proxy_buffers无关
验证是否真正起效
reload 后不能只看服务是否启动，要观察运行态信号：
- 用
curl -I请求，确认响应头含准确Content-Length（说明未被 chunked 截断） - 查
/proc/<nginx-pid>/status | grep VmRSS</nginx-pid>，确认单 worker 实际内存占用稳定在预期范围（如总量 4MB 缓冲 + 其他开销 ≈ 120–180MB） - 观察 error log 是否仍有
upstream sent too big header（说明proxy_buffer_size不足）或writing to temp file（说明整体缓冲仍偏小）
