Nginx Stream模块专用于TCP/UDP四层转发，适用于MySQL、Redis等非HTTP协议代理与负载均衡；需编译时启用--with-stream，配置置于顶层stream块中，支持健康检查、超时控制及缓冲区调优。
Nginx 的 stream 模块专用于四层（TCP/UDP）转发，适合 MySQL、Redis 等非 HTTP 协议的负载均衡与代理。它不解析应用层内容，只做连接转发，低延迟、高吞吐，是数据库中间件场景的轻量级选择。
启用 stream 模块并配置基础结构
确保编译 Nginx 时已启用 --with-stream（官方预编译包通常默认包含）。在主配置文件（如 /etc/nginx/nginx.conf）顶部添加：
stream {
include /etc/nginx/stream-enabled/*.conf;
}
然后在 /etc/nginx/stream-enabled/ 下新建配置文件（如 mysql.conf），所有 stream 配置都写在 stream { ... } 块内，不能放在 http 块中。
MySQL 四层代理示例（带健康检查）
MySQL 默认走 TCP 3306，stream 模块可做简单负载均衡或单点代理。支持基于连接的被动健康检查（fail_timeout、max_fails）：
upstream mysql_backend {
server 192.168.1.10:3306 max_fails=3 fail_timeout=30s;
server 192.168.1.11:3306 max_fails=3 fail_timeout=30s;
}
<p>server {
listen 3306;
proxy_pass mysql_backend;
proxy_timeout 1h;
proxy_responses 1; # 只需建立连接即认为成功
}</p>- proxy_timeout：建议设长（如 1h），避免空闲连接被意外断开
- proxy_responses 1：表示只要后端完成 TCP 握手并返回至少 1 字节（如 MySQL greeting packet），就视为健康
- 不支持 SQL 层路由（如读写分离），如需该能力应使用 ProxySQL 或 MaxScale
Redis 四层代理（支持单实例与哨兵集群前端）
Redis 协议同样基于 TCP，stream 可代理至单节点或哨兵管理的主节点（注意：stream 无法感知哨兵拓扑变化，需配合外部脚本更新 upstream）：
upstream redis_backend {
server 192.168.1.20:6379 weight=5;
server 192.168.1.21:6379;
}
<p>server {
listen 6379;
proxy_pass redis_backend;
proxy_timeout 1d;
proxy_buffer_size 16k; # 缓冲区大小影响大 payload 转发稳定性
}</p>-
proxy_buffer_size：Redis 响应可能较大（如
KEYS *结果），适当调高避免截断 - 若后端是 Redis 哨兵集群，建议将
upstream指向一个始终指向当前 master 的 VIP 或本地代理（如用redis-sentinel+keepalived），而非直接列多个哨兵节点 - stream 不解析 RESP 协议，因此无法实现基于命令的路由（如把
SET发往 master、GET发往 replica）
关键注意事项与调试技巧
- 日志独立：stream 日志需单独配置
access_log和error_log，位置在stream块或server块内，路径与 http 日志不共享 - SSL 透传：stream 支持
ssl_preread模块识别 TLS SNI，但 MySQL/Redis 原生 SSL 连接会被完整透传，Nginx 不解密 - 调试连接：用
telnet或nc测试端口连通性；用tcpdump抓包确认流量是否经由 Nginx 中转 - 权限问题：若监听 1–1023 端口（如 3306），启动用户需有绑定特权端口权限（root 启动后 drop 权限，或用
setcap 'cap_net_bind_service=+ep' /usr/sbin/nginx）
