# 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://angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) модуль не собирается по умолчанию; его необходимо
включить с помощью [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#configure)
`‑‑with‑stream_ssl_preread_module`.
В пакетах и образах из
[наших репозиториев](https://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://angie.software//angie/docs/configuration/configfile.md#configfile) | `ssl_preread` `on` | `off`; |
|------------------------------------------------------------------------------------------|-------------------------------|
| По умолчанию | `ssl_preread off;` |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | stream, server |
Разрешает извлекать информацию из сообщения ClientHello на этапе
[предварительного чтения](https://angie.software//angie/docs/configuration/processing.md#stream-sessions).
## Встроенные переменные
### `$ssl_preread_protocol`
Максимальная версия протокола SSL, поддерживаемая клиентом.
### `$ssl_preread_server_name`
Имя сервера, запрошенное через SNI.
### `$ssl_preread_alpn_protocols`
Список протоколов, переданный клиентом через ALPN.
Значения разделяются запятыми.