如何利用 stream_upstream_module 实现 TCP 协议的加权轮询负载均衡-Nginx-PHP中文网

要用 stream_upstream_module 实现 tcp 协议的加权轮询负载均衡，核心是正确启用 stream 模块、在顶层 stream 块中定义 upstream，并为每个后端 server 显式设置 weight 参数。

如何利用 stream_upstream_module 实现 tcp 协议的加权轮询负载均衡

要用 stream_upstream_module 实现 TCP 协议的加权轮询负载均衡，核心是正确启用 stream 模块、在顶层 stream 块中定义 upstream，并为每个后端 server 显式设置 weight 参数。它不依赖应用层信息，只按权重比例分发新建 TCP 连接。

确认并启用 stream 模块

Nginx 默认不编译该模块，必须手动启用：

重新 configure 时添加 --with-stream 参数（如：./configure --with-stream）
执行 make（不要 make install，避免覆盖线上配置）
用 nginx -V 2>&1 | grep -o with-stream 验证输出是否含 with-stream
若已运行旧版，替换二进制文件后执行 nginx -s reload

编写加权轮询 upstream 配置

在 nginx.conf 顶层（与 http 块同级）添加 stream 块，例如：

Nginx Hosting

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

下载

stream {
    upstream tcp_backend {
        server 192.168.10.10:8080 weight=5;
        server 192.168.10.11:8080 weight=3;
        server 192.168.10.12:8080 weight=2;
    }

    server {
        listen 8080;
        proxy_pass tcp_backend;
        proxy_timeout 30s;
    }
}

说明：

权重值为整数，代表相对分配比例（如 5:3:2 表示三台服务器接收连接的比例）
未写 weight 的 server 默认为 weight=1
加权轮询是默认算法，无需额外声明 round_robin
所有 server 行必须带端口，不可省略

配合健康检查提升稳定性

加权轮询本身不自动剔除故障节点，需叠加基础或主动健康检查：

基础被动检查：在 server 行后加 max_fails=3 fail_timeout=30s，连续失败 3 次则暂停转发 30 秒
主动探测（Nginx ≥ 1.11.5）：使用 health_check 指令，例如对 MySQL 可发握手包：
health_check interval=5s fails=2 passes=2 port=3306;
注意：TCP 主动检查依赖三次握手成功，UDP 则需搭配 match 块模拟响应校验