Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_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 | 9c98c4498f08 |
children | e07ce4ed4dcc |
comparison
equal
deleted
inserted
replaced
1695:aa95174efa80 | 1696:d855e7cc3b2f |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Module ngx_http_proxy_module" | 10 <module name="Module ngx_http_proxy_module" |
11 link="/en/docs/http/ngx_http_proxy_module.html" | 11 link="/en/docs/http/ngx_http_proxy_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="46"> | 13 rev="47"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_proxy_module</literal> module allows passing | 18 The <literal>ngx_http_proxy_module</literal> module allows passing |
38 | 38 |
39 | 39 |
40 <section id="directives" name="Directives"> | 40 <section id="directives" name="Directives"> |
41 | 41 |
42 <directive name="proxy_bind"> | 42 <directive name="proxy_bind"> |
43 <syntax><value>address</value> | <literal>off</literal></syntax> | 43 <syntax><value>address</value> [transparent] | <literal>off</literal></syntax> |
44 <default/> | 44 <default/> |
45 <context>http</context> | 45 <context>http</context> |
46 <context>server</context> | 46 <context>server</context> |
47 <context>location</context> | 47 <context>location</context> |
48 <appeared-in>0.8.22</appeared-in> | 48 <appeared-in>0.8.22</appeared-in> |
53 Parameter value can contain variables (1.3.12). | 53 Parameter value can contain variables (1.3.12). |
54 The special value <literal>off</literal> (1.3.12) cancels the effect | 54 The special value <literal>off</literal> (1.3.12) cancels the effect |
55 of the <literal>proxy_bind</literal> directive | 55 of the <literal>proxy_bind</literal> directive |
56 inherited from the previous configuration level, which allows the | 56 inherited from the previous configuration level, which allows the |
57 system to auto-assign the local IP address. | 57 system to auto-assign the local IP address. |
58 </para> | |
59 | |
60 <para id="proxy_bind_transparent"> | |
61 The <literal>transparent</literal> parameter (1.11.0) allows | |
62 outgoing connections to a proxied server originate | |
63 from a non-local IP address, | |
64 for example, from a real IP address of a client: | |
65 <example> | |
66 proxy_bind $remote_addr transparent; | |
67 </example> | |
68 In order for this parameter to work, | |
69 it is necessary to run nginx worker processes with the | |
70 <link doc="../ngx_core_module.xml" id="user">superuser</link> privileges | |
71 and configure kernel routing table | |
72 to intercept network traffic from the proxied server. | |
58 </para> | 73 </para> |
59 | 74 |
60 </directive> | 75 </directive> |
61 | 76 |
62 | 77 |