Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_v2_module.xml @ 1667:beab8345acf6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Translated the http/2 module into Russian.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 28 Mar 2016 16:20:01 +0300
parents
children e28e4e0b8520
comparison
equal deleted inserted replaced
1666:08f48ecb13ba 1667:beab8345acf6
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Nginx, Inc.
5 -->
6
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8
9 <module name="Модуль ngx_http_v2_module"
10 link="/ru/docs/http/ngx_http_v2_module.html"
11 lang="ru"
12 rev="5">
13
14 <section id="summary">
15
16 <para>
17 Модуль <literal>ngx_http_v2_module</literal> (1.9.5) обеспечивает
18 поддержку <link url="https://tools.ietf.org/html/rfc7540">HTTP/2</link>
19 и заменяет
20 модуль <link doc="ngx_http_spdy_module.xml">ngx_http_spdy_module</link>.
21 </para>
22
23 <para>
24 По умолчанию этот модуль не собирается, его сборку необходимо разрешить
25 с помощью конфигурационного параметра
26 <literal>--with-http_v2_module</literal>.
27 </para>
28
29 </section>
30
31
32 <section id="issues" name="Известные проблемы">
33
34 <para>
35 Модуль экспериментальный, поэтому возможно всё.
36 </para>
37
38 <para>
39 Буферизация тела запроса клиента не может быть запрещена
40 независимо от
41 значения директив
42 <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>,
43 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>,
44 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/> и
45 <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>.
46 </para>
47
48 </section>
49
50
51 <section id="example" name="Пример конфигурации">
52
53 <para>
54 <example>
55 server {
56 listen 443 ssl http2;
57
58 ssl_certificate server.crt;
59 ssl_certificate_key server.key;
60 }
61 </example>
62
63 Чтобы принимать HTTP/2-соединения по TLS необходимо
64 наличие поддержки расширения “Application-Layer Protocol Negotiation” (ALPN)
65 протокола TLS, появившейся в
66 <link url="http://www.openssl.org">OpenSSL</link> начиная с версии 1.0.2.
67 Работа расширения “Next Protocol Negotiation” (NPN) протокола TLS
68 (доступного начиная с версии OpenSSL 1.0.1) в данном случае не гарантируется.
69 </para>
70
71 <para>
72 Если
73 директива <link doc="ngx_http_ssl_module.xml" id="ssl_prefer_server_ciphers"/>
74 установлена в значение “<literal>on</literal>”,
75 <link doc="ngx_http_ssl_module.xml" id="ssl_ciphers">шифры</link>
76 должны быть настроены таким образом, чтобы соответствовать чёрному списку
77 <link url="https://tools.ietf.org/html/rfc7540#appendix-A">RFC 7540, Appendix A</link>,
78 а также поддерживаться клиентами.
79 </para>
80
81 </section>
82
83
84 <section id="directives" name="Директивы">
85
86 <directive name="http2_chunk_size">
87 <syntax><value>размер</value></syntax>
88 <default>8k</default>
89 <context>http</context>
90 <context>server</context>
91 <context>location</context>
92
93 <para>
94 Задаёт максимальный размер частей,
95 на которое будет разделяться тело ответа.
96 Слишком маленькое значение может привести к росту накладных расходов.
97 Слишком большое значение может негативно сказаться на приоритизации из-за
98 <link url="http://en.wikipedia.org/wiki/Head-of-line_blocking">
99 блокировки очереди</link>.
100 </para>
101
102 </directive>
103
104
105 <directive name="http2_idle_timeout">
106 <syntax><value>время</value></syntax>
107 <default>3m</default>
108 <context>http</context>
109 <context>server</context>
110
111 <para>
112 Задаёт таймаут неактивности, после которого соединение закрывается.
113 </para>
114
115 </directive>
116
117
118 <directive name="http2_max_concurrent_streams">
119 <syntax><value>число</value></syntax>
120 <default>128</default>
121 <context>http</context>
122 <context>server</context>
123
124 <para>
125 Задаёт максимальное число параллельных HTTP/2-потоков
126 в соединении.
127 </para>
128
129 </directive>
130
131
132 <directive name="http2_max_field_size">
133 <syntax><value>размер</value></syntax>
134 <default>4k</default>
135 <context>http</context>
136 <context>server</context>
137
138 <para>
139 Ограничивает максимальный размер
140 заголовка запроса, сжатого при помощи
141 <link url="http://tools.ietf.org/html/rfc7541">HPACK</link>.
142 Ограничение применяется в равной степени как к имени, так и к значению.
143 Если применяется кодирование Хаффмана,
144 то фактический размер распакованных строк имени и значения может быть больше.
145 Ограничение по умолчанию подходит для большинства запросов.
146 </para>
147
148 </directive>
149
150
151 <directive name="http2_max_header_size">
152 <syntax><value>размер</value></syntax>
153 <default>16k</default>
154 <context>http</context>
155 <context>server</context>
156
157 <para>
158 Ограничивает максимальный размер всего списка заголовков запроса после
159 распаковки <link url="http://tools.ietf.org/html/rfc7541">HPACK</link>.
160 Ограничение по умолчанию подходит для большинства запросов.
161 </para>
162
163 </directive>
164
165
166 <directive name="http2_recv_buffer_size">
167 <syntax><value>размер</value></syntax>
168 <default>256k</default>
169 <context>http</context>
170
171 <para>
172 Задаёт размер входного буфера для
173 <link doc="../ngx_core_module.xml" id="worker_processes">рабочего
174 процесса</link>.
175 </para>
176
177 </directive>
178
179
180 <directive name="http2_recv_timeout">
181 <syntax><value>время</value></syntax>
182 <default>30s</default>
183 <context>http</context>
184 <context>server</context>
185
186 <para>
187 Задаёт таймаут в случае, когда от клиента ожидаются ещё данные,
188 после которого соединение закрывается.
189 </para>
190
191 </directive>
192
193 </section>
194
195
196 <section id="variables" name="Встроенные переменные">
197
198 <para>
199 Модуль <literal>ngx_http_v2_module</literal>
200 поддерживает следующие встроенные переменные:
201 <list type="tag" compact="no">
202
203 <tag-name id="var_http2"><var>$http2</var></tag-name>
204 <tag-desc>
205 идентификатор протокола:
206 “<literal>h2</literal>” для HTTP/2 через TLS,
207 “<literal>h2c</literal>” для HTTP/2 через незашифрованный TCP,
208 либо пустая строка.
209 </tag-desc>
210
211 </list>
212 </para>
213
214 </section>
215
216 </module>