Nginx 无 proxy_limit_rate 指令，实际可用的是 limit_rate 和 limit_rate_after：前者限制响应下行速率（按连接生效，单位 b/k/m），后者设定限速起始字节数，二者需配合使用且仅作用于 Nginx 到客户端的输出阶段。
Nginx 没有 proxy_limit_rate 这个指令。这是一个长期被误传的概念，官方文档中从未定义该指令，所有稳定版 Nginx（截至 2026 年）均不支持。
你真正能用、且常被错当成 proxy_limit_rate 的，是这两个原生命令：
-
limit_rate limit_rate_after
它们作用于 Nginx 向客户端发送响应的速率，也就是“下行带宽控制”，和代理后端完全无关。
limit_rate 是怎么工作的？
- 它在 Nginx 的输出过滤阶段（output filter）生效，此时响应体已组装完成（无论来自静态文件、FastCGI 还是
proxy_pass），统一按连接限速。 - 单位支持
b（字节/秒）、k（KiB/秒）、m（MiB/秒），例如limit_rate 1m表示 1 MiB/s。 - 值为
0表示禁用该限速，不是“不限速”，而是显式关闭该指令。 - 按 TCP 连接（connection）生效，不是按请求或 IP；一个用户开多个连接就能绕过单连接限速。
如何只对代理路径限速？
把限速指令放在对应的 location 块里即可，例如：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
location /api/files/ {
proxy_pass https://backend;
proxy_set_header Host $host;
limit_rate_after 2m; # 前 2MB 不限速
limit_rate 512k; # 之后限速到 512 KiB/s
}这样 /api/files/ 下所有经 proxy_pass 返回的内容（如大文件下载）都会被限速，而其他路径不受影响。
为什么不能限制“Nginx 读取后端”的速度？
Nginx 不提供上游读取限速能力。它从后端接收数据的速度，由以下因素决定：
- 后端响应速度
- 网络延迟与带宽
-
proxy_buffering开关状态（开启时会尽可能快地拉取完响应并缓存；关闭时则边收边发）
即使你看到某些旧资料提到 proxy_limit_rate（如 1.7.7 版本标注），那也属于非官方补丁或第三方模块，并未进入主线，当前主流发行版（包括 nginx.org 官方源、主流 Linux 发行版仓库）均不包含该指令。
想实现更精细的控制？可以这样组合
- 按 IP 限速：用
limit_conn+limit_req配合$binary_remote_addr - 动态限速：用
map指令根据 URI、Header 或变量设置limit_rate值 - 区分内容类型：结合
if（慎用）或try_files分离静态与代理路径，再分别配置限速
限速本身不复杂，但关键在于理解它作用在哪一环——不是代理链路中间，而是 Nginx 到客户端的最后一段。
