proxy_buffer_size 仅缓存响应头，proxy_buffers 专控响应体，二者职责分离；proxy_buffer_size 默认4k易被大响应头撑爆导致502错误，需实测响应头字节数后调优。
调优 proxy_buffer_size 和 proxy_buffers 的关键，是分清职责、匹配响应特征、避免参数错配。前者只管响应头（status line + headers），后者专控响应体（body）；两者互不替代，也不能混用大小逻辑。
明确各自作用域，不交叉设值
proxy_buffer_size 是独立缓冲区，仅存放响应头，与 proxy_buffers 完全无关。默认 4k 极易被 JWT、多 Set-Cookie、调试字段撑爆，触发 “upstream sent too big header” 错误并返回 502。
- 实测后端响应头字节数（含 CRLF），用
curl -v URL 2>&1 | grep '^ 统计 - 建议值：实测值 × 1.2～1.3，取最接近的 2 的幂次（如 5200 字节 → 设
8k） - 硬性约束：
proxy_buffer_size必须小于单块proxy_buffers大小（例如proxy_buffers 8 128k，则proxy_buffer_size最大为64k，不能设256k）
按响应体特征设 proxy_buffers 总量与单块大小
proxy_buffers 数量 大小 决定每个连接能分配多少内存缓存响应体。不是越大越好，要贴合后端输出节奏和典型体积。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- SSR 页面或常规 API（80–200KB）：推荐
proxy_buffers 8 128k（总 1MB） - 日志流/SSE/分块 JSON（每批约 32KB）：用
proxy_buffers 16 32k，减少 buffer 切换开销 - 报表导出或镜像回源（几 MB～百 MB）：可设
proxy_buffers 32 128k或16 256k（总 4MB 左右） - 单位必须小写（
128k合法，128kb会被静默忽略）
协同设置 proxy_busy_buffers_size 防卡死
该值不是额外内存池，而是从 proxy_buffers 中划出的“正在发给客户端”的部分上限。设错会直接导致后端写阻塞或并发下降。
- 合理范围：总量的 1/4 至 1/2，且不低于单块大小
- 示例搭配：
proxy_buffers 8 128k→proxy_busy_buffers_size 256k；proxy_buffers 16 256k→proxy_busy_buffers_size 2m - 若设太小（如仍用默认 8k），Nginx 收几 KB 就停读上游，后端 socket.write() 阻塞，日志出现
upstream timed out
配套动作不可少
只调这两个参数不够，还需同步处理临时文件、超时与验证方式：
- 禁用落盘（内存充足时）：
proxy_max_temp_file_size 0，超限直接 502，比写磁盘更可控 - 延长等待时间：
proxy_read_timeout 300，尤其对导出类慢响应 - 验证是否生效：开启
error_log ... debug，搜索writing to temp file或upstream buffer is too small；监控disk_writes是否下降
