长话短说。干了这么多年运维,一定遇到过这种需求:一台服务器只有一个公网IP,但手上好几个HTTPS域名,每个域名对应不同的后端应用,证书也各不相同。常规做法是七层反向代理统一接证书再转发,但如果后端是异构环境——比如一部分是Java、一部分是PHP、还有一部分是专用的云网关——你大概率不想把所有TLS终止都集中在一层。这时候,Nginx的ngx_stream_ssl_preread_module就派上用场了。
这个模块做的事情一句话总结:在四层TCP转发之前,先偷看一次ClientHello里的SNI(服务器名称指示),然后根据域名把流量原样转发给不同的上游服务器,全程不解密、不碰证书、不落地数据。
我在生产环境里用它解决过一个典型的固有问题:多个域名共用443端口、证书各自管理、后端必须直接看到原始TLS握手。这篇就把我的完整配置思路、踩坑记录和排查手法都摊开讲清楚。
1. 内容整体设计与思路拆解
1.1 选型对比:为什么用四层SNI分流,而不是七层反代
很多朋友的第一反应是用nginx的http模块做反向代理,把所有域名的证书全塞到入口,然后按server_name转发。这种方式在站点数量少、团队可以统一管理证书时确实没问题,但有三个场景会出问题:
- 证书分散在各个业务团队手里,每个团队对自己的证书生命周期负责,你没法集中托管。
- 某些设备或协议(比如RDP、自定义游戏协议、某些国产加密通道)压根不是标准HTTPS,七层没法处理,但它们在TLS握手阶段也会发SNI。
- 你想保留后端的源IP、客户端端口等原始连接特征,不做代理改写。
stream模块下的SNI分流,本质上就是一个基于域名规则的TCP路由器。它只识别域名,不关心上层跑的是HTTP还是别的什么协议,连握手的加密字节都不解密,直接流式转发。这让它天然适合做入口网关,也就是所有TCP流量先进来,根据域名去往不同的后端处理。
打个比方:七层反代像小区门口的高速收费站,每辆车都得停下来看行驶证、交费才能进。四层SNI分流则像是ETC,只看一个车牌标记就放行分道,后面的路况、乘客是谁完全不关心。对于跑着多业务的机房来说,效率和隔离性都重要,ETC路线明显更科学。
1.2 SNI工作原理与ngx_stream_ssl_preread_module的介入时机
SNI全称Server Name Indication,是TLS协议的扩展字段。客户端在发ClientHello时,会把这个字段带上,告诉服务端"我要访问哪个域名"——这样一台服务器才能在同一个IP的443端口上挂多个不同证书。正常情况下,这个字段要在完成TCP握手、开始TLS握手之后才出现在网络字节流里。
ngx_stream_ssl_preread_module的巧妙之处在于:它注册在stream处理阶段的ssl_preread钩子点,能通过零拷贝的方式在Nginx内部预读缓冲区里的数据,解析出SNI字段,又不用等待整个TLS握手完成。解析完成之后,你可以在stream配置块里用map指令建立一个域名到上游服务器组的映射关系,再通过proxy_pass把连接发往对应的后端。
这里我必须强调一个容易误解的点:这个模块不参与证书校验、不强行走TLS握手。它只是"预读"了TLS明文握手包里的域名信息,然后就用这个信息做路由。数据到达后端后,后端真正地完成TLS握手。整个转发过程中,Nginx保持的是纯TCP透传角色。
1.3 部署形态:单一大入口,多业务复用
我实际用的是一个很典型的部署拓扑:
code复制客户端 → 防火墙/负载均衡(Nginx stream) → 后端A(域A.example.com集群)
→ 后端B(域B.example.com单机)
→ 后端C(域C.example.com多副本)
入口只有一个公网IP,443端口只监听一次,由Nginx四层层来做域名的第一次仲裁。后端各自维护自己的证书、会话和业务逻辑,互不干扰。升级某个后端时,不需要动入口配置。
这种形态最大的优势不在于“省一个证书”,而在于职责分离。业务团队可以自己申请证书、自己更新重启,只要IP和端口不变,入口层完全不需要跟着折腾。对于多团队合作的运维环境,这种解耦带来的幸福感是难以言喻的。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心配置细节与实操要点
2.1 确认模块是否安装:最常见的起步坑
Nginx很多默认发行的版本并不包含ngx_stream_ssl_preread_module,因为stream模块在早期是作为可选
