Mercurial > hg > nginx-site

annotate xml/ru/docs/stream/ngx_stream_ssl_preread_module.xml @ 2112:9f7e12cf974f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the $ssl_preread_alpn_protocols variable.
author Vladimir Homutov <vl@nginx.com>
date Fri, 16 Mar 2018 13:37:02 +0300
parents 59d1f512c3a0
children eca16aa19cfa
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
2
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
3 <!--
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
5 -->
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
6
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
8
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
9 <module name="Модуль ngx_stream_ssl_preread_module"
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
10 link="/ru/docs/stream/ngx_stream_ssl_preread_module.html"
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
11 lang="ru"
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
12 rev="2">
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
13
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
14 <section id="summary">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
15
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
16 <para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
17 Модуль <literal>ngx_stream_ssl_preread_module</literal> (1.11.5) позволяет
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
18 извлекать информацию из сообщения
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
19 <link url="https://tools.ietf.org/html/rfc5246#section-7.4.1.2">ClientHello</link>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
20 без терминирования SSL/TLS,
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
21 например имя сервера, запрошенное через
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
22 <link url="https://tools.ietf.org/html/rfc6066#section-3">SNI</link>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
23 или протоколы указанные в
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
24 <link url="https://tools.ietf.org/html/rfc7301">ALPN</link>.
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
25 По умолчанию этот модуль не собирается, его сборку необходимо
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
26 разрешить с помощью конфигурационного параметра
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
27 <literal>--with-stream_ssl_preread_module</literal>.
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
28 </para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
29
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
30 </section>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
31
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
32
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
33 <section id="example" name="Пример конфигурации">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
34
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
35 <para>
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
36
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
37 Выбор сервера по имени:
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
38
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
39 <example>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
40 map $ssl_preread_server_name $name {
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
41 backend.example.com backend;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
42 default backend2;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
43 }
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
44
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
45 upstream backend {
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
46 server 192.168.0.1:12345;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
47 server 192.168.0.2:12345;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
48 }
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
49
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
50 upstream backend2 {
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
51 server 192.168.0.3:12345;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
52 server 192.168.0.4:12345;
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
53 }
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
54
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
55 server {
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
56 listen 12346;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
57 proxy_pass $name;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
58 ssl_preread on;
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
59 }
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
60 </example>
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
61
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
62 Выбор сервера по протоколу:
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
63
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
64 <example>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
65 map $ssl_preread_alpn_protocols $proxy {
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
66 ~\bh2\b 127.0.0.1:8001;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
67 ~\bhttp/1.1\b 127.0.0.1:8002;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
68 ~\bxmpp-client\b 127.0.0.1:8003;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
69 }
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
70
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
71 server {
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
72 listen 9000;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
73 proxy_pass $proxy;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
74 ssl_preread on;
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
75 }
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
76 </example>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
77
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
78 </para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
79
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
80 </section>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
81
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
82
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
83 <section id="directives" name="Директивы">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
84
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
85 <directive name="ssl_preread">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
86 <syntax><literal>on</literal> | <literal>off</literal></syntax>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
87 <default>off</default>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
88 <context>stream</context>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
89 <context>server</context>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
90
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
91 <para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
92 Разрешает извлечение информации из сообщения ClientHello во время фазы
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
93 <link doc="stream_processing.xml" id="preread_phase">предварительного чтения</link>.
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
94 </para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
95
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
96 </directive>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
97
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
98 </section>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
99
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
100
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
101 <section id="variables" name="Встроенные переменные">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
102
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
103 <para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
104 <list type="tag">
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
105
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
106 <tag-name id="var_ssl_preread_server_name"><var>$ssl_preread_server_name</var></tag-name>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
107 <tag-desc>
2112
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
108 имя сервера, запрошенное через SNI
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
109 </tag-desc>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
110
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
111 <tag-name id="var_ssl_preread_alpn_protocols"><var>$ssl_preread_alpn_protocols</var></tag-name>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
112 <tag-desc>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
113 список протоколов, переданный клиентом через ALPN (1.3.10)
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
114 <para>
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
115 Значения разделены запятыми.
9f7e12cf974f Documented the $ssl_preread_alpn_protocols variable.
Vladimir Homutov <vl@nginx.com>
parents: 1798
diff changeset
116 </para>
1798
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
117 </tag-desc>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
118
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
119 </list>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
120 </para>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
121
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
122 </section>
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
123
59d1f512c3a0 Documented the ngx_stream_ssl_preread_module module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
124 </module>