diff 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
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="46">
+        rev="47">
 
 <section id="summary">
 
@@ -40,7 +40,7 @@ location / {
 <section id="directives" name="Directives">
 
 <directive name="proxy_bind">
-<syntax><value>address</value> | <literal>off</literal></syntax>
+<syntax><value>address</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -57,6 +57,21 @@ inherited from the previous configuratio
 system to auto-assign the local IP address.
 </para>
 
+<para id="proxy_bind_transparent">
+The <literal>transparent</literal> parameter (1.11.0) allows
+outgoing connections to a proxied server originate
+from a non-local IP address,
+for example, from a real IP address of a client:
+<example>
+proxy_bind $remote_addr transparent;
+</example>
+In order for this parameter to work,
+it is necessary to run nginx worker processes with the
+<link doc="../ngx_core_module.xml" id="user">superuser</link> privileges
+and configure kernel routing table
+to intercept network traffic from the proxied server.
+</para>
+
 </directive>