Mercurial > hg > nginx-site

comparison xml/en/docs/stream/ngx_stream_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 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