comparison xml/ru/docs/stream/ngx_stream_core_module.xml @ 1778:1626f1bf164c

Documented listen proxy_protocol, $proxy_protocol_addr, $proxy_protocol_port.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 13 Sep 2016 16:03:19 +0300
parents 6a30f04a0208
children 8df9ba4e56c6
comparison
equal deleted inserted replaced
1777:8b1ef02c8686 1778:1626f1bf164c
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_stream_core_module" 9 <module name="Модуль ngx_stream_core_module"
10 link="/ru/docs/stream/ngx_stream_core_module.html" 10 link="/ru/docs/stream/ngx_stream_core_module.html"
11 lang="ru" 11 lang="ru"
12 rev="17"> 12 rev="18">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_stream_core_module</literal> 17 Модуль <literal>ngx_stream_core_module</literal>
80 <directive name="listen"> 80 <directive name="listen">
81 <syntax> 81 <syntax>
82 <value>адрес</value>:<value>порт</value> 82 <value>адрес</value>:<value>порт</value>
83 [<literal>ssl</literal>] 83 [<literal>ssl</literal>]
84 [<literal>udp</literal>] 84 [<literal>udp</literal>]
85 [<literal>proxy_protocol</literal>]
85 [<literal>backlog</literal>=<value>число</value>] 86 [<literal>backlog</literal>=<value>число</value>]
86 [<literal>bind</literal>] 87 [<literal>bind</literal>]
87 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 88 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
88 [<literal>reuseport</literal>] 89 [<literal>reuseport</literal>]
89 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 90 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
119 </para> 120 </para>
120 121
121 <para id="udp"> 122 <para id="udp">
122 Параметр <literal>udp</literal> конфигурирует слушающий сокет 123 Параметр <literal>udp</literal> конфигурирует слушающий сокет
123 для работы с датаграммами (1.9.13). 124 для работы с датаграммами (1.9.13).
125 </para>
126
127 <para id="proxy_protocol">
128 Параметр <literal>proxy_protocol</literal> (1.11.4)
129 указывает на то, что все соединения, принимаемые на данном порту,
130 должны использовать
131 <link url="http://www.haproxy.org/download/1.5/doc/proxy-protocol.txt">протокол
132 PROXY</link>.
124 </para> 133 </para>
125 134
126 <para> 135 <para>
127 В директиве <literal>listen</literal> можно также указать несколько 136 В директиве <literal>listen</literal> можно также указать несколько
128 дополнительных параметров, специфичных для связанных с сокетами 137 дополнительных параметров, специфичных для связанных с сокетами
423 <tag-desc> 432 <tag-desc>
424 протокол, используемый для работы с клиентом: 433 протокол, используемый для работы с клиентом:
425 <literal>TCP</literal> или <literal>UDP</literal> (1.11.4) 434 <literal>TCP</literal> или <literal>UDP</literal> (1.11.4)
426 </tag-desc> 435 </tag-desc>
427 436
437 <tag-name id="var_proxy_protocol_addr"><var>$proxy_protocol_addr</var></tag-name>
438 <tag-desc>
439 адрес клиента, полученный из заголовка протокола PROXY, либо пустая строка
440 (1.11.4)
441 <para>
442 Протокол PROXY должен быть предварительно включён при помощи установки
443 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
444 </para>
445 </tag-desc>
446
447 <tag-name id="var_proxy_protocol_port"><var>$proxy_protocol_port</var></tag-name>
448 <tag-desc>
449 порт клиента, полученный из заголовка протокола PROXY, либо пустая строка
450 (1.11.4)
451 <para>
452 Протокол PROXY должен быть предварительно включён при помощи установки
453 параметра <literal>proxy_protocol</literal> в директиве <link id="listen"/>.
454 </para>
455 </tag-desc>
456
428 <tag-name id="var_remote_addr"><var>$remote_addr</var></tag-name> 457 <tag-name id="var_remote_addr"><var>$remote_addr</var></tag-name>
429 <tag-desc> 458 <tag-desc>
430 адрес клиента 459 адрес клиента
431 </tag-desc> 460 </tag-desc>
432 461