nginx反向代理小文件时sendfile默认不生效，但开启proxy_buffering、sendfile、tcp_nopush和tcp_nodelay可降低开销；需避免干扰响应头以保障长度可预测性。
在 Nginx 中使用 proxy_pass 转发小文件时，内存映射（sendfile）默认不生效，因为 sendfile 仅适用于直接响应静态文件的场景，而反向代理中响应体来自上游（upstream），Nginx 需先读取上游响应再转发，无法直接用内核零拷贝路径。但可通过组合配置显著降低小文件代理的内存和 CPU 开销。
启用 sendfile 和 tcp_nopush 的前提条件
Nginx 在 proxy 场景下虽不能对 upstream 响应直接用 sendfile，但对代理响应的**发送阶段**仍可启用 sendfile —— 这要求响应体已缓存在内存或临时文件中，并且 Nginx 能将其视为“本地数据”。关键前提是：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 关闭
proxy_buffering off（即保持缓冲开启），让 Nginx 将上游响应暂存后再整体发送 - 确保
sendfile on、tcp_nopush on和tcp_nodelay on同时启用（后者对小文件交互更友好） - 避免设置
proxy_set_header Transfer-Encoding ""等干扰响应头的指令，防止破坏长度可预测性
合理配置缓冲区以减少小文件的内存复制
小文件（如图标、CSS、JS，通常
-
proxy_buffering on：必须开启，使 Nginx 可聚合响应并配合sendfile -
proxy_buffers 8 4k：8 个 4KB 缓冲区，覆盖绝大多数小文件，避免频繁分配 -
proxy_buffer_size 4k：专用于响应头，4KB 足够容纳常见头字段 -
proxy_busy_buffers_size 8k：允许最多 8KB 数据在发送中仍可继续接收，平衡吞吐与延迟
对小文件启用临时文件缓冲（可选但推荐）
当小文件量极大、并发高时，全内存缓冲可能增加 GC 压力（尤其在容器或低内存环境）。此时可启用安全的磁盘缓冲：
-
proxy_max_temp_file_size 1m：限制单个临时文件最大 1MB，避免大响应写盘 -
proxy_temp_file_write_size 4k：每次写盘 4KB，对小文件友好 -
proxy_temp_path /var/cache/nginx/proxy_temp 1 2：确保路径存在且 Nginx 有写权限 - 注意：
sendfile对临时文件仍有效（Linux 支持sendfile()读取普通文件），所以磁盘缓冲不牺牲零拷贝优势
补充：禁用不必要的处理以降低开销
小文件代理的核心是“快进快出”，应避免引入额外解析或修改：
- 移除
proxy_set_header Accept-Encoding ""（除非需强制关闭压缩），否则可能触发上游重编码 - 避免
sub_filter或proxy_redirect等重写操作，小文件无需内容干预 - 若上游支持 HTTP/2 或 keepalive，启用
proxy_http_version 1.1+proxy_set_header Connection ''复用连接，减少建连开销
