nginx tcp代理负载均衡依赖stream模块,需编译启用--with-stream;配置在顶层stream块中,含upstream定义后端、server监听端口、proxy_pass转发,并支持weight、least_conn、health_check等调度与健康检查机制。

确认 Nginx 支持 stream 模块
运行以下命令验证:
nginx -V 2>&1 | grep -o with-stream
若无输出,说明未启用该模块,需重新编译安装。生产环境推荐使用官方预编译包或主流发行版仓库提供的带 stream 支持的版本(如 Ubuntu/Debian 的 nginx-full,CentOS/RHEL 的 nginx-mod-stream)。
基础 TCP 负载均衡配置结构
在 nginx.conf 主配置文件顶层(不在 http 块内) 添加 stream 块:
- upstream 块定义后端服务组:指定真实 TCP 服务地址、端口及调度参数
- server 块定义监听入口:绑定本地端口,设置超时、健康检查、会话保持等
- proxy_pass 指向 upstream 名称:完成流量转发路径绑定
示例(MySQL 3306 负载):
stream {
upstream mysql_cluster {
server 192.168.1.10:3306 weight=3 max_fails=2 fail_timeout=15s;
server 192.168.1.11:3306 weight=2;
server 192.168.1.12:3306 backup;
}
server {
listen 3306;
proxy_pass mysql_cluster;
proxy_timeout 60s;
proxy_connect_timeout 5s;
health_check interval=10s fails=3 passes=2;
}
}
常用调度策略与参数详解
调度行为由 upstream 内部参数和 server 中的指令共同决定:
- weight:加权轮询,默认为 1;值越大分到请求越多,适合异构服务器
- max_fails / fail_timeout:被动健康检查机制;连续失败 max_fails 次后,在 fail_timeout 时间内不参与调度
-
health_check:主动健康检查(需配合
zone参数);支持 TCP 连通性检测,也可扩展为自定义协议(如 MySQL ping) - hash $remote_addr consistent:基于客户端 IP 的一致性哈希,适用于连接有状态的场景(如长连接 Redis)
- least_conn:将新连接分配给当前活跃连接数最少的后端,适合处理耗时差异大的 TCP 会话
注意:ip_hash 在 stream 模块中不可用,应改用 hash $remote_addr 实现类似效果。
关键运维与验证要点
配置生效后需严格验证,避免连接中断或调度异常:
- 修改配置后执行
nginx -t检查语法,再用nginx -s reload热重载 - 用
ss -tlnp | grep :3306确认 Nginx 正确监听目标端口 - 使用
telnet 本机IP 3306或nc -zv 本机IP 3306测试监听可用性 - 连接后端服务时,观察日志(
error_log可设为 info 级别)是否出现no live upstreams或连接拒绝 - 停掉某台后端,确认流量自动切走,并在 fail_timeout 后自动恢复探测
不复杂但容易忽略











