Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_proxy_module.xml @ 1696:d855e7cc3b2f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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