comparison xml/ru/docs/stream/ngx_stream_core_module.xml @ 1662:48615cf80e20

Documented the UDP proxy functionality.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 15 Mar 2016 16:31:42 +0300
parents 8ea1813272bb
children 93063516f6ff
comparison
equal deleted inserted replaced
1661:0da7c65fdae5 1662:48615cf80e20
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="10"> 12 rev="11">
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>
43 server backend1.example.com:12345 weight=5; 43 server backend1.example.com:12345 weight=5;
44 server 127.0.0.1:12345 max_fails=3 fail_timeout=30s; 44 server 127.0.0.1:12345 max_fails=3 fail_timeout=30s;
45 server unix:/tmp/backend3; 45 server unix:/tmp/backend3;
46 } 46 }
47 47
48 upstream dns {
49 server 192.168.0.1:53535;
50 server dns.example.com:53;
51 }
52
48 server { 53 server {
49 listen 12345; 54 listen 12345;
50 proxy_connect_timeout 1s; 55 proxy_connect_timeout 1s;
51 proxy_timeout 3s; 56 proxy_timeout 3s;
52 proxy_pass backend; 57 proxy_pass backend;
53 } 58 }
54 59
55 server { 60 server {
61 listen 127.0.0.1:53 udp;
62 proxy_responses 1;
63 proxy_timeout 20s;
64 proxy_pass dns;
65 }
66
67 server {
56 listen [::1]:12345; 68 listen [::1]:12345;
57 proxy_pass unix:/tmp/stream.socket; 69 proxy_pass unix:/tmp/stream.socket;
58 } 70 }
59 } 71 }
60 </example> 72 </example>
67 79
68 <directive name="listen"> 80 <directive name="listen">
69 <syntax> 81 <syntax>
70 <value>адрес</value>:<value>порт</value> 82 <value>адрес</value>:<value>порт</value>
71 [<literal>ssl</literal>] 83 [<literal>ssl</literal>]
84 [<literal>udp</literal>]
72 [<literal>backlog</literal>=<value>число</value>] 85 [<literal>backlog</literal>=<value>число</value>]
73 [<literal>bind</literal>] 86 [<literal>bind</literal>]
74 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] 87 [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>]
75 [<literal>reuseport</literal>] 88 [<literal>reuseport</literal>]
76 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> 89 [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax>
101 </para> 114 </para>
102 115
103 <para> 116 <para>
104 Параметр <literal>ssl</literal> указывает на то, что все соединения, 117 Параметр <literal>ssl</literal> указывает на то, что все соединения,
105 принимаемые на данном порту, должны работать в режиме SSL. 118 принимаемые на данном порту, должны работать в режиме SSL.
119 </para>
120
121 <para>
122 Параметр <literal>udp</literal> конфигурирует слушающий сокет
123 для работы с датаграммами (1.9.13).
106 </para> 124 </para>
107 125
108 <para> 126 <para>
109 В директиве <literal>listen</literal> можно также указать несколько 127 В директиве <literal>listen</literal> можно также указать несколько
110 дополнительных параметров, специфичных для связанных с сокетами 128 дополнительных параметров, специфичных для связанных с сокетами