Nginx Stream 代理配置全解析：TCP/UDP 流量转发及常见问题排查
Nginx 除了可以处理 HTTP 代理，还可以用于 TCP/UDP 流量转发，适用于 数据库代理（MySQL、PostgreSQL）、Redis 负载均衡、WebSocket 代理、游戏服务器流量分发 等场景。相比 HAProxy，Nginx 配置更加灵活，并且可以结合 stream 模块进行高效的 TCP/UDP 代理。
本篇文章将带你深入了解 Nginx Stream 代理的配置方法、负载均衡策略，以及常见问题的解决方案，帮助你优化流量转发，提高系统稳定性。
1. 启用 Nginx Stream 模块
默认情况下，Nginx 并不会自动启用 stream 模块，需要在编译时添加支持（如果你使用的是主流 Linux 发行版，如 Ubuntu、CentOS，自带的 Nginx 版本通常已经包含 stream 模块）。
• 检查是否支持 stream 模块
nginx -V 2>&1 | grep stream
如果输出包含 --with-stream，说明 stream 模块已启用，否则需要重新编译 Nginx。
2. 配置 TCP/UDP 代理
Nginx stream 模块的基本用法如下：
stream {
upstream mysql_backend {
server 192.168.1.10:3306;
server 192.168.1.11:3306 backup;
}
server {
listen 3306;
proxy_pass mysql_backend;
}
}
📌 示例解析：
• 监听 3306 端口，将 MySQL 请求转发到 mysql_backend 组
• upstream 组中定义了两台 MySQL 服务器（主服务器 + 备用服务器）
• 当主服务器宕机时，Nginx 会自动切换到 backup 服务器
📌 适用场景：
• MySQL 读写分离
• Redis 代理（监听 6379，转发到 Redis 集群）
• TCP WebSocket 代理
3. 配置 UDP 代理（DNS、RTP、游戏服务器）
UDP 代理的方式类似于 TCP，只需要添加 udp 关键字：
stream {
upstream dns_backend {
server 8.8.8.8:53;
server 8.8.4.4:53;
}
server {
listen 53 udp;
proxy_pass dns_backend;
}
}
📌 示例解析：
• 监听 53 端口（DNS 请求），并将流量转发至 Google DNS 服务器
• 适用于 DNS 代理、视频流、VoIP、游戏服务器等 UDP 场景
4. 负载均衡策略
在 stream 代理中，Nginx 提供了多种负载均衡方式：
| 负载均衡策略 | 说明 |
|---|---|
| round-robin（默认） | 轮询分发请求 |
| least_conn | 选择连接最少的服务器 |
| hash $remote_addr | 按客户端 IP 进行哈希，适用于长连接 |
示例：使用最少连接负载均衡 Redis
stream {
upstream redis_backend {
least_conn;
server 192.168.1.10:6379;
server 192.168.1.11:6379;
}
server {
listen 6379;
proxy_pass redis_backend;
}
}
📌 适用场景：
• least_conn 适用于 长连接服务（MySQL、Redis、PostgreSQL）
• hash 适用于 确保相同用户访问同一后端服务器
5. TLS 加密（安全性增强）
如果要在 stream 代理中启用 TLS，需要添加 ssl_preread 配置。
stream {
server {
listen 443 ssl;
proxy_pass backend_https;
ssl_preread on;
}
upstream backend_https {
server 192.168.1.10:443;
server 192.168.1.11:443;
}
}
📌 适用场景：
• SSL 负载均衡
• HTTPS WebSocket 代理
• 加密数据库通信
6. 常见问题及解决方案
❌ 问题 1：Nginx 启动时报 unknown directive "stream"
💡 原因：Nginx 未编译 stream 模块
🔹 解决方案：重新安装包含 stream 模块的 Nginx
# Ubuntu/Debian
apt install nginx-full -y
# CentOS
yum install nginx-mod-stream -y
❌ 问题 2：TCP 代理后端连接失败
💡 可能原因：
1. Nginx 没有访问后端服务器的权限（检查 firewalld / iptables）
2. 后端端口未开放（netstat -tulnp | grep 3306）
3. SELinux 限制了端口访问（setenforce 0 关闭 SELinux）
🔹 解决方案：
firewall-cmd --add-port=3306/tcp --permanent
firewall-cmd --reload
❌ 问题 3：负载均衡策略不生效
💡 可能原因：
1. least_conn 只在 长连接 场景生效（MySQL、Redis）
2. hash $remote_addr 需要确保 客户端 IP 正确传递
stream {
upstream backend {
least_conn; # 确保启用了 least_conn
}
}
❌ 问题 4：WebSocket 代理失败
💡 可能原因：
1. 未正确传递 Upgrade 头
2. 未启用 proxy_protocol
🔹 解决方案：
stream {
server {
listen 443 proxy_protocol;
proxy_pass backend;
ssl_preread on;
}
}
总结
🔹 Nginx stream 模块 可用于 TCP/UDP 代理、数据库负载均衡、游戏服务器代理
🔹 支持 least_conn / hash 负载均衡策略
🔹 可以结合 ssl_preread 进行 TLS 代理
🔹 遇到 unknown directive "stream" 错误？检查 Nginx 是否编译了 stream 模块！
🔹 遇到连接失败？检查 iptables / firewalld / SELinux
如果你在 Nginx Stream 配置中遇到了问题，欢迎留言讨论！🚀
