nginx本身不支持上传速率平滑限流，但可通过client_max_body_size和client_body_timeout实现软性带宽控制：前者拒绝超限请求体，后者中断慢速上传，结合location精准生效，达到防资源耗尽的实际效果。
Nginx 本身不支持对上传流量（即客户端向服务端发送请求体）进行“速率平滑限流”，比如像 limit_rate 那样按 KB/s 动态匀速限制上传速度。它没有类似 client_upload_rate 的原生命令。但可以通过组合配置实现实用、可控、防资源耗尽的上传行为管控，核心思路是：用超时和大小拦截代替速率控制，达到事实上的“软性限流”效果。
上传限流的关键配置项
Nginx 对上传过程真正起作用的两个指令是：
-
client_max_body_size：直接拒绝超过指定体积的请求体 -
client_body_timeout：在接收请求体过程中，若客户端传输过慢或中断，Nginx 等待多久后断开连接
这两个参数虽不叫“限速”，却是生产环境中最有效、最稳定的上传带宽控制手段。
client_max_body_size 20m;
→ 所有上传请求体不能超过 20MB。避免小带宽用户上传数小时占用 worker 连接。client_body_timeout 15s;
→ 假设用户上传一个 10MB 文件，若平均速率低于约 680KB/s（10×1024×1024 ÷ 15），Nginx 就会中断连接。这相当于隐式设定了最低有效上传速率门槛。
✅ 实际效果：不是匀速限 1MB/s，而是“快就放行，太慢就断”。既防止慢速上传长期占连接，又不干扰正常高速上传。
配合 location 精准生效
把上传相关限制放在特定路径下，避免影响普通接口：
location /upload/ {
client_max_body_size 50m;
client_body_timeout 30s;
# 后端代理保持稳定
proxy_pass http://backend;
proxy_set_header Host $host;
}
这样 /upload/ 路径下的所有 POST/PUT 请求都会受控，而其他接口不受影响。
补充：为什么不用 limit_req 控制上传？
limit_req 限制的是请求被接受的频率（如每秒最多 5 次 /upload 请求），但它：
- 不限制单个请求体的上传速度或总大小
- 不干预 TCP 数据流传输过程
- 对大文件上传几乎无感——一次上传只算 1 个请求，哪怕传 2 小时
所以它适合防刷接口，但不解决上传带宽问题。
更进一步的场景适配
- 若需区分用户级别限上传：可结合
map提取$http_x_user_id或$arg_token，再配合client_body_timeout动态设置（需 OpenResty + Lua） - 若需记录慢上传行为：开启 access log，用
$request_time和$body_bytes_sent辅助分析异常上传模式 - 若必须硬限速：需在应用层（如后端服务读取 body 时做流控）或前置 LB（如 Envoy）中实现，Nginx 不提供该能力
不复杂但容易忽略
