comparison xml/ru/docs/http/ngx_http_core_module.xml @ 1097:eeb690d4212b

Documented the PROXY protocol support.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 18 Mar 2014 19:59:24 +0400
parents 3fde5aa256ac
children a0543e9213e7
comparison
equal deleted inserted replaced
1096:f34be6b26447 1097:eeb690d4212b
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_core_module" 10 <module name="Модуль ngx_http_core_module"
11 link="/ru/docs/http/ngx_http_core_module.html" 11 link="/ru/docs/http/ngx_http_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="29"> 13 rev="30">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
1091 <syntax> 1091 <syntax>
1092 <value>адрес</value>[:<value>порт</value>] 1092 <value>адрес</value>[:<value>порт</value>]
1093 [<literal>default_server</literal>] 1093 [<literal>default_server</literal>]
1094 [<literal>ssl</literal>] 1094 [<literal>ssl</literal>]
1095 [<literal>spdy</literal>] 1095 [<literal>spdy</literal>]
1096 [<literal>proxy_protocol</literal>]
1096 [<literal>setfib</literal>=<value>число</value>] 1097 [<literal>setfib</literal>=<value>число</value>]
1097 [<literal>fastopen</literal>=<value>число</value>] 1098 [<literal>fastopen</literal>=<value>число</value>]
1098 [<literal>backlog</literal>=<value>число</value>] 1099 [<literal>backlog</literal>=<value>число</value>]
1099 [<literal>rcvbuf</literal>=<value>размер</value>] 1100 [<literal>rcvbuf</literal>=<value>размер</value>]
1100 [<literal>sndbuf</literal>=<value>размер</value>] 1101 [<literal>sndbuf</literal>=<value>размер</value>]
1106 <syntax> 1107 <syntax>
1107 <value>порт</value> 1108 <value>порт</value>
1108 [<literal>default_server</literal>] 1109 [<literal>default_server</literal>]
1109 [<literal>ssl</literal>] 1110 [<literal>ssl</literal>]
1110 [<literal>spdy</literal>] 1111 [<literal>spdy</literal>]
1112 [<literal>proxy_protocol</literal>]
1111 [<literal>setfib</literal>=<value>число</value>] 1113 [<literal>setfib</literal>=<value>число</value>]
1112 [<literal>fastopen</literal>=<value>число</value>] 1114 [<literal>fastopen</literal>=<value>число</value>]
1113 [<literal>backlog</literal>=<value>число</value>] 1115 [<literal>backlog</literal>=<value>число</value>]
1114 [<literal>rcvbuf</literal>=<value>размер</value>] 1116 [<literal>rcvbuf</literal>=<value>размер</value>]
1115 [<literal>sndbuf</literal>=<value>размер</value>] 1117 [<literal>sndbuf</literal>=<value>размер</value>]
1121 <syntax> 1123 <syntax>
1122 <literal>unix:</literal><value>путь</value> 1124 <literal>unix:</literal><value>путь</value>
1123 [<literal>default_server</literal>] 1125 [<literal>default_server</literal>]
1124 [<literal>ssl</literal>] 1126 [<literal>ssl</literal>]
1125 [<literal>spdy</literal>] 1127 [<literal>spdy</literal>]
1128 [<literal>proxy_protocol</literal>]
1126 [<literal>backlog</literal>=<value>число</value>] 1129 [<literal>backlog</literal>=<value>число</value>]
1127 [<literal>rcvbuf</literal>=<value>размер</value>] 1130 [<literal>rcvbuf</literal>=<value>размер</value>]
1128 [<literal>sndbuf</literal>=<value>размер</value>] 1131 [<literal>sndbuf</literal>=<value>размер</value>]
1129 [<literal>accept_filter</literal>=<value>фильтр</value>] 1132 [<literal>accept_filter</literal>=<value>фильтр</value>]
1130 [<literal>deferred</literal>] 1133 [<literal>deferred</literal>]
1193 Параметр <literal>spdy</literal> (1.3.15) позволяет принимать на этом порту 1196 Параметр <literal>spdy</literal> (1.3.15) позволяет принимать на этом порту
1194 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения. 1197 <link doc="ngx_http_spdy_module.xml">SPDY</link>-соединения.
1195 Обычно, чтобы это работало, следует также указать параметр 1198 Обычно, чтобы это работало, следует также указать параметр
1196 <literal>ssl</literal>, однако nginx можно также настроить и на приём 1199 <literal>ssl</literal>, однако nginx можно также настроить и на приём
1197 SPDY-соединений без SSL. 1200 SPDY-соединений без SSL.
1201 </para>
1202
1203 <para>
1204 Параметр <literal>proxy_protocol</literal> (1.5.12)
1205 указывает на то, что все соединения, принимаемые на данном порту,
1206 должны использовать
1207 <link url="http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt">протокол
1208 PROXY</link>.
1198 </para> 1209 </para>
1199 1210
1200 <para> 1211 <para>
1201 В директиве <literal>listen</literal> можно также указать несколько 1212 В директиве <literal>listen</literal> можно также указать несколько
1202 дополнительных параметров, специфичных для связанных с сокетами 1213 дополнительных параметров, специфичных для связанных с сокетами
2882 <tag-desc> 2893 <tag-desc>
2883 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” 2894 “<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>”
2884 (1.3.12, 1.2.7) 2895 (1.3.12, 1.2.7)
2885 </tag-desc> 2896 </tag-desc>
2886 2897
2898 <tag-name id="var_proxy_protocol_addr"><var>$proxy_protocol_addr</var></tag-name>
2899 <tag-desc>
2900 адрес клиента, полученный из заголовка протокола PROXY, либо пустая строка
2901 (1.5.12)
2902 <para>
2903 Протокол PROXY должен быть предварительно включён при помощи установки
2904 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
2905 </para>
2906 </tag-desc>
2907
2887 <tag-name id="var_query_string"><var>$query_string</var></tag-name> 2908 <tag-name id="var_query_string"><var>$query_string</var></tag-name>
2888 <tag-desc> 2909 <tag-desc>
2889 то же, что и <var>$args</var> 2910 то же, что и <var>$args</var>
2890 </tag-desc> 2911 </tag-desc>
2891 2912