Spec-Zone.ru › nginx

Модуль ngx_stream_ssl_preread_module

  • Пример конфигурации
  • Директивы
  • ssl_preread
  • Встроенные переменные

Модуль 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API