comparison xml/ru/docs/http/ngx_http_spdy_module.xml @ 869:ade81792bdaa

Documented SPDY support. New SPDY module added and the "listen" directive description is updated.
author Homutov Vladimir <vl@nginx.com>
date Wed, 20 Mar 2013 15:00:06 +0400
parents
children ca9a259cb5c8
comparison
equal deleted inserted replaced
868:17d0c825f098 869:ade81792bdaa
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"
12 rev="1">
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 В настоящий момент реализован
20 <link url="http://www.chromium.org/spdy/spdy-protocol/spdy-protocol-draft2">draft
21 2</link> протокола SPDY.
22 </para>
23
24 <para>
25 По умолчанию этот модуль не собирается, его сборку необходимо
26 разрешить с помощью конфигурационного параметра
27 <literal>--with-http_spdy_module</literal>.
28 </para>
29
30 </section>
31
32
33 <section id="bugs" name="Известные проблемы">
34
35 <para>
36 Модуль экспериментальный, поэтому возможно всё.
37 </para>
38
39 <para>
40 Текущая реализация протокола SPDY не поддерживает server push.
41 </para>
42
43 <para>
44 Скорость обработки запросов в SPDY-соединении не может быть
45 <link doc="ngx_http_limit_req_module.xml">ограничена</link>.
46 </para>
47
48 </section>
49
50
51 <section id="example" name="Пример конфигурации">
52
53 <para>
54 <example>
55 server {
56 listen 443 ssl spdy;
57
58 ssl_certificate server.crt;
59 ssl_certificate_key server.key;
60 ...
61 }
62 </example>
63 <note>
64 Для того чтобы одновременно принимать
65 <link doc="ngx_http_ssl_module.xml">HTTPS</link> и
66 SPDY соединения на том же порту,
67 используемая библиотека <link url="http://www.openssl.org">OpenSSL</link>
68 должна поддерживать расширение Next Protocol Negotiation протокола TLS,
69 доступное с версии OpenSSL 1.0.1.
70 </note>
71 </para>
72
73 </section>
74
75
76 <section id="directives" name="Директивы">
77
78 <directive name="spdy_headers_comp">
79 <syntax><value>степень</value></syntax>
80 <default>0</default>
81 <context>http</context>
82 <context>server</context>
83
84 <para>
85 Устанавливает <value>степень</value> сжатия заголовков ответа
86 в диапазоне от 1 (быстрее, но хуже сжатие) до 9 (медленнее, лучшее сжатие).
87 Специальное значение 0 отключает сжатие заголовков.
88 </para>
89
90 </directive>
91
92 </section>
93
94
95 <section id="variables" name="Встроенные переменные">
96
97 <para>
98 Модуль <literal>ngx_http_spdy_module</literal>
99 поддерживает следующие встроенные переменные:
100 <list type="tag" compact="no">
101
102 <tag-name id="var_spdy"><var>$spdy</var></tag-name>
103 <tag-desc>
104 версия протокола SPDY для SPDY-соединений,
105 либо пустая строка;
106 </tag-desc>
107
108 <tag-name id="var_spdy_request_priority"><var>$spdy_request_priority</var>
109 </tag-name>
110 <tag-desc>
111 приоритет запроса для SPDY-соединений,
112 либо пустая строка.
113 </tag-desc>
114
115 </list>
116 </para>
117
118 </section>
119
120 </module>