Модуль ngx_stream_ssl_preread_module
Модуль ngx_stream_ssl_preread_module (1.11.5) позволяет извлекать информацию из сообщения ClientHello без завершения SSL/TLS, например, имя сервера, запрошенное через SNI, или протоколы, объявленные в ALPN. Этот модуль не включён по умолчанию, его необходимо включить с помощью параметра конфигурации --with-stream_ssl_preread_module.
Пример конфигурации
Выбор upstream на основе имени сервера:
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;
}
Выбор upstream на основе протокола:
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;
}
Выбор upstream на основе версии 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 on | off; |
|---|---|
| Значение по умолчанию: | ssl_preread off; |
| Контекст: | stream, server |
Включает извлечение информации из сообщения ClientHello на фазе preread.
Встроенные переменные
$ssl_preread_protocol- наивысшая версия SSL протокола, поддерживаемая клиентом (1.15.2)
$ssl_preread_server_name- имя сервера, запрошенное через SNI
$ssl_preread_alpn_protocols- список протоколов, объявленных клиентом через ALPN (1.13.10). Значения разделены запятыми.
© 2002-2021 Igor Sysoev
© 2011-2024 Nginx, Inc.
Licensed under the BSD License.
https://nginx.org/en/docs/stream/ngx_stream_ssl_preread_module.html