Nginx Stream模块虽不支持weight权重,但可通过least_conn、hash一致性哈希、TCP健康检查及SNI分流等机制实现高效稳定流量分发。

Nginx Stream 模块做 TCP 转发本身不支持 weight 权重,但可以通过合理组合机制实现高效、稳定、可运维的流量分发策略。关键不是强行加权,而是选对场景、用对方法。
确认模块可用性与基础结构
高效转发的前提是模块已正确启用:
- 运行 nginx -V 2>&1 | grep with-stream,输出含 --with-stream 才表示支持
- 配置必须放在 main 上下文(与 events、http 同级),不能嵌在 http 块内
- stream 块中只允许 upstream 和 server 指令,无 location、rewrite 等七层语法
选择合适的负载均衡逻辑
Stream 层默认使用轮询(round-robin),但可根据业务特性切换更匹配的策略:
- least_conn:适合连接生命周期长、并发数差异大的服务(如数据库、SSH)
- hash $remote_addr consistent:保障同一客户端始终打到同一后端,适用于有状态连接或会话亲和需求
- hash $binary_remote_addr:比普通 remote_addr 更节省内存,IPv4/IPv6 兼容性更好
- 避免使用 ip_hash(仅限 HTTP 模块),stream 中无效
引入健康检查提升可用性
纯转发不等于“甩手掌柜”,必须让 Nginx 主动感知后端状态:
- 在 upstream 的 server 行中加入 max_fails=3 fail_timeout=30s,自动摘除连续失败节点
- 搭配 slow_start=60s,新上线节点逐步承接流量,防止雪崩
- 注意:stream 不支持 HTTP 类型的主动探针(如 GET /health),只能依赖 TCP 连通性判断
通过端口或 SNI 实现逻辑权重分流
虽然不能直接设 weight,但可通过外部可控维度达成近似效果:
- 为不同比例的后端组分配独立监听端口(如 9001 → A 组,9002 → B 组),再由上游网关/DNS 控制流量配比
- 对 TLS 流量,启用 ssl_preread on,用 map $ssl_server_name 将域名映射到不同 upstream,实现基于 SNI 的路由分流
- 该方式不增加连接延迟,且便于灰度发布和版本隔离
不复杂但容易忽略——高效不在参数多,而在每个配置项是否贴合真实流量特征。


















