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 后自动恢复探测
不复杂但容易忽略
