在 nginx 源码编译时添加 stream 四层代理模块,需要在执行 configure 脚本时加入 --with-stream 参数。该参数会启用 nginx 的流处理核心功能,使其具备 tcp/udp 负载均衡和代理能力。配置完成后,通过 make 和 make install 即可完成安装,生成的二进制文件将包含四层代理支持。

如何验证 stream 模块是否已正确加载
编译安装完成后,可以通过命令行工具检查 Nginx 的二进制文件是否集成了 stream 模块。使用 -V 参数(大写)运行 Nginx 可执行文件,可以查看详细的编译配置信息。如果输出中包含 --with-stream,则说明模块已成功嵌入。此外,还可以尝试启动 Nginx 并查看错误日志,若未报错且能正常解析包含 stream 块的配置文件,则进一步确认功能可用。

./nginx -V
假设我们刚刚完成编译安装,Nginx 位于 /usr/local/nginx/sbin/nginx。执行上述命令后,终端应输出类似以下内容:
nginx version: nginx/1.24.0 built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04) ... configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/run/nginx.pid --lock-path=/run/nginx.lock --with-stream --with-http_ssl_module ...
重点观察 configure arguments 部分,其中必须明确列出 --with-stream。如果没有这一项,说明编译时遗漏了该参数,需要重新执行 configure 并添加此选项。注意区分 -v(小写)和 -V(大写),前者仅显示版本号,后者才显示编译参数。
Stream 模块的基本配置与测试方法
启用模块后,需要在 nginx.conf 中定义 stream 上下文来配置四层代理。与 HTTP 模块不同,stream 块通常位于 http 块之外或同级位置,用于监听 TCP 或 UDP 端口并将流量转发到后端服务器。一个简单的配置包括 stream 块、upstream 组以及 server 监听规则。通过这种方式,可以实现对非 HTTP 协议(如 MySQL、Redis 或自定义 TCP 服务)的负载均衡。

stream {
upstream backend_db {
server 192.168.1.100:3306;
server 192.168.1.101:3306;
}
server {
listen 1234;
proxy_pass backend_db;
}
}
以上配置演示了一个基本的 TCP 负载均衡场景。Nginx 监听本地端口 1234,并将所有连接请求转发到 backend_db 上游组中的数据库服务器。这种配置允许在不修改应用层代码的情况下,对底层服务进行流量分发。测试时,可以使用 telnet 或 nc 命令连接到 localhost:1234,观察连接是否能成功建立并转发至后端。确保防火墙允许该端口的入站流量,并检查 Nginx 错误日志以排除权限或绑定冲突问题。


















