nginx的limit_rate_after通过“错峰释放”实现资源公平:前n字节全速传输关键内容,超阈值后按limit_rate匀速下发,每个请求独立计数且支持range续传。

Nginx 的 limit_rate_after 就是为解决这类“资源倾斜”问题设计的:它让客户端在下载起步阶段获得最大带宽,快速加载关键内容(比如视频首帧、安装包头部、PDF 封面),之后再平稳切入限速,避免单个大文件长期霸占带宽。
核心不是“限制”,而是“错峰释放”
它不靠中断或重定向,而是在单次响应流中动态切换速率——前 N 字节走系统吞吐能力(磁盘 + 网络),超阈值后立刻按 limit_rate 匀速下发。每个请求独立计数,断点续传也重新开始。
一、基础配置:明确触发点与限速值
必须成对写在同一个 location 块里,缺一不可:
location ~ \.(zip|iso|mp4|dmg)$ {
root /data/assets;
limit_rate_after 5m; # 前 5MB 全速(5 × 1024 × 1024 字节)
limit_rate 300k; # 超过后固定为 300KB/s(300 × 1024 字节/秒)
}
-
5m和300k是常用组合:小文件(≤5MB)全程无感;大文件开头快,后续可控。 - 单位严格区分大小写:
m✅,M❌;不支持MB或小数(如5.5m会报错)。 - 若文件总大小 ≤
limit_rate_after值,则limit_rate完全不生效。
二、适配真实场景的细节处理
Range 请求友好
用户暂停再续传时,Nginx 从Range: bytes=10485760-开始发送,limit_rate_after仍以本次响应实际发送字节数为基准——即续传的前 5MB 同样全速,无需额外配置。-
避免压缩干扰计数
如果启用了gzip on,压缩会改变响应体字节数,导致阈值误判。建议在限速 location 中显式关闭:gzip off;
静态文件路径要准
使用alias时注意末尾斜杠匹配;用root时确保 URI 路径能正确拼出物理路径。错误的路径会导致 404,限速自然失效。
三、进阶控制:按文件大小或类型差异化
想只对真正的大文件限速?用 map + $sent_http_content_length 动态判断:
map $sent_http_content_length $rate_val {
~^[1-9][0-9]{7,} 256k; # ≥10MB(10^7 字节)才启用 256KB/s
default 0; # 其他不限速
}
server {
location ~ \.pdf$ {
root /data/docs;
limit_rate_after 2m;
limit_rate $rate_val;
}
}
注意:
$sent_http_content_length是响应头里的Content-Length,需文件有确定长度(非流式生成)。PHP 或 proxy 场景慎用。
四、验证是否生效的小技巧
-
用
curl模拟前段下载并观察速率变化:curl -r 0-5242879 https://example.com/file.zip | pv -br > /dev/null
前 5MB 应接近带宽上限;接着再请求剩余部分,速率应稳定在设定值附近。
-
查看 access log 加入变量辅助分析:
log_format rate_log '$remote_addr - $request_time "$request" $status $sent_bytes'; access_log /var/log/nginx/rate.log rate_log;
对比不同请求的
$sent_bytes与$request_time,可算出实际平均速率。
不复杂但容易忽略。











