一、为什么需要stream模块
在日常工作中，我们经常遇到需要代理非HTTP协议的场景。比如数据库的TCP连接、邮件服务的SMTP协议、自定义的二进制协议等。传统的HTTP模块对这些协议无能为力，因为它们根本不遵循HTTP规范。这时候，Nginx的stream模块就派上用场了。
stream模块从1.9.0版本开始成为Nginx的核心模块，它工作在传输层(TCP/UDP)，可以对原始TCP/UDP流量进行代理和负载均衡。与HTTP模块不同，它不需要解析应用层协议，因此可以处理任意基于TCP/UDP的协议。
举个例子，假设我们有三台MySQL服务器，想要实现负载均衡和故障转移。使用stream模块可以这样配置：
# 技术栈：Nginx 1.18+
stream {
upstream mysql_servers {
server 192.168.1.101:3306 weight=3; # 主库，权重更高
server 192.168.1.102:3306; # 从库1
server 192.168.1.103:3306; # 从库2
}
server {
listen 3306; # 监听3306端口
proxy_pass mysql_servers; # 代理到MySQL服务器组
proxy_connect_timeout 1s; # 连接超时时间
}
}
二、stream模块基础配置
配置stream模块其实非常简单，它与http模块是平级关系。在nginx.conf中，你可以同时拥有http和stream两个顶级配置块。
一个完整的stream配置通常包含以下几个部分：
- upstream定义后端服务器组
- server定义监听端口和代理规则
- 各种proxy_*参数控制代理行为
来看一个完整的Redis代理示例：
# 技术栈：Nginx 1.20+
stream {
# 定义Redis服务器组
upstream redis_cluster {
server 10.0.0.1:6379 max_fails=2 fail_timeout=30s;
server 10.0.0.2:6379 max_fails=2 fail_timeout=30s;
server 10.0.0.3:6379 max_fails=2 fail_timeout=30s;
}
# 主服务器配置
server {
listen 6379 so_keepalive=on; # 开启TCP keepalive
proxy_pass redis_cluster;
proxy_timeout 3s; # 代理超时时间
proxy_connect_timeout 1s; # 连接后端超时时间
}
# 监控接口配置
server {
listen 127.0.0.1:8080;
return "Redis Proxy is running!\n";
}
}
三、高级特性与实战技巧
stream模块不仅仅能做简单的端口转发，它还支持很多高级特性。让我们通过几个实际案例来看看。
3.1 TCP负载均衡算法
stream模块支持多种负载均衡算法：
# 技术栈：Nginx Plus
stream {
upstream backend {
least_conn; # 最少连接数算法
server backend1.example.com:12345;
server backend2.example.com:12345;
}
}
3.2 SSL/TLS终止
我们可以在stream模块中直接处理SSL/TLS：
# 技术栈：Nginx 1.15+
stream {
# 定义带SSL的后端
upstream secured_backend {
server 192.168.1.200:443;
}
server {
listen 443 ssl; # 监听SSL端口
proxy_pass secured_backend;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
ssl_protocols TLSv1.2 TLSv1.3;
}
}
3.3 UDP协议支持
除了TCP，stream模块还支持UDP协议：
# 技术栈：Nginx 1.9+
stream {
upstream dns_servers {
server 192.168.1.53:53; # DNS服务器1
server 192.168.1.54:53; # DNS服务器2
}
server {
listen 53 udp reuseport; # UDP模式
proxy_pass dns_servers;
proxy_timeout 1s;
}
}
四、应用场景与技术分析
4.1 典型应用场景
- 数据库代理：MySQL、PostgreSQL、Redis等
- 邮件服务代理：SMTP、IMAP、POP3
- 自定义协议代理：游戏服务器、物联网设备通信
- DNS负载均衡
- SSH跳板服务
4.2 技术优缺点
优点：
- 协议无关性：可以代理任何基于TCP/UDP的协议
- 高性能：工作在传输层，比应用层代理效率更高
- 灵活性：支持多种负载均衡算法和健康检查
- 稳定性：Nginx的成熟架构保证了高可用性
缺点：
- 无法做应用层的内容感知
- 对协议特定的优化有限
- 某些高级功能需要Nginx Plus
4.3 注意事项
- 性能调优：适当调整
worker_processes和worker_connections - 连接保持：合理配置
so_keepalive参数 - 超时设置：根据业务特点设置
proxy_timeout - 日志记录：stream模块有自己的access_log格式
- 防火墙配置：确保相关端口已开放
五、完整实战示例
让我们来看一个完整的SMTP代理配置：
# 技术栈：Nginx 1.19+
stream {
# 定义SMTP服务器组
upstream smtp_servers {
server smtp1.example.com:25 weight=5;
server smtp2.example.com:25;
server backup.smtp.example.com:25 backup;
}
# 主服务器配置
server {
listen 25;
proxy_pass smtp_servers;
proxy_connect_timeout 1s;
# 连接数限制
proxy_limit_conn_zone $binary_remote_addr zone=smtp_conn:10m;
proxy_limit_conn smtp_conn 100;
}
# 监控配置
server {
listen 127.0.0.1:8081;
return "SMTP Proxy Status: OK\n";
}
}
六、总结与展望
Nginx的stream模块为我们处理非HTTP协议提供了强大而灵活的解决方案。无论是简单的端口转发，还是复杂的负载均衡场景，它都能胜任。随着微服务架构的流行，对TCP/UDP代理的需求会越来越多，掌握stream模块的使用将成为运维和开发人员的必备技能。
未来，我们可以期待Nginx在协议识别、智能路由等方面有更多创新。同时，与Kubernetes、Docker等云原生技术的深度集成也是值得关注的方向。
评论