Nginx Stream模块专用于TCP/UDP四层转发，不解析HTTP等应用层协议，适用于数据库、Redis等场景；需在nginx.conf顶层配置stream块，支持负载均衡、SNI透传和UDP转发。
Nginx 的 Stream 模块专用于四层（TCP/UDP）流量转发，不解析应用层协议（如 HTTP），因此适合数据库、Redis、SMTP、自定义 TCP 服务等场景的负载均衡与端口转发。启用后可实现高性能、低延迟的透明代理。
启用 Stream 模块并配置基础结构
确保编译 Nginx 时已启用 --with-stream（官方预编译包通常默认包含）。在主配置文件 nginx.conf 的顶层（不能放在 http {} 块内）添加 stream 块：
- 检查是否支持：运行 nginx -V 2>&1 | grep -o with-stream，有输出即表示已启用
- 在 nginx.conf 最外层（events 块同级）添加 stream { ... }
- 每个 upstream 和 server 都需定义在 stream 块内，彼此独立于 http 配置
配置 TCP 负载均衡（如 MySQL 或 Redis）
以 Redis 集群为例，将客户端请求轮询分发到多个后端节点：
- 定义 upstream 组，支持 least_conn、hash $remote_addr consistent（IP 一致性哈希）、round_robin（默认）等策略
- server 块监听公网端口（如 6380），proxy_pass 指向 upstream 名称，不带协议头
- 可启用 proxy_timeout、proxy_responses 控制连接生命周期和健康检测行为
示例片段：
upstream redis_backend {
least_conn;
server 192.168.1.10:6379 weight=3;
server 192.168.1.11:6379 backup;
}
server {
listen 6380;
proxy_pass redis_backend;
proxy_timeout 1s;
proxy_responses 1;
}
}
实现单端口多目标转发（条件式 TCP 透传）
Stream 模块本身不支持基于内容（如 TLS SNI 或数据包 payload）路由，但可通过 ssl_preread 模块提取 SNI 字段，实现 HTTPS/SSL 流量的后端分发：
- 需开启 ssl_preread on;，并在 listen 指令中加 ssl 参数
- 使用 $ssl_preread_server_name 变量匹配不同域名，配合 map 构建动态 upstream
- 适用于同一 IP + 443 端口承载多个 HTTPS 服务（如不同 Web 应用或 gRPC over TLS）
注意：该方式仅读取 TLS 握手首包，不终止 SSL，完全透传加密流。
UDP 转发与简单健康检查
Stream 同样支持 UDP（如 DNS、Syslog），但需显式声明 udp 协议：
- server 块中使用 listen 53 udp;，upstream 中 server 行末尾加 udp;
- UDP 无连接状态，proxy_responses 可设为期望收到的响应包数（如 DNS 查询设为 1）
- 原生不支持主动健康检查，可通过外部脚本 + health_check（Nginx Plus）或被动检测（fail_timeout + max_fails）模拟
验证配置：执行 nginx -t，再 nginx -s reload 生效。连接测试建议用 telnet、nc 或专用客户端（如 redis-cli -p 6380），避免浏览器干扰。
