stream 模块允许 Nginx 处理 TCP 和 UDP 流量，常用于负载均衡和端口转发等场景。本文将详细介绍如何检查 Nginx 是否支持 stream 模块，以及在需要时如何启用该模块。
1. 检查 Nginx 是否支持 stream 模块
首先，需要确认当前安装的 Nginx 是否已经编译并启用了 stream 模块。可以通过以下命令查看 Nginx 的编译参数：
nginx -V 2>&1 | grep -- '--with-stream'
• 有输出：表示 Nginx 已支持 stream 模块。
• 无输出：说明 Nginx 未编译 stream 模块，需要按照后续方法进行启用。
2. 启用 stream 模块的方法
如果当前 Nginx 不支持 stream 模块，可以选择以下几种方法之一来启用该模块。
方法 1：安装支持 stream 模块的官方 Nginx 版本
Ubuntu 的默认仓库可能不包含支持 stream 模块的 Nginx 版本。你可以通过添加 Nginx 官方仓库来安装支持 stream 模块的版本。
步骤 1：添加 Nginx 官方仓库
运行以下命令以添加 Nginx 官方 GPG 密钥和软件源：
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/ubuntu $(lsb_release -cs) nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
sudo apt update
步骤 2：安装 Nginx
安装最新版本的 Nginx：
sudo apt install nginx
步骤 3：验证 stream 模块
安装完成后，检查是否支持 stream 模块：
nginx -V 2>&1 | grep -- '--with-stream'
• 如果仍然不支持，可能需要安装特定版本的 Nginx（如 nginx-extras），请参考方法 3。
方法 2：重新编译 Nginx 以启用 stream 模块
如果官方仓库中的版本仍不支持 stream 模块，可以手动编译 Nginx 并启用所需模块。
步骤 1：安装编译依赖
确保系统已安装编译 Nginx 所需的依赖包：
sudo apt update
sudo apt install build-essential libpcre3 libpcre3-dev libssl-dev zlib1g zlib1g-dev
步骤 2：下载 Nginx 源码
前往 Nginx 官方下载页面 获取最新版本的源码包，或者使用以下命令下载指定版本（以 1.25.3 为例）：
wget https://nginx.org/download/nginx-1.25.3.tar.gz
tar -zxvf nginx-1.25.3.tar.gz
cd nginx-1.25.3
步骤 3：获取当前 Nginx 编译参数（可选）
如果你已经安装了 Nginx，可以获取当前的编译参数，以便在重新编译时保留这些配置：
nginx -V 2>&1 | grep -- '--add-module'
将输出的参数记录下来，稍后在重新编译时使用。
步骤 4：配置编译选项
运行 ./configure 脚本并添加 --with-stream 参数。如果需要保留现有的编译参数，可以将之前记录的参数一并添加。例如：
./configure --with-stream [其他参数]
示例（假设之前记录的参数为 --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf）：
./configure --with-stream --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf
如果不确定其他参数，可以直接运行：
./configure --with-stream
步骤 5：编译并安装
编译源码并安装 Nginx：
make
sudo make install
步骤 6：验证安装
安装完成后，验证 stream 模块是否已启用：
nginx -V 2>&1 | grep -- '--with-stream'
• 有输出：表示 stream 模块已成功启用。
注意：手动编译安装的 Nginx 不会被系统的包管理器管理，建议备份原有配置并谨慎操作。
方法 3：使用 nginx-extras 包
某些 Linux 发行版的官方仓库提供了包含 stream 模块的 nginx-extras 包，可以简化安装过程。
步骤 1：安装 nginx-extras
运行以下命令安装 nginx-extras：
sudo apt update
sudo apt install nginx-extras
步骤 2：验证 stream 模块
安装完成后，检查 stream 模块是否启用：
nginx -V 2>&1 | grep -- '--with-stream'
• 有输出：表示 stream 模块已成功启用。
注意：nginx-extras 包含了额外的模块，可能会占用更多的系统资源。如果只需要 stream 模块，可以考虑其他方法以减少资源占用。
3. 配置 stream 模块示例
启用 stream 模块后，可以在 Nginx 配置文件中使用 stream 块来处理 TCP/UDP 流量。以下是一个简单的负载均衡配置示例：
stream {
upstream backend {
server backend1.example.com:12345;
server backend2.example.com:12345;
server backend3.example.com:12345;
}
server {
listen 12345;
proxy_pass backend;
# 可选配置
proxy_timeout 1h;
proxy_connect_timeout 10s;
}
}
配置说明
• upstream 块：定义了一组后端服务器，Nginx 将流量分发到这些服务器。
• server 块：监听指定的端口（如 12345），并将接收到的流量转发到 upstream 定义的后端服务器。
• 可选配置：
• proxy_timeout：设置代理连接的超时时间。
• proxy_connect_timeout：设置连接到后端服务器的超时时间。
4. 测试并重新加载 Nginx 配置
完成配置后，建议先测试配置文件的语法是否正确，再重新加载 Nginx 以应用更改。
测试配置文件
sudo nginx -t
预期输出：
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
重新加载 Nginx
如果配置测试通过，重新加载 Nginx 以应用新配置：
sudo systemctl reload nginx
5. 常见问题排查
5.1 无法找到 stream 模块
• 确认安装方法：确保按照上述方法正确安装了支持 stream 模块的 Nginx 版本。
• 检查编译参数：使用 nginx -V 确认 --with-stream 参数已包含在编译选项中。
5.2 配置文件语法错误
• 详细错误信息：运行 nginx -t 查看具体的错误提示，根据提示修正配置文件中的问题。
• 日志查看：检查 Nginx 的错误日志获取更多信息，日志文件通常位于 /var/log/nginx/error.log。
5.3 权限问题
• 配置文件权限：确保 Nginx 配置文件的权限正确，通常应为 644，且所有者为 root。
• 目录权限：确保 Nginx 有权限访问配置中指定的目录和文件。
6. 总结
通过上述方法，你可以在 Ubuntu 系统上启用 Nginx 的 stream 模块，并利用其强大的流量处理能力来满足各种需求。选择合适的方法安装或编译 Nginx，确保配置文件的正确性，并定期监控和维护 Nginx 服务，以实现高效稳定的运行。