如何利用 stream_upstream_module 模块在四层 TCP 代理中配置加权轮询-Nginx-PHP中文网

nginx stream 模块原生支持加权轮询，需启用 with-stream 编译选项，在 stream{} 块中定义 upstream 并为 server 设置 weight 整数值，通过 proxy_pass 引用实现连接级负载均衡。

如何利用 stream_upstream_module 模块在四层 tcp 代理中配置加权轮询

直接在 stream 块中用 upstream 定义后端组，通过 weight 参数指定各节点权重即可实现加权轮询。它不依赖额外模块——stream_upstream_module 并非独立模块，而是 Nginx stream 模块内置的 upstream 功能部分。

确认 stream 模块已启用

加权轮询的前提是 Nginx 已编译并启用了 stream 模块：

运行 nginx -V 2>&1 | grep -o with-stream，输出含 with-stream 才表示支持
若无输出，需重新编译：添加 --with-stream（及可选 --with-stream_ssl_module）参数
注意：stream 是与 http 同级的顶级块，不能写在 http{} 内部

配置加权轮询 upstream 组

在 stream{} 块中定义 upstream，为每个 server 显式设置 weight 值（默认为 1）：

权重数值为整数，越大代表分配连接概率越高
所有节点必须指定完整地址（IP:PORT），端口不可省略
支持健康检查参数，如 max_fails=3 fail_timeout=30s，故障时自动摘除

示例：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

stream {
    upstream app_backend {
        server 192.168.5.10:9501 weight=3;
        server 192.168.5.11:9501 weight=1;
        server 192.168.5.12:9501 weight=2;
    }
}

绑定监听端口并启用代理

用 server 块监听客户端请求端口，并通过 proxy_pass 指向 upstream 名称：

listen 指令指定对外暴露的 TCP 端口（如 listen 8443;）
proxy_pass 必须引用已定义的 upstream 名称，不能写 IP 或域名
建议设置 proxy_timeout（如 proxy_timeout 1h;）适配长连接场景

完整片段示例：

stream {
    upstream app_backend {
        server 192.168.5.10:9501 weight=3;
        server 192.168.5.11:9501 weight=1;
        server 192.168.5.12:9501 weight=2;
    }

    server {
        listen 8443;
        proxy_pass app_backend;
        proxy_timeout 1h;
        proxy_responses 1;
    }
}