Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_v3_module.xml @ 2964:23eedf89fd5d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated QUIC documentation after QUIC code merge. - removed http3_max_concurrent_pushes, http3_push http3_push_preload, quic_mtu - updated apperared-in version - update of quic.xml, adding Rus translation
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 23 May 2023 16:44:47 +0100
parents cebca5ba84d7
children 8b8f94802f41
comparison
equal deleted inserted replaced
2963:c7bf5c9a1174 2964:23eedf89fd5d
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_http_v3_module" 9 <module name="Модуль ngx_http_v3_module"
10 link="/ru/docs/http/ngx_http_v3_module.html" 10 link="/ru/docs/http/ngx_http_v3_module.html"
11 lang="en" 11 lang="en"
12 rev="1"> 12 rev="2">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_v3_module</literal> (1.23.4) обеспечивает 17 Модуль <literal>ngx_http_v3_module</literal> (1.25.0) обеспечивает
18 экспериментальную поддержку 18 экспериментальную поддержку
19 <link url="https://datatracker.ietf.org/doc/html/rfc9114">HTTP/3</link>. 19 <link url="https://datatracker.ietf.org/doc/html/rfc9114">HTTP/3</link>.
20 </para> 20 </para>
21 21
22 <para> 22 <para>
23 По умолчанию этот модуль не собирается, его сборку необходимо 23 По умолчанию этот модуль не собирается, его сборку необходимо
24 разрешить с помощью конфигурационного параметра 24 разрешить с помощью конфигурационного параметра
25 <link doc="../configure.xml"><literal>--with-http_v3_module</literal></link>. 25 <link doc="../configure.xml" id="http_v3_module"><literal>--with-http_v3_module</literal></link>.
26 <note> 26 <note>
27 Для сборки и работы этого модуля рекомендуется использовать 27 Для сборки и работы этого модуля рекомендуется использовать
28 библиотеку SSL с поддержкой QUIC, например 28 библиотеку SSL с поддержкой QUIC, например
29 <link url="https://boringssl.googlesource.com/boringssl">BoringSSL</link>, 29 <link url="https://boringssl.googlesource.com/boringssl">BoringSSL</link>,
30 <link url="https://www.libressl.org">LibreSSL</link>, 30 <link url="https://www.libressl.org">LibreSSL</link>,
35 в котором не поддерживается 35 в котором не поддерживается
36 <link doc="ngx_http_ssl_module.xml" id="ssl_early_data">early data</link>. 36 <link doc="ngx_http_ssl_module.xml" id="ssl_early_data">early data</link>.
37 </note> 37 </note>
38 </para> 38 </para>
39 39
40 <para>
41 <note>
42 Модуль доступен в виде
43 <link doc="../quic.xml" id="linux">готовых пакетов</link>
44 <literal>nginx-quic</literal> для Linux.
45 Модуль также доступен как часть
46 <commercial_version>коммерческой подписки</commercial_version>
47 в виде отдельного пакета <literal>nginx-plus-quic</literal>.
48
49 </note>
50 </para>
51
52 </section> 40 </section>
53 41
54 42
55 <section id="issues" name="Известные проблемы"> 43 <section id="issues" name="Известные проблемы">
56 44
127 </para> 115 </para>
128 116
129 </directive> 117 </directive>
130 118
131 119
132 <directive name="http3_max_concurrent_pushes">
133 <syntax><value>число</value></syntax>
134 <default>10</default>
135 <context>http</context>
136 <context>server</context>
137
138 <para>
139 Ограничивает максимальное число параллельных
140 <link id="http3_push">push</link>-запросов в соединении.
141 </para>
142
143 </directive>
144
145
146 <directive name="http3_max_concurrent_streams"> 120 <directive name="http3_max_concurrent_streams">
147 <syntax><value>число</value></syntax> 121 <syntax><value>число</value></syntax>
148 <default>128</default> 122 <default>128</default>
149 <context>http</context> 123 <context>http</context>
150 <context>server</context> 124 <context>server</context>
151 125
152 <para> 126 <para>
153 Задаёт максимальное число параллельных HTTP/3-потоков 127 Задаёт максимальное число параллельных HTTP/3-потоков
154 в соединении. 128 в соединении.
155 </para>
156
157 </directive>
158
159
160 <directive name="http3_push">
161 <syntax><value>uri</value> | <literal>off</literal></syntax>
162 <default>off</default>
163 <context>http</context>
164 <context>server</context>
165 <context>location</context>
166
167 <para>
168 Заблаговременно отправляет
169 (<link url="https://datatracker.ietf.org/doc/html/rfc9114#name-server-push">push</link>) запрос
170 к заданному <value>uri</value>
171 вместе с ответом на оригинальный запрос.
172 Будут обработаны только относительные URI с абсолютными путями,
173 например:
174 <example>
175 http3_push /static/css/main.css;
176 </example>
177 В значении <value>uri</value> допустимо использование переменных.
178 </para>
179
180 <para>
181 На одном уровне конфигурации можно указать несколько
182 <literal>http3_push</literal> директив.
183 Параметр <literal>off</literal> отменяет действие
184 унаследованных с предыдущего уровня конфигурации
185 директив <literal>http3_push</literal>.
186 </para>
187
188 </directive>
189
190
191 <directive name="http3_push_preload">
192 <syntax><literal>on</literal> | <literal>off</literal></syntax>
193 <default>off</default>
194 <context>http</context>
195 <context>server</context>
196 <context>location</context>
197
198 <para>
199 Разрешает автоматическое преобразование
200 <link url="https://www.w3.org/TR/preload/#server-push-http-3">preload
201 links</link>,
202 указанных в полях <header>Link</header> заголовка ответа, в
203 <link url="https://datatracker.ietf.org/doc/html/rfc9114#name-server-push">push</link>-запросы.
204 </para> 129 </para>
205 130
206 </directive> 131 </directive>
207 132
208 133
286 <para> 211 <para>
287 Задаёт <value>файл</value> с секретным ключом, применяемым при шифровании 212 Задаёт <value>файл</value> с секретным ключом, применяемым при шифровании
288 stateless reset и address validation токенов. 213 stateless reset и address validation токенов.
289 По умолчанию создаётся случайный ключ при каждой перезагрузке. 214 По умолчанию создаётся случайный ключ при каждой перезагрузке.
290 Токены, созданные при помощи старых ключей, не принимаются. 215 Токены, созданные при помощи старых ключей, не принимаются.
291 </para>
292
293 </directive>
294
295
296 <directive name="quic_mtu">
297 <syntax><value>размер</value></syntax>
298 <default>65527</default>
299 <context>http</context>
300 <context>server</context>
301
302 <para>
303 Устанавливает
304 значение транспортного параметра QUIC <literal>max_udp_payload_size</literal>.
305 Это максимально возможное значение для получения UDP payload.
306 </para> 216 </para>
307 217
308 </directive> 218 </directive>
309 219
310 220