annotate xml/ru/docs/http/ngx_http_spdy_module.xml @ 1050:85804d815ed3

The SPDY module now supports "limit_rate".
author Valentin Bartenev <vbart@nginx.com>
date Wed, 22 Jan 2014 23:26:32 +0400
parents ca9a259cb5c8
children 29de277bf322
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"
1050
85804d815ed3 The SPDY module now supports "limit_rate".
Valentin Bartenev <vbart@nginx.com>
parents: 886
diff changeset
12 rev="3">
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 В настоящий момент реализован
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
20 <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
21 2</link> протокола SPDY.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
22 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
23
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
24 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
25 По умолчанию этот модуль не собирается, его сборку необходимо
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
26 разрешить с помощью конфигурационного параметра
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
27 <literal>--with-http_spdy_module</literal>.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
28 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
29
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
30 </section>
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
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
33 <section id="bugs" name="Известные проблемы">
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 <para>
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 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
38
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
39 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
40 Текущая реализация протокола SPDY не поддерживает server push.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
41 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
42
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
43 <para>
1050
85804d815ed3 The SPDY module now supports "limit_rate".
Valentin Bartenev <vbart@nginx.com>
parents: 886
diff changeset
44 До версии 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
45 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничена</link>.
869
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 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
49
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
50
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
51 <section id="example" name="Пример конфигурации">
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 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
54 <example>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
55 server {
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
56 listen 443 ssl spdy;
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 ssl_certificate server.crt;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
59 ssl_certificate_key server.key;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
60 ...
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
61 }
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
62 </example>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
63 <note>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
64 Для того чтобы одновременно принимать
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
65 <link doc="ngx_http_ssl_module.xml">HTTPS</link> и
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
66 SPDY соединения на том же порту,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
67 используемая библиотека <link url="http://www.openssl.org">OpenSSL</link>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
68 должна поддерживать расширение Next Protocol Negotiation протокола TLS,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
69 доступное с версии OpenSSL 1.0.1.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
70 </note>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
71 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
72
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
73 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
74
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
75
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
76 <section id="directives" name="Директивы">
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 <directive name="spdy_headers_comp">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
79 <syntax><value>степень</value></syntax>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
80 <default>0</default>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
81 <context>http</context>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
82 <context>server</context>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
83
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
84 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
85 Устанавливает <value>степень</value> сжатия заголовков ответа
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
86 в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие).
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
87 Специальное значение 0 отключает сжатие заголовков.
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
88 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
89
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
90 </directive>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
91
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
92 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
93
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
94
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
95 <section id="variables" name="Встроенные переменные">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
96
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
97 <para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
98 Модуль <literal>ngx_http_spdy_module</literal>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
99 поддерживает следующие встроенные переменные:
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
100 <list type="tag" compact="no">
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
101
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
102 <tag-name id="var_spdy"><var>$spdy</var></tag-name>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
103 <tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
104 версия протокола SPDY для SPDY-соединений,
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
105 либо пустая строка;
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
106 </tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
107
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
108 <tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
109 </tag-name>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
110 <tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
111 приоритет запроса для SPDY-соединений,
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 </tag-desc>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
114
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
115 </list>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
116 </para>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
117
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
118 </section>
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
119
ade81792bdaa Documented SPDY support.
Homutov Vladimir <vl@nginx.com>
parents:
diff changeset
120 </module>