annotate xml/ru/docs/http/ngx_http_v2_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents d13341d3c54a
children b74f2038f2b5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
2
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
3 <!--
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
5 -->
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
6
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
8
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
9 <module name="Модуль ngx_http_v2_module"
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
10 link="/ru/docs/http/ngx_http_v2_module.html"
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
11 lang="ru"
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
12 rev="14">
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
13
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
14 <section id="summary">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
15
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
16 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
17 Модуль <literal>ngx_http_v2_module</literal> (1.9.5) обеспечивает
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
18 поддержку <link url="https://tools.ietf.org/html/rfc7540">HTTP/2</link>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
19 и заменяет
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
20 модуль <link doc="ngx_http_spdy_module.xml">ngx_http_spdy_module</link>.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
21 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
22
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
23 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
24 По умолчанию этот модуль не собирается, его сборку необходимо разрешить
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
25 с помощью конфигурационного параметра
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
26 <literal>--with-http_v2_module</literal>.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
27 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
28
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
29 </section>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
30
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
31
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
32 <section id="issues" name="Известные проблемы">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
33
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
34 <para>
1671
5154b356a1b2 Unbuffered request body upload support in http2.
Ruslan Ermilov <ru@nginx.com>
parents: 1670
diff changeset
35 До версии 1.9.14
5154b356a1b2 Unbuffered request body upload support in http2.
Ruslan Ermilov <ru@nginx.com>
parents: 1670
diff changeset
36 буферизация тела запроса клиента не могла быть запрещена
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
37 независимо от
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
38 значения директив
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
39 <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
40 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
41 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/> и
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
42 <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
43 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
44
2567
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
45 <para>
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
46 До версии 1.19.1
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
47 механизм <link doc="ngx_http_core_module.xml" id="lingering_close"/>
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
48 не использовался в управлении закрытием HTTP/2-соединений.
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
49 </para>
4f3494d80949 Documented support for HTTP/2 in lingering_close.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2450
diff changeset
50
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
51 </section>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
52
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
53
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
54 <section id="example" name="Пример конфигурации">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
55
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
56 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
57 <example>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
58 server {
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
59 listen 443 ssl http2;
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
60
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
61 ssl_certificate server.crt;
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
62 ssl_certificate_key server.key;
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
63 }
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
64 </example>
1693
c841e77fcc1d Added missing comma.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1671
diff changeset
65 Чтобы принимать HTTP/2-соединения по TLS, необходимо
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
66 наличие поддержки расширения “Application-Layer Protocol Negotiation” (ALPN)
1670
e28e4e0b8520 Revised http2 module translation.
Ruslan Ermilov <ru@nginx.com>
parents: 1667
diff changeset
67 протокола TLS, появившейся лишь в
e28e4e0b8520 Revised http2 module translation.
Ruslan Ermilov <ru@nginx.com>
parents: 1667
diff changeset
68 <link url="http://www.openssl.org">OpenSSL</link> версии 1.0.2.
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
69 Работа расширения “Next Protocol Negotiation” (NPN) протокола TLS
1670
e28e4e0b8520 Revised http2 module translation.
Ruslan Ermilov <ru@nginx.com>
parents: 1667
diff changeset
70 (поддерживаемого начиная с OpenSSL версии 1.0.1) в данном случае не гарантируется.
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
71 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
72
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
73 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
74 Если
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
75 директива <link doc="ngx_http_ssl_module.xml" id="ssl_prefer_server_ciphers"/>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
76 установлена в значение “<literal>on</literal>”,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
77 <link doc="ngx_http_ssl_module.xml" id="ssl_ciphers">шифры</link>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
78 должны быть настроены таким образом, чтобы соответствовать чёрному списку
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
79 <link url="https://tools.ietf.org/html/rfc7540#appendix-A">RFC 7540, Appendix A</link>,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
80 а также поддерживаться клиентами.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
81 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
82
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
83 </section>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
84
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
85
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
86 <section id="directives" name="Директивы">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
87
2142
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
88 <directive name="http2_body_preread_size">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
89 <syntax><value>размер</value></syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
90 <default>64k</default>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
91 <context>http</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
92 <context>server</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
93 <appeared-in>1.11.0</appeared-in>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
94
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
95 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
96 Задаёт <value>размер</value> буфера для каждого запроса,
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
97 в который может сохраняться тело запроса
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
98 до того, как оно начнёт обрабатываться.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
99 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
100
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
101 </directive>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
102
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 2105
diff changeset
103
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
104 <directive name="http2_chunk_size">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
105 <syntax><value>размер</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
106 <default>8k</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
107 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
108 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
109 <context>location</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
110
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
111 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
112 Задаёт максимальный размер частей,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
113 на которое будет разделяться тело ответа.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
114 Слишком маленькое значение может привести к росту накладных расходов.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
115 Слишком большое значение может негативно сказаться на приоритизации из-за
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
116 <link url="http://en.wikipedia.org/wiki/Head-of-line_blocking">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
117 блокировки очереди</link>.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
118 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
119
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
120 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
121
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
122
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
123 <directive name="http2_idle_timeout">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
124 <syntax><value>время</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
125 <default>3m</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
126 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
127 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
128
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
129 <para>
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
130 <note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
131 Эта директива устарела начиная с версии 1.19.7.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
132 Вместо неё следует использовать директиву
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
133 <link doc="ngx_http_core_module.xml" id="keepalive_timeout"/>.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
134 </note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
135 </para>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
136
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
137 <para>
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
138 Задаёт таймаут неактивности, после которого соединение закрывается.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
139 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
140
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
141 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
142
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
143
2105
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
144 <directive name="http2_max_concurrent_pushes">
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
145 <syntax><value>число</value></syntax>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
146 <default>10</default>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
147 <context>http</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
148 <context>server</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
149 <appeared-in>1.13.9</appeared-in>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
150
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
151 <para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
152 Ограничивает максимальное число параллельных
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
153 <link id="http2_push">push</link>-запросов в соединении.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
154 </para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
155
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
156 </directive>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
157
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
158
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
159 <directive name="http2_max_concurrent_streams">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
160 <syntax><value>число</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
161 <default>128</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
162 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
163 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
164
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
165 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
166 Задаёт максимальное число параллельных HTTP/2-потоков
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
167 в соединении.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
168 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
169
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
170 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
171
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
172
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
173 <directive name="http2_max_field_size">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
174 <syntax><value>размер</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
175 <default>4k</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
176 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
177 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
178
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
179 <para>
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
180 <note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
181 Эта директива устарела начиная с версии 1.19.7.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
182 Вместо неё следует использовать директиву
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
183 <link doc="ngx_http_core_module.xml" id="large_client_header_buffers"/>.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
184 </note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
185 </para>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
186
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
187 <para>
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
188 Ограничивает максимальный размер
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
189 заголовка запроса, сжатого при помощи
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1834
diff changeset
190 <link url="https://tools.ietf.org/html/rfc7541">HPACK</link>.
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
191 Ограничение применяется в равной степени как к имени, так и к значению.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
192 Если применяется кодирование Хаффмана,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
193 то фактический размер распакованных строк имени и значения может быть больше.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
194 Ограничение по умолчанию подходит для большинства запросов.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
195 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
196
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
197 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
198
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
199
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
200 <directive name="http2_max_header_size">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
201 <syntax><value>размер</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
202 <default>16k</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
203 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
204 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
205
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
206 <para>
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
207 <note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
208 Эта директива устарела начиная с версии 1.19.7.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
209 Вместо неё следует использовать директиву
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
210 <link doc="ngx_http_core_module.xml" id="large_client_header_buffers"/>.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
211 </note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
212 </para>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
213
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
214 <para>
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
215 Ограничивает максимальный размер всего списка заголовков запроса после
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1834
diff changeset
216 распаковки <link url="https://tools.ietf.org/html/rfc7541">HPACK</link>.
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
217 Ограничение по умолчанию подходит для большинства запросов.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
218 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
219
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
220 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
221
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
222
1834
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
223 <directive name="http2_max_requests">
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
224 <syntax><value>число</value></syntax>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
225 <default>1000</default>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
226 <context>http</context>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
227 <context>server</context>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
228 <appeared-in>1.11.6</appeared-in>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
229
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
230 <para>
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
231 <note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
232 Эта директива устарела начиная с версии 1.19.7.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
233 Вместо неё следует использовать директиву
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
234 <link doc="ngx_http_core_module.xml" id="keepalive_requests"/>.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
235 </note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
236 </para>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
237
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
238 <para>
2105
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
239 Задаёт максимальное число запросов (включая
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
240 <link id="http2_push">push</link>-запросы), которые можно
1834
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
241 сделать по одному соединению HTTP/2,
2105
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
242 после чего очередной клиентский запрос приведёт к закрытию соединения
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
243 и необходимости установить новое соединение.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
244 </para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
245
2450
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
246 <para>
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
247 Периодическое закрытие соединений необходимо для освобождения
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
248 памяти, выделенной под конкретные соединения.
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
249 Поэтому использование слишком большого максимального числа запросов
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
250 может приводить к чрезмерному потреблению памяти и не рекомендуется.
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
251 </para>
a26a42699207 Added note about max number of keepalive requests.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2142
diff changeset
252
2105
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
253 </directive>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
254
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
255
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
256 <directive name="http2_push">
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
257 <syntax><value>uri</value> | <literal>off</literal></syntax>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
258 <default>off</default>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
259 <context>http</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
260 <context>server</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
261 <context>location</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
262 <appeared-in>1.13.9</appeared-in>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
263
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
264 <para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
265 Заблаговременно отправляет
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
266 (<link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>) запрос
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
267 к заданному <value>uri</value>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
268 вместе с ответом на оригинальный запрос.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
269 Будут обработаны только относительные URI с абсолютными путями,
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
270 например:
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
271 <example>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
272 http2_push /static/css/main.css;
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
273 </example>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
274 В значении <value>uri</value> допустимо использование переменных.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
275 </para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
276
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
277 <para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
278 На одном уровне конфигурации можно указать несколько
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
279 <literal>http2_push</literal> директив.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
280 Параметр <literal>off</literal> отменяет действие
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
281 унаследованных с предыдущего уровня конфигурации
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
282 директив <literal>http2_push</literal>.
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
283 </para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
284
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
285 </directive>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
286
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
287
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
288 <directive name="http2_push_preload">
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
289 <syntax><literal>on</literal> | <literal>off</literal></syntax>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
290 <default>off</default>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
291 <context>http</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
292 <context>server</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
293 <context>location</context>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
294 <appeared-in>1.13.9</appeared-in>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
295
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
296 <para>
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
297 Разрешает автоматическое преобразование
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
298 <link url="https://www.w3.org/TR/preload/#server-push-http-2">preload
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
299 links</link>,
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
300 указанных в полях <header>Link</header> заголовка ответа, в
d45887ccafde Documented HTTP/2 server push.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2038
diff changeset
301 <link url="https://tools.ietf.org/html/rfc7540#section-8.2">push</link>-запросы.
1834
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
302 </para>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
303
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
304 </directive>
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
305
1d0811707e09 Documented the "http2_max_requests" directive.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1707
diff changeset
306
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
307 <directive name="http2_recv_buffer_size">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
308 <syntax><value>размер</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
309 <default>256k</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
310 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
311
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
312 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
313 Задаёт размер входного буфера для
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
314 <link doc="../ngx_core_module.xml" id="worker_processes">рабочего
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
315 процесса</link>.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
316 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
317
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
318 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
319
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
320
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
321 <directive name="http2_recv_timeout">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
322 <syntax><value>время</value></syntax>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
323 <default>30s</default>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
324 <context>http</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
325 <context>server</context>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
326
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
327 <para>
2654
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
328 <note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
329 Эта директива устарела начиная с версии 1.19.7.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
330 Вместо неё следует использовать директиву
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
331 <link doc="ngx_http_core_module.xml" id="client_header_timeout"/>.
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
332 </note>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
333 </para>
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
334
d13341d3c54a Marked some directives as obsolete in HTTP/2.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2567
diff changeset
335 <para>
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
336 Задаёт таймаут в случае, когда от клиента ожидаются ещё данные,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
337 после которого соединение закрывается.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
338 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
339
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
340 </directive>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
341
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
342 </section>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
343
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
344
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
345 <section id="variables" name="Встроенные переменные">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
346
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
347 <para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
348 Модуль <literal>ngx_http_v2_module</literal>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
349 поддерживает следующие встроенные переменные:
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
350 <list type="tag" compact="no">
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
351
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
352 <tag-name id="var_http2"><var>$http2</var></tag-name>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
353 <tag-desc>
1670
e28e4e0b8520 Revised http2 module translation.
Ruslan Ermilov <ru@nginx.com>
parents: 1667
diff changeset
354 согласованный идентификатор протокола:
1667
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
355 “<literal>h2</literal>” для HTTP/2 через TLS,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
356 “<literal>h2c</literal>” для HTTP/2 через незашифрованный TCP,
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
357 либо пустая строка.
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
358 </tag-desc>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
359
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
360 </list>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
361 </para>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
362
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
363 </section>
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
364
beab8345acf6 Translated the http/2 module into Russian.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
diff changeset
365 </module>