Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_spdy_module.xml @ 1058:2ef5a63ce6e2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented SPDY/3.1 support.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 04 Feb 2014 16:46:25 +0400
parents 29de277bf322
children 9fbe66ff4f7c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
2
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
3 <!--
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
4 Copyright (C) Nginx, Inc.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
5 -->
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
6
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
8
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
9 <module name="Модуль ngx_http_spdy_module"
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
10 link="/ru/docs/http/ngx_http_spdy_module.html"
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
11 lang="ru"
1058
2ef5a63ce6e2 Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents: 1051
diff changeset
12 rev="5">
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
13
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
14 <section id="summary">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
15
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
16 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
17 Модуль <literal>ngx_http_spdy_module</literal> обеспечивает экспериментальную
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
18 поддержку <link url="http://www.chromium.org/spdy/spdy-protocol">SPDY</link>.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
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
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
24 <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2">draft
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
25 2</link> протокола SPDY.
1058
2ef5a63ce6e2 Documented SPDY/3.1 support.
Ruslan Ermilov <ru@nginx.com>
parents: 1051
diff changeset
26 </note>
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
27 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
28
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
29 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
30 По умолчанию этот модуль не собирается, его сборку необходимо
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
31 разрешить с помощью конфигурационного параметра
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
32 <literal>--with-http_spdy_module</literal>.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
33 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
34
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
35 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
36
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
37
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
38 <section id="bugs" name="Известные проблемы">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
39
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
40 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
41 Модуль экспериментальный, поэтому возможно всё.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
42 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
43
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
44 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
45 Текущая реализация протокола SPDY не поддерживает server push.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
46 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
47
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
48 <para>
1050
85804d815ed3 The SPDY module now supports "limit_rate".
Valentin Bartenev <vbart@nginx.com>
parents: 886
diff changeset
49 До версии 1.5.9 cкорость передачи ответа клиенту в SPDY-соединении не могла быть
886
ca9a259cb5c8 The SPDY module does not support "limit_rate", not "limit_req".
Valentin Bartenev <vbart@nginx.com>
parents: 869
diff changeset
50 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничена</link>.
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
51 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
52
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
53 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
54
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
55
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
56 <section id="example" name="Пример конфигурации">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
57
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
58 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
59 <example>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
60 server {
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
61 listen 443 ssl spdy;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
62
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
63 ssl_certificate server.crt;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
64 ssl_certificate_key server.key;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
65 ...
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
66 }
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
67 </example>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
68 <note>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
69 Для того чтобы одновременно принимать
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
70 <link doc="ngx_http_ssl_module.xml">HTTPS</link> и
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
71 SPDY соединения на том же порту,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
72 используемая библиотека <link url="http://www.openssl.org">OpenSSL</link>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
73 должна поддерживать расширение Next Protocol Negotiation протокола TLS,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
74 доступное с версии OpenSSL 1.0.1.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
75 </note>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
76 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
77
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
78 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
79
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
80
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
81 <section id="directives" name="Директивы">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
82
1051
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
83 <directive name="spdy_chunk_size">
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
84 <syntax><value>размер</value></syntax>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
85 <default>8k</default>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
86 <context>http</context>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
87 <context>server</context>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
88 <context>location</context>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
89 <appeared-in>1.5.9</appeared-in>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
90
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
91 <para>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
92 Задаёт максимальный размер частей,
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
93 на которые будет
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
94 <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
95 разделяться</link> тело ответа.
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
96 Слишком маленькое значение может
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
97 привести к росту накладных расходов.
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
98 Слишком большое значение может
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
99 негативно сказаться на приоритизации из-за
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
100 <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
101 блокировки очереди</link>.
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
102 </para>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
103
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
104 </directive>
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
105
29de277bf322 Documented the "spdy_chunk_size" directive.
Yaroslav Zhuravlev <yaroslav.zhuravlev@nginx.com>
parents: 1050
diff changeset
106
869
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
107 <directive name="spdy_headers_comp">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
108 <syntax><value>степень</value></syntax>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
109 <default>0</default>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
110 <context>http</context>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
111 <context>server</context>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
112
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
113 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
114 Устанавливает <value>степень</value> сжатия заголовков ответа
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
115 в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие).
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
116 Специальное значение 0 отключает сжатие заголовков.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
117 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
118
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
119 </directive>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
120
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
121 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
122
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
123
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
124 <section id="variables" name="Встроенные переменные">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
125
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
126 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
127 Модуль <literal>ngx_http_spdy_module</literal>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
128 поддерживает следующие встроенные переменные:
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
129 <list type="tag" compact="no">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
130
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
131 <tag-name id="var_spdy"><var>$spdy</var></tag-name>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
132 <tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
133 версия протокола SPDY для SPDY-соединений,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
134 либо пустая строка;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
135 </tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
136
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
137 <tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
138 </tag-name>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
139 <tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
140 приоритет запроса для SPDY-соединений,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
141 либо пустая строка.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
142 </tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
143
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
144 </list>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
145 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
146
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
147 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
148
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
149 </module>