proxy_upload_rate

proxy_upload_rate 指令控制 NGINX Stream 中被代理连接的最大上传速率。 — NGINX Stream Core

proxy_upload_rate
streamstream server
语法proxy_upload_rate rate;
默认值none
上下文stream, stream server
模块NGINX Stream Core
参数1

说明

`proxy_upload_rate` 指令在 NGINX Stream 模块中指定被代理连接的最大上传速率。该指令支持带宽整形,适用于需要限制上传速度以防止某个用户占用过多可用带宽的场景。该值通常以字节/秒为单位定义,会直接影响服务器上上传活动的总体性能。 配置后,如果连接尝试以超过定义速率的速度上传数据,NGINX 会暂停传输以执行带宽限制。这有助于在多个用户之间平衡负载并维护所有连接的服务质量。该指令可应用于 `stream` 或 `stream server` 上下文,从而允许在多个服务器实例场景中进行灵活配置。 需要注意的是,指定的上传速率应反映考虑到服务器能力和预期工作负载的现实限制。建议在部署前在预生产环境中仔细测试不同的值,以找到最佳的配置平衡。此外,将上传速率设置得非常高可能会由于网络栈的高开销而引入性能问题。

配置示例

stream {
    server {
        listen 12345;
        proxy_pass backend_server;
        proxy_upload_rate 1m; 
    }
}

确保速率值是实际可行的,以避免性能问题。

如果上游服务器无法良好处理背压,则该指令可能无法按预期生效。此外,在未进行适当调优的情况下使用此指令可能导致带宽未被充分利用,因此必须谨慎考虑这些设置。