模块 ngx_stream_ssl_preread_module
| 示例配置 指令 ssl_preread 嵌入变量 |
模块 ngx_stream_ssl_preread_module(1.11.5 版)允许在不终止 SSL/TLS 的情况下从 ClientHello 消息中提取信息,例如通过 SNI 请求的服务器名称或在 ALPN 中宣布的协议。该模块默认未构建,需要通过 --with-stream_ssl_preread_module 配置参数启用。
示例配置
基于服务器名称选择上游:
map $ssl_preread_server_name $name {
backend.example.com backend;
default backend2;
}
upstream backend {
server 192.168.0.1:12345;
server 192.168.0.2:12345;
}
upstream backend2 {
server 192.168.0.3:12345;
server 192.168.0.4:12345;
}
server {
listen 12346;
proxy_pass $name;
ssl_preread on;
}
基于协议选择上游:
map $ssl_preread_alpn_protocols $proxy {
~\bh2\b 127.0.0.1:8001;
~\bhttp/1.1\b 127.0.0.1:8002;
~\bxmpp-client\b 127.0.0.1:8003;
}
server {
listen 9000;
proxy_pass $proxy;
ssl_preread on;
}
基于 SSL 协议版本选择上游:
map $ssl_preread_protocol $upstream {
"" ssh.example.com:22;
"TLSv1.2" new.example.com:443;
default tls.example.com:443;
}
# ssh and https on the same port
server {
listen 192.168.0.1:443;
proxy_pass $upstream;
ssl_preread on;
}
指令
| 语法: | ssl_preread |
|---|---|
| 默认: |
ssl_preread off; |
| 上下文: | stream, server |
启用在 preread 阶段提取 ClientHello 消息中的信息。
嵌入变量
-
$ssl_preread_protocol - 客户端支持的最高 SSL 协议版本(1.15.2)
-
$ssl_preread_server_name - 通过 SNI 请求的服务器名称
-
$ssl_preread_alpn_protocols - 客户端通过 ALPN 宣布的协议列表(1.13.10)。值用逗号分隔。
