如何利用 limit_rate 为大文件下载设置单连接带宽限制（限速）-Nginx-PHP中文网

Nginx的limit_rate指令按连接限制响应体发送速率，单位字节/秒，常用于大文件下载限速；支持变量动态设置，需注意单位（k=1024）、生效时机及与limit_conn/limit_req配合使用。

如何利用 limit_rate 为大文件下载设置单连接带宽限制（限速）

Nginx 的 limit_rate 指令可以对每个连接的响应传输速率做硬性限制，特别适合控制大文件下载时单个客户端占用的带宽，防止少数连接吃光服务器出口带宽。

限速作用范围：按连接生效，非全局或按 IP

limit_rate 是在 response 发送阶段起作用的，它限制的是当前 HTTP 连接的响应体（比如一个 ZIP 文件）的发送速度，单位是字节/秒。它不区分用户身份，也不累计统计，只管“这个 TCP 连接此刻发数据有多快”。
常见误区：它不能替代 limit_conn（限制并发连接数）或 limit_req（限制请求频率），三者用途不同，可叠加使用。

基本配置写法（location 级最常用）

通常把限速放在匹配大文件的 location 块里，避免影响小资源（如 JS/CSS）：

location ~ \.(zip|tar\.gz|iso|dmg|exe)$ {
    limit_rate 512k;  # 限制为 512 KB/s（注意：k 表示 1024 字节）
    # 或写成 limit_rate 524288; 效果相同
}

支持动态调整：用变量实现差异化限速

可以通过内置变量（如 $arg_speed、$http_x_limit_rate）让客户端自行协商或后端注入限速值：

允许 URL 带参数控制（如 /file.zip?speed=1m）：
limit_rate $arg_speed;（需确保 $arg_speed 格式合法，否则会退化为 0）
根据请求头设置（如 API 调用方传 X-Limit-Rate: 256k）：
limit_rate $http_x_limit_rate;
结合 map 做更安全的映射（推荐）：
先定义合法速率白名单，再绑定变量，避免任意输入导致配置失效。

注意细节：单位、生效时机与调试技巧

几个关键点容易踩坑：

k 表示 1024 字节，m 表示 1024×1024 字节；写 100k ≠ 100KB/s（≈97.7 KiB/s），但日常使用足够近似
限速从响应头发送完毕、开始发 body 时才启动；如果文件很小或启用了 sendfile，可能几乎感觉不到限速效果
配合 limit_rate_after 10m 可实现“前 10MB 不限速，之后限速”，改善首屏/小文件体验
用 curl -v http://x/file.zip 2>&1 | grep '^ 查看响应头中是否含 <code>X-Response-Time 类字段辅助判断；更直接的方式是用 curl --limit-rate 模拟客户端限速对比效果