Mercurial > hg > nginx-site
changeset 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 | 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 +++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml @@ -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 @@ location / { <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 @@ inherited from the previous configuratio 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 +++ b/xml/en/docs/http/ngx_http_memcached_module.xml @@ -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 @@ server { <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 @@ inherited from the previous configuratio 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 +++ 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>
--- a/xml/en/docs/http/ngx_http_scgi_module.xml +++ b/xml/en/docs/http/ngx_http_scgi_module.xml @@ -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 @@ location / { <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 @@ inherited from the previous configuratio 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 +++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml @@ -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 @@ location / { <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 @@ inherited from the previous configuratio 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 +++ b/xml/en/docs/stream/ngx_stream_proxy_module.xml @@ -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 @@ server { <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 @@ 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>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml @@ -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 @@ location / { <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 @@ location / { самостоятельно выбирать локальный 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 +++ b/xml/ru/docs/http/ngx_http_memcached_module.xml @@ -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 @@ server { <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 @@ server { самостоятельно выбирать локальный 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 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -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 @@ location / { <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 @@ location / { самостоятельно выбирать локальный 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 +++ b/xml/ru/docs/http/ngx_http_scgi_module.xml @@ -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 @@ location / { <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 @@ location / { самостоятельно выбирать локальный 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 +++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml @@ -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 @@ location / { <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 @@ location / { самостоятельно выбирать локальный 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 +++ b/xml/ru/docs/stream/ngx_stream_proxy_module.xml @@ -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 @@ server { <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 @@ server { самостоятельно выбирать локальный 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>