upload_limit_rate

`upload_limit_rate` 指令控制 NGINX 中文件上传的最大上传速度。

语法upload_limit_rate size;
默认值none
上下文http, server, location, if in location
参数1

说明

upload_limit_rate 指令用于管理到服务器的文件上传速率。该指令允许配置对传入文件上传的带宽限制,以字节/秒表示。通过设置此限制,管理员可以在上传高峰时通过限制从客户端接收数据的速率来防止服务器资源被压垮。该指令可以用像 1m 这样的值来指定最大上传速率为每秒 1 兆字节,或者使用像 500k 这样的其他字节级别表示(表示千字节)。

该指令可用于多种上下文,包括 httpserverlocation,以及位于 location 块内的 if。该设置影响在定义块下处理的所有上传,确保每个上传都遵守指定的速率限制。此外,这对于在高负载场景下改善用户体验尤其有用,因为它有助于更均匀地分配带宽,并能防止因大量上传导致的服务器过载。

需要注意的是,此指令并不限制被上传的数据总量;它仅控制上传的速度,从而影响上传完成所需的时间。因此,用户可能会遇到更长的上传时间,而不是被限制上传功能。

配置示例

location /upload {
    upload_pass /handle_upload;
    upload_store /tmp/uploads;
    upload_limit_rate 1m;
}

指定非常低的速率可能会导致超时或上传失败,尤其是对于大型文件。

在嵌套上下文中使用多个upload_limit_rate指令时要谨慎,因为最具体的指令优先,这可能导致意外行为。

← 返回所有指令