changeset 1705:f855acbd0a94

Documented the $realip_remote_port variable.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 24 May 2016 20:22:35 +0300
parents 792478434bb1
children 6f5497797cde
files xml/en/docs/http/ngx_http_realip_module.xml xml/ru/docs/http/ngx_http_realip_module.xml
diffstat 2 files changed, 31 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_realip_module.xml	Tue May 24 20:19:12 2016 +0300
+++ b/xml/en/docs/http/ngx_http_realip_module.xml	Tue May 24 20:22:35 2016 +0300
@@ -10,13 +10,14 @@
 <module name="Module ngx_http_realip_module"
         link="/en/docs/http/ngx_http_realip_module.html"
         lang="en"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
 <para>
 The <literal>ngx_http_realip_module</literal> module is used
-to change the client address to the one sent in the specified header field.
+to change the client address and optional port
+to the one sent in the specified header fields.
 </para>
 
 <para>
@@ -85,6 +86,13 @@
 </para>
 
 <para>
+The <literal>X-Real-IP</literal> and <literal>X-Forwarded-For</literal>
+parameters may contain an optional port (1.11.0).
+The address and port should be specified according to
+<link url="http://tools.ietf.org/html/3986">RFC 3986</link>.
+</para>
+
+<para>
 The <literal>proxy_protocol</literal> parameter (1.5.12) changes
 the client address to the one from the PROXY protocol header.
 The PROXY protocol must be previously enabled by setting the
@@ -129,6 +137,11 @@
 keeps the original client address (1.9.7)
 </tag-desc>
 
+<tag-name id="var_realip_remote_port"><var>$realip_remote_port</var></tag-name>
+<tag-desc>
+keeps the original client port (1.11.0)
+</tag-desc>
+
 </list>
 </para>
 
--- a/xml/ru/docs/http/ngx_http_realip_module.xml	Tue May 24 20:19:12 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_realip_module.xml	Tue May 24 20:22:35 2016 +0300
@@ -10,13 +10,14 @@
 <module name="Модуль ngx_http_realip_module"
         link="/ru/docs/http/ngx_http_realip_module.html"
         lang="ru"
-        rev="4">
+        rev="5">
 
 <section id="summary">
 
 <para>
-Модуль <literal>ngx_http_realip_module</literal> позволяет менять адрес клиента
-на переданный в указанном поле заголовка.
+Модуль <literal>ngx_http_realip_module</literal> позволяет
+менять адрес и необязательный порт клиента
+на переданный в указанных полях заголовка.
 </para>
 
 <para>
@@ -85,6 +86,13 @@
 </para>
 
 <para>
+Параметры <literal>X-Real-IP</literal> и <literal>X-Forwarded-For</literal>
+могут содержать необязательный порт (1.11.0).
+Адрес и порт должны быть указаны согласно
+<link url="http://tools.ietf.org/html/3986">RFC 3986</link>.
+</para>
+
+<para>
 Параметр <literal>proxy_protocol</literal> (1.5.12) меняет
 адрес клиента на указанный в заголовке PROXY-протокола.
 Протокол PROXY должен быть предварительно включён при помощи установки
@@ -129,6 +137,11 @@
 хранит исходный адрес клиента (1.9.7)
 </tag-desc>
 
+<tag-name id="var_realip_remote_port"><var>$realip_remote_port</var></tag-name>
+<tag-desc>
+хранит исходный порт клиента (1.11.0)
+</tag-desc>
+
 </list>
 </para>