Nginx Stream模块可实现TCP/UDP层反向代理，适用于数据库、SSH等场景；需确认启用with-stream编译选项，配置置于顶层stream块中，支持超时、缓冲、健康检查与故障转移。
想用 Nginx 做 TCP 层的反向代理？Stream 模块就是答案。它不处理 HTTP，而是直接转发原始 TCP（或 UDP）流量，适合数据库、SSH、Redis、自定义协议等场景。
确认 Nginx 已启用 Stream 模块
Stream 模块默认不编译进大多数预装包（如 Ubuntu 的 apt 安装版）。需确认是否支持：
- 运行 nginx -V 2>&1 | grep -o with-stream，若输出 with-stream，说明已启用
- 若无输出，需重新编译 Nginx 并添加 --with-stream 参数；或改用官方预编译包（如 nginx.org 提供的 stable 版）
- Debian/Ubuntu 用户可尝试安装 nginx-full 包（含 Stream 支持）
基础 TCP 代理配置示例
在 nginx.conf 的顶层（不在 http { } 块内）添加 stream 块：
<font size="2">stream {
upstream backend_db {
server 192.168.1.10:5432; # PostgreSQL 实例
server 192.168.1.11:5432 backup;
}
<pre class="brush:php;toolbar:false;">server {
listen 5433; # 网关监听端口
proxy_pass backend_db;
proxy_timeout 1h;
proxy_responses 1;
}
}
注意：stream 块与 http 块平级；server 指令在 stream 上下文中表示“监听一个 TCP 端口”，不是 HTTP 虚拟主机。
关键代理行为控制
Stream 模块不解析应用层协议，但可通过以下指令影响连接生命周期和转发逻辑：
- proxy_timeout：设置客户端连接空闲超时（默认 6s），建议设为业务能接受的最大等待时间
- proxy_responses：限制后端响应数（如设为 1 表示只转发第一个响应包后即关闭连接，适用于请求-响应式协议）
- proxy_buffer_size：设置缓冲区大小（默认 8k），对高吞吐协议（如 MySQL 二进制日志流）可适当调大
- proxy_bind：指定出口网卡 IP，用于多网卡环境或源地址保持
简单健康检查与故障转移
Stream 模块原生支持基础健康检测（仅 TCP 连通性）：
<font size="2">upstream backend_redis {
server 10.0.0.5:6379 max_fails=3 fail_timeout=30s;
server 10.0.0.6:6379 backup;
}
<p>server {
listen 6380;
proxy_pass backend_redis;
proxy_timeout 5s;
}</p></font>
当某节点连续 3 次 TCP 握手失败（30 秒内），Nginx 将其标记为不可用，30 秒后自动重试；backup 服务器仅在其他节点全不可用时启用。
