Mercurial > hg > nginx-site
changeset 2790:a281f61b5ad8
Documented the ssl_alpn directive.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Mon, 01 Nov 2021 21:16:24 +0000 |
parents | d16409187314 |
children | 9385526a9b2d |
files | xml/en/docs/stream/ngx_stream_ssl_module.xml xml/ru/docs/stream/ngx_stream_ssl_module.xml |
diffstat | 2 files changed, 61 insertions(+), 2 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/stream/ngx_stream_ssl_module.xml +++ b/xml/en/docs/stream/ngx_stream_ssl_module.xml @@ -9,7 +9,7 @@ <module name="Module ngx_stream_ssl_module" link="/en/docs/stream/ngx_stream_ssl_module.html" lang="en" - rev="26"> + rev="27"> <section id="summary"> @@ -79,6 +79,35 @@ stream { <section id="directives" name="Directives"> +<directive name="ssl_alpn"> +<syntax><value>protocol</value> ...</syntax> +<default/> +<context>stream</context> +<context>server</context> +<appeared-in>1.21.4</appeared-in> + +<para> +Specifies the list of supported +<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link> protocols. +One of the protocols must be +<link id="var_ssl_alpn_protocol">negotiated</link> if the client uses ALPN: +<example> +map $ssl_alpn_protocol $proxy { + h2 127.0.0.1:8001; + http/1.1 127.0.0.1:8002; +} + +server { + listen 12346; + proxy_pass $proxy; + ssl_alpn h2 http/1.1; +} +</example> +</para> + +</directive> + + <directive name="ssl_certificate"> <syntax><value>file</value></syntax> <default/>
--- a/xml/ru/docs/stream/ngx_stream_ssl_module.xml +++ b/xml/ru/docs/stream/ngx_stream_ssl_module.xml @@ -9,7 +9,7 @@ <module name="Модуль ngx_stream_ssl_module" link="/ru/docs/stream/ngx_stream_ssl_module.html" lang="ru" - rev="26"> + rev="27"> <section id="summary"> @@ -79,6 +79,36 @@ stream { <section id="directives" name="Директивы"> +<directive name="ssl_alpn"> +<syntax><value>протокол</value> ...</syntax> +<default/> +<context>stream</context> +<context>server</context> +<appeared-in>1.21.4</appeared-in> + +<para> +Задаёт список поддерживаемых +протоколов +<link url="https://datatracker.ietf.org/doc/html/rfc7301">ALPN</link>. +Один из протоколов должен быть +<link id="var_ssl_alpn_protocol">согласован</link>, если клиент использует ALPN: +<example> +map $ssl_alpn_protocol $proxy { + h2 127.0.0.1:8001; + http/1.1 127.0.0.1:8002; +} + +server { + listen 12346; + proxy_pass $proxy; + ssl_alpn h2 http/1.1; +} +</example> +</para> + +</directive> + + <directive name="ssl_certificate"> <syntax><value>файл</value></syntax> <default/>