Nginx 实战教程:如何同时配置 HTTP 代理与四层 Stream 代理双重网关

云伟大大_8458

云伟大大_8458

2026-06-23

672人浏览

原创

可以同时配置http代理与四层stream代理,二者互不干扰,只需在nginx.conf中分属不同同级配置块;需确保stream模块已启用(--with-stream编译)、正确加载模块、stream与http平级且端口不冲突。

nginx 实战教程:如何同时配置 http 代理与四层 stream 代理双重网关

可以同时配置 HTTP 代理与四层 Stream 代理,二者互不干扰,只需在 nginx.conf 中分属不同配置块即可。关键在于结构清晰、模块启用正确、端口不冲突。

确认 Stream 模块已启用

Stream 模块不是默认内置,编译时必须显式开启:--with-stream。验证方式:

  • 执行 nginx -V 2>&1 | grep -o with-stream,输出含 with-stream 表示已启用
  • 若未启用,需重新编译安装;主流发行版(如 Ubuntu 的 apt 包、CentOS 的 EPEL)通常已默认包含该模块

配置结构:http 与 stream 平级共存

两者是同级模块,不能嵌套。正确写法是将 stream { ... } 块放在 http { ... } 块之外(通常置于 http 块上方或下方),例如:

Nginx Config Linter
Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载
  • 主配置文件顶部加载模块:load_module modules/ngx_stream_core_module.so;
  • 然后依次定义:stream { ... } 和 http { ... },顺序无关,但建议 stream 在前
  • 避免把 stream 配置写进 http 块内,否则会报错“unknown directive ‘stream’”

分别配置 HTTP 七层代理与 Stream 四层代理

各自独立定义 upstream 和 server,端口、协议、用途完全分离:

  • HTTP 代理示例:监听 80 端口,反向代理 Web 应用
    http { upstream web_backend { server 10.0.1.10:8080; } server { listen 80; location / { proxy_pass http://web_backend; } } }
  • Stream 代理示例:监听 3306 端口,转发 MySQL 流量
    stream { upstream mysql_pool { server 10.0.2.20:3306; server 10.0.2.21:3306; } server { listen 3306; proxy_pass mysql_pool; proxy_timeout 1h; } }
  • 两个服务可共用同一台 Nginx 服务器,只要监听端口不重叠(如 80 和 3306 无冲突)

实用技巧与避坑提醒

混合部署时容易忽略的细节:

  • 日志分离:HTTP 日志走 access_log,Stream 不支持 access_log,但可通过 error_log notice 查看连接建立/断开事件
  • 健康检查:Stream 支持 health_check(需配合 zone),但仅限 TCP 连通性检测,无法像 HTTP 那样校验状态码或响应体
  • TLS 处理:HTTP 模块可做 SSL 终止;Stream 模块支持 ssl_preread on 实现 SNI 透传,或直接终止 TLS(需配证书)
  • reload 安全性:修改 stream 块后执行 nginx -t && nginx -s reload,会同时重载 http 和 stream 配置,无需单独重启

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

383

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3307

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

5985

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

561

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1476

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3938

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

457

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

159

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习