Mercurial > hg > nginx-site
comparison xml/en/docs/stream/ngx_stream_proxy_module.xml @ 1696:d855e7cc3b2f
Added the "transparent" parameter of proxy_bind and friends.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Thu, 28 Apr 2016 17:27:44 +0300 |
parents | 48615cf80e20 |
children | e07ce4ed4dcc |
comparison
equal
deleted
inserted
replaced
1695:aa95174efa80 | 1696:d855e7cc3b2f |
---|---|
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
8 | 8 |
9 <module name="Module ngx_stream_proxy_module" | 9 <module name="Module ngx_stream_proxy_module" |
10 link="/en/docs/stream/ngx_stream_proxy_module.html" | 10 link="/en/docs/stream/ngx_stream_proxy_module.html" |
11 lang="en" | 11 lang="en" |
12 rev="13"> | 12 rev="14"> |
13 | 13 |
14 <section id="summary"> | 14 <section id="summary"> |
15 | 15 |
16 <para> | 16 <para> |
17 The <literal>ngx_stream_proxy_module</literal> module (1.9.0) allows proxying | 17 The <literal>ngx_stream_proxy_module</literal> module (1.9.0) allows proxying |
55 | 55 |
56 | 56 |
57 <section id="directives" name="Directives"> | 57 <section id="directives" name="Directives"> |
58 | 58 |
59 <directive name="proxy_bind"> | 59 <directive name="proxy_bind"> |
60 <syntax><value>address</value> | <literal>off</literal></syntax> | 60 <syntax><value>address</value> [transparent] | <literal>off</literal></syntax> |
61 <default/> | 61 <default/> |
62 <context>stream</context> | 62 <context>stream</context> |
63 <context>server</context> | 63 <context>server</context> |
64 <appeared-in>1.9.2</appeared-in> | 64 <appeared-in>1.9.2</appeared-in> |
65 | 65 |
68 from the specified local IP <value>address</value>. | 68 from the specified local IP <value>address</value>. |
69 The special value <literal>off</literal> cancels the effect | 69 The special value <literal>off</literal> cancels the effect |
70 of the <literal>proxy_bind</literal> directive | 70 of the <literal>proxy_bind</literal> directive |
71 inherited from the previous configuration level, which allows the | 71 inherited from the previous configuration level, which allows the |
72 system to auto-assign the local IP address. | 72 system to auto-assign the local IP address. |
73 </para> | |
74 | |
75 <para id="proxy_bind_transparent"> | |
76 The <literal>transparent</literal> parameter (1.11.0) allows | |
77 outgoing connections to a proxied server originate | |
78 from a non-local IP address, | |
79 for example, from a real IP address of a client: | |
80 <example> | |
81 proxy_bind $remote_addr transparent; | |
82 </example> | |
83 In order for this parameter to work, | |
84 it is necessary to run nginx worker processes with the | |
85 <link doc="../ngx_core_module.xml" id="user">superuser</link> privileges | |
86 and configure kernel routing table | |
87 to intercept network traffic from the proxied server. | |
73 </para> | 88 </para> |
74 | 89 |
75 </directive> | 90 </directive> |
76 | 91 |
77 | 92 |