Mercurial > hg > nginx-site

changeset 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 aa95174efa80
children 147e3d0339e8
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_memcached_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_scgi_module.xml xml/en/docs/http/ngx_http_uwsgi_module.xml xml/en/docs/stream/ngx_stream_proxy_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_memcached_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml xml/ru/docs/stream/ngx_stream_proxy_module.xml
diffstat 12 files changed, 204 insertions(+), 24 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="33">
+        rev="34">
 
 <section id="summary">
 
@@ -45,7 +45,7 @@
 <section id="directives" name="Directives">
 
 <directive name="fastcgi_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>
@@ -62,6 +62,21 @@
 system to auto-assign the local IP address.
 </para>
 
+<para id="fastcgi_bind_transparent">
+The <literal>transparent</literal> parameter (1.11.0) allows
+outgoing connections to a FastCGI server originate
+from a non-local IP address,
+for example, from a real IP address of a client:
+<example>
+fastcgi_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 FastCGI server.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_memcached_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/http/ngx_http_memcached_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_memcached_module"
         link="/en/docs/http/ngx_http_memcached_module.html"
         lang="en"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -49,7 +49,7 @@
 <section id="directives" name="Directives">
 
 <directive name="memcached_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>
@@ -66,6 +66,21 @@
 system to auto-assign the local IP address.
 </para>
 
+<para id="memcached_bind_transparent">
+The <literal>transparent</literal> parameter (1.11.0) allows
+outgoing connections to a memcached server originate
+from a non-local IP address,
+for example, from a real IP address of a client:
+<example>
+memcached_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 memcached server.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -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 @@
 <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 @@
 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>
 
 
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="22">
+        rev="23">
 
 <section id="summary">
 
@@ -39,7 +39,7 @@
 <section id="directives" name="Directives">
 
 <directive name="scgi_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>
@@ -55,6 +55,21 @@
 system to auto-assign the local IP address.
 </para>
 
+<para id="scgi_bind_transparent">
+The <literal>transparent</literal> parameter (1.11.0) allows
+outgoing connections to an SCGI server originate
+from a non-local IP address,
+for example, from a real IP address of a client:
+<example>
+scgi_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 SCGI server.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="25">
+        rev="26">
 
 <section id="summary">
 
@@ -39,7 +39,7 @@
 <section id="directives" name="Directives">
 
 <directive name="uwsgi_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>
@@ -55,6 +55,21 @@
 system to auto-assign the local IP address.
 </para>
 
+<para id="uwsgi_bind_transparent">
+The <literal>transparent</literal> parameter (1.11.0) allows
+outgoing connections to a uwsgi server originate
+from a non-local IP address,
+for example, from a real IP address of a client:
+<example>
+uwsgi_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 uwsgi server.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/stream/ngx_stream_proxy_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_proxy_module"
         link="/en/docs/stream/ngx_stream_proxy_module.html"
         lang="en"
-        rev="13">
+        rev="14">
 
 <section id="summary">
 
@@ -57,7 +57,7 @@
 <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>stream</context>
 <context>server</context>
@@ -72,6 +72,21 @@
 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>
 
 
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="33">
+        rev="34">
 
 <section id="summary">
 
@@ -45,7 +45,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="fastcgi_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -62,6 +62,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="fastcgi_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с FastCGI-сервером,
+например, реальный IP-адрес клиента:
+<example>
+fastcgi_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с FastCGI-сервера.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_memcached_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_memcached_module"
         link="/ru/docs/http/ngx_http_memcached_module.html"
         lang="ru"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -49,7 +49,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="memcached_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -66,6 +66,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="memcached_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с сервером memcached,
+например, реальный IP-адрес клиента:
+<example>
+memcached_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с сервера memcached.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="46">
+        rev="47">
 
 <section id="summary">
 
@@ -40,7 +40,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="proxy_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -57,6 +57,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="proxy_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с проксируемым сервером,
+например, реальный IP-адрес клиента:
+<example>
+proxy_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с проксируемого сервера.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="22">
+        rev="23">
 
 <section id="summary">
 
@@ -39,7 +39,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="scgi_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -55,6 +55,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="scgi_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с SCGI-сервером,
+например, реальный IP-адрес клиента:
+<example>
+scgi_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с SCGI-сервера.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="25">
+        rev="26">
 
 <section id="summary">
 
@@ -39,7 +39,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="uwsgi_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>http</context>
 <context>server</context>
@@ -55,6 +55,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="uwsgi_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с uwsgi-сервером,
+например, реальный IP-адрес клиента:
+<example>
+uwsgi_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с uwsgi-сервера.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/stream/ngx_stream_proxy_module.xml	Wed May 04 17:35:39 2016 +0300
+++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml	Thu Apr 28 17:27:44 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_proxy_module"
         link="/ru/docs/stream/ngx_stream_proxy_module.html"
         lang="ru"
-        rev="13">
+        rev="14">
 
 <section id="summary">
 
@@ -57,7 +57,7 @@
 <section id="directives" name="Директивы">
 
 <directive name="proxy_bind">
-<syntax><value>адрес</value> | <literal>off</literal></syntax>
+<syntax><value>адрес</value> [transparent] | <literal>off</literal></syntax>
 <default/>
 <context>stream</context>
 <context>server</context>
@@ -72,6 +72,21 @@
 самостоятельно выбирать локальный IP-адрес.
 </para>
 
+<para id="proxy_bind_transparent">
+Параметр <literal>transparent</literal> (1.11.0) позволяет
+задать нелокальный IP-aдрес, который будет использоваться в
+исходящих соединениях с проксируемым сервером,
+например, реальный IP-адрес клиента:
+<example>
+proxy_bind $remote_addr transparent;
+</example>
+Для работы параметра
+необходимо запустить рабочие процессы nginx с привилегиями
+<link doc="../ngx_core_module.xml" id="user">суперпользователя</link>,
+а также настроить таблицу маршрутизации ядра
+для перехвата сетевого трафика с проксируемого сервера.
+</para>
+
 </directive>