Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_spdy_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
parents | 5ea0a0ff7271 |
children | 9a8d15333a58 |
rev | line source |
---|---|
869 | 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_spdy_module" | |
10 link="/ru/docs/http/ngx_http_spdy_module.html" | |
11 lang="ru" | |
1580
c711a8a1a8f9
Changed ID from "bugs" to "issues" for http/2, perl, spdy.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1578
diff
changeset
|
12 rev="10"> |
869 | 13 |
14 <section id="summary"> | |
15 | |
16 <para> | |
17 Модуль <literal>ngx_http_spdy_module</literal> обеспечивает экспериментальную | |
18 поддержку <link url="http://www.chromium.org/spdy/spdy-protocol">SPDY</link>. | |
19 В настоящий момент реализован | |
1058
2ef5a63ce6e2
Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents:
1051
diff
changeset
|
20 <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft3-1">draft |
2ef5a63ce6e2
Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents:
1051
diff
changeset
|
21 3.1</link> протокола SPDY. |
2ef5a63ce6e2
Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents:
1051
diff
changeset
|
22 <note> |
2ef5a63ce6e2
Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents:
1051
diff
changeset
|
23 До версии 1.5.10 был реализован |
869 | 24 <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2">draft |
25 2</link> протокола SPDY. | |
1058
2ef5a63ce6e2
Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents:
1051
diff
changeset
|
26 </note> |
869 | 27 </para> |
28 | |
29 <para> | |
30 По умолчанию этот модуль не собирается, его сборку необходимо | |
31 разрешить с помощью конфигурационного параметра | |
32 <literal>--with-http_spdy_module</literal>. | |
33 </para> | |
34 | |
1566
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
35 <para> |
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
36 <note> |
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
37 Этот модуль был заменён модулем |
1719 | 38 <link doc="ngx_http_v2_module.xml">ngx_http_v2_module</link> |
1566
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
39 в версии 1.9.5. |
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
40 </note> |
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
41 </para> |
0ca33afb461b
Added the http2 module.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1447
diff
changeset
|
42 |
869 | 43 </section> |
44 | |
45 | |
1580
c711a8a1a8f9
Changed ID from "bugs" to "issues" for http/2, perl, spdy.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1578
diff
changeset
|
46 <section id="issues" name="Известные проблемы"> |
869 | 47 |
48 <para> | |
49 Модуль экспериментальный, поэтому возможно всё. | |
50 </para> | |
51 | |
52 <para> | |
53 Текущая реализация протокола SPDY не поддерживает server push. | |
54 </para> | |
55 | |
56 <para> | |
1250
9fbe66ff4f7c
SPDY: latin letter "c" changed to cyrillic "c".
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1058
diff
changeset
|
57 До версии 1.5.9 скорость передачи ответа клиенту в SPDY-соединении не могла быть |
886
ca9a259cb5c8
The SPDY module does not support "limit_rate", not "limit_req".
Valentin Bartenev <vbart@nginx.com>
parents:
869
diff
changeset
|
58 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничена</link>. |
869 | 59 </para> |
60 | |
1447
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
61 <para> |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
62 Буферизация тела запроса клиента не может быть выключена |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
63 независимо от значения директив |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
64 <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering"/>, |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
65 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering"/>, |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
66 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering"/> и |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
67 <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering"/>. |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
68 </para> |
a32df48d88fc
Documented that proxy_request_buffering is on with SPDY enabled.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1250
diff
changeset
|
69 |
869 | 70 </section> |
71 | |
72 | |
73 <section id="example" name="Пример конфигурации"> | |
74 | |
75 <para> | |
76 <example> | |
77 server { | |
78 listen 443 ssl spdy; | |
79 | |
80 ssl_certificate server.crt; | |
81 ssl_certificate_key server.key; | |
82 ... | |
83 } | |
84 </example> | |
85 <note> | |
86 Для того чтобы одновременно принимать | |
87 <link doc="ngx_http_ssl_module.xml">HTTPS</link> и | |
88 SPDY соединения на том же порту, | |
89 используемая библиотека <link url="http://www.openssl.org">OpenSSL</link> | |
90 должна поддерживать расширение Next Protocol Negotiation протокола TLS, | |
91 доступное с версии OpenSSL 1.0.1. | |
92 </note> | |
93 </para> | |
94 | |
95 </section> | |
96 | |
97 | |
98 <section id="directives" name="Директивы"> | |
99 | |
1051
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
100 <directive name="spdy_chunk_size"> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
101 <syntax><value>размер</value></syntax> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
102 <default>8k</default> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
103 <context>http</context> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
104 <context>server</context> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
105 <context>location</context> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
106 <appeared-in>1.5.9</appeared-in> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
107 |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
108 <para> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
109 Задаёт максимальный размер частей, |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
110 на которые будет |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
111 <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2#TOC-Data-frames"> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
112 разделяться</link> тело ответа. |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
113 Слишком маленькое значение может |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
114 привести к росту накладных расходов. |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
115 Слишком большое значение может |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
116 негативно сказаться на приоритизации из-за |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
117 <link url="http://en.wikipedia.org/wiki/Head-of-line_blocking"> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
118 блокировки очереди</link>. |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
119 </para> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
120 |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
121 </directive> |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
122 |
29de277bf322
Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents:
1050
diff
changeset
|
123 |
869 | 124 <directive name="spdy_headers_comp"> |
125 <syntax><value>степень</value></syntax> | |
126 <default>0</default> | |
127 <context>http</context> | |
128 <context>server</context> | |
129 | |
130 <para> | |
131 Устанавливает <value>степень</value> сжатия заголовков ответа | |
132 в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие). | |
133 Специальное значение 0 отключает сжатие заголовков. | |
134 </para> | |
135 | |
136 </directive> | |
137 | |
138 </section> | |
139 | |
140 | |
141 <section id="variables" name="Встроенные переменные"> | |
142 | |
143 <para> | |
144 Модуль <literal>ngx_http_spdy_module</literal> | |
145 поддерживает следующие встроенные переменные: | |
146 <list type="tag" compact="no"> | |
147 | |
148 <tag-name id="var_spdy"><var>$spdy</var></tag-name> | |
149 <tag-desc> | |
150 версия протокола SPDY для SPDY-соединений, | |
151 либо пустая строка; | |
152 </tag-desc> | |
153 | |
154 <tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var> | |
155 </tag-name> | |
156 <tag-desc> | |
157 приоритет запроса для SPDY-соединений, | |
158 либо пустая строка. | |
159 </tag-desc> | |
160 | |
161 </list> | |
162 </para> | |
163 | |
164 </section> | |
165 | |
166 </module> |