Nginx中proxy_pass本身不支持限速，需通过limit_rate、limit_rate_after配合关闭proxy_buffering等配置实现对下载响应体的带宽限制。
在 Nginx 中，proxy_pass 本身不直接支持限速，但可以通过组合 limit_rate、limit_rate_after 和代理相关指令，实现在反向代理文件下载服务时对**响应体（即下载内容）进行带宽限制**。关键点在于：限速必须作用于 Nginx 向客户端发送响应的阶段，且需确保代理后端返回的是真实文件流（非缓冲到内存再发），否则限速可能失效或不准。
启用限速并确保代理流式传输
默认情况下，Nginx 可能会缓冲后端响应（尤其当 proxy_buffering on 时），导致 limit_rate 对整个响应生效延迟或不生效。要精准限速下载流，需关闭缓冲并启用流式转发：
- 设置
proxy_buffering off：禁用响应缓冲，让数据边收边发 - 设置
proxy_cache off和proxy_buffer_size 4k（可选，减小初始头缓冲） - 添加
proxy_http_version 1.1和proxy_set_header Connection ''，避免 HTTP/1.0 连接问题
配置 per-connection 下载限速（最常用）
使用 limit_rate 指令限制每个连接的发送速率（单位：字节/秒）。它作用于 Nginx 发送给客户端的响应体，适合控制单个下载连接速度：
-
limit_rate 512k;→ 限制为 512 KB/s（注意单位是 KB，不是 kbps） -
limit_rate_after 10m;→ 前 10MB 不限速，之后开始限速（适合跳过小文件或首屏加载） - 该指令可放在
location、server或http块中，推荐放在匹配下载路径的location内
结合 location 精确匹配下载路径
只对实际文件下载请求（如 /files/ 或 *.zip）限速，避免影响 API 或页面资源：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
location ^~ /downloads/ {
proxy_pass https://backend-storage/;
proxy_buffering off;
proxy_cache off;
proxy_http_version 1.1;
proxy_set_header Connection '';
<pre class="brush:php;toolbar:false;"># 限速：前 5MB 不限，之后限 256KB/s
limit_rate_after 5m;
limit_rate 256k;}
说明：^~ 表示前缀匹配且优先于正则；若后端返回的是真实文件（Content-Disposition: attachment），该配置即可生效。
可选：按 IP 或 key 动态限速（需 limit_conn_zone）
如果需要更精细控制（如每个 IP 最大 1MB/s），需配合连接限制模块：
- 先定义共享内存区：
limit_conn_zone $binary_remote_addr zone=addr:10m; - 再在 location 中限制并发连接数：
limit_conn addr 1;（防多线程刷） - 限速仍用
limit_rate，但可结合 map 指令实现差异化速率（例如根据请求头或参数设置不同$limit_rate_val，再limit_rate $limit_rate_val;）
不复杂但容易忽略的是：限速生效的前提是 Nginx 真正“转发”而非“缓存后发送”。只要关掉 proxy_buffering、确保后端响应头不含 Content-Length 引起的提前结束（或用 chunked 编码），限速就能稳定作用于下载流。
