# SSL Preread
启用从
[ClientHello](https://datatracker.ietf.org/doc/html/rfc5246#section-7.4.1.2)
消息中提取信息而不终止 TLS，
例如通过 [SNI](https://datatracker.ietf.org/doc/html/rfc6066#section-3)
请求的服务器名称或在
[ALPN](https://datatracker.ietf.org/doc/html/rfc7301)
中广告的协议。
当 [从源代码构建](https://cn.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) 时，
默认情况下不会构建此模块；
它应该通过
`‑‑with‑stream_ssl_preread_module`
[构建选项](https://cn.angie.software//angie/docs/installation/sourcebuild.md#configure) 启用。
在来自 [我们的仓库](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 的包和镜像中，
该模块已包含在构建中。
## 配置示例
### 通过服务器名称选择上游
```nginx
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;
}
```
### 通过协议选择服务器
```nginx
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 协议版本选择服务器
```nginx
map $ssl_preread_protocol $upstream {
"" ssh.example.com:22;
"TLSv1.2" new.example.com:443;
default tls.example.com:443;
}
# ssh 和 https 在同一端口
server {
listen 192.168.0.1:443;
proxy_pass $upstream;
ssl_preread on;
}
```
## 指令
### ssl_preread
| [语法](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile) | `ssl_preread` `on` | `off`; |
|--------------------------------------------------------------------------------------|-------------------------------|
| 默认 | `ssl_preread off;` |
| [上下文](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile) | stream, server |
在 [预读取](https://cn.angie.software//angie/docs/configuration/processing.md#stream-sessions) 阶段启用从 ClientHello 消息中提取信息。
## 内置变量
### `$ssl_preread_protocol`
客户端支持的最高 SSL 协议版本。
### `$ssl_preread_server_name`
通过 SNI 请求的服务器名称。
### `$ssl_preread_alpn_protocols`
客户端通过 ALPN 广告的协议列表。
这些值用逗号分隔。