diff xml/ru/docs/stream/ngx_stream_geo_module.xml @ 1751:3768eb3d9c6c

Documented the geo module in stream.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 14 Jul 2016 20:33:05 +0300
parents xml/ru/docs/http/ngx_http_geo_module.xml@9dab69f2b71d
children 71e505ea3cb3
line wrap: on
line diff
copy from xml/ru/docs/http/ngx_http_geo_module.xml
copy to xml/ru/docs/stream/ngx_stream_geo_module.xml
--- a/xml/ru/docs/http/ngx_http_geo_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_geo_module.xml
@@ -1,21 +1,20 @@
 <?xml version="1.0"?>
 
 <!--
-  Copyright (C) Igor Sysoev
   Copyright (C) Nginx, Inc.
   -->
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Модуль ngx_http_geo_module"
-        link="/ru/docs/http/ngx_http_geo_module.html"
+<module name="Модуль ngx_stream_geo_module"
+        link="/ru/docs/stream/ngx_stream_geo_module.html"
         lang="ru"
-        rev="5">
+        rev="1">
 
 <section id="summary">
 
 <para>
-Модуль <literal>ngx_http_geo_module</literal> создаёт переменные,
+Модуль <literal>ngx_http_geo_module</literal> (1.11.3) создаёт переменные,
 значения которых зависят от IP-адреса клиента.
 </para>
 
@@ -47,13 +46,13 @@ geo $geo {
 <directive name="geo">
 <syntax block="yes">[<value>$адрес</value>] <value>$переменная</value></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 
 <para>
 Описывает для указанной переменной зависимость значения от
 IP-адреса клиента.
 По умолчанию адрес берётся из переменной <var>$remote_addr</var>,
-но его также можно получить из другой переменной (0.7.27), например:
+но его также можно получить из другой переменной, например:
 <example>
 geo $arg_remote_addr $geo {
     ...;
@@ -66,7 +65,7 @@ geo $arg_remote_addr $geo {
 Поскольку переменные вычисляются только в момент использования,
 само по себе наличие даже большого числа объявлений переменных
 “<literal>geo</literal>” не влечёт за собой никаких дополнительных
-расходов на обработку запросов.
+расходов на обработку соединений.
 </note>
 </para>
 
@@ -77,10 +76,7 @@ geo $arg_remote_addr $geo {
 
 <para>
 Адреса задаются либо префиксами в формате CIDR
-(включая одиночные адреса), либо в виде диапазонов (0.7.23).
-<note>
-IPv6-префиксы поддерживаются начиная с версий 1.3.10 и 1.2.7.
-</note>
+(включая одиночные адреса), либо в виде диапазонов.
 </para>
 
 <para>
@@ -89,7 +85,7 @@ IPv6-префиксы поддерживаются начиная с версий 1.3.10 и 1.2.7.
 
 <tag-name><literal>delete</literal></tag-name>
 <tag-desc>
-удаляет описанную сеть (0.7.23).
+удаляет описанную сеть.
 </tag-desc>
 
 <tag-name><literal>default</literal></tag-name>
@@ -109,32 +105,9 @@ IPv6-префиксы поддерживаются начиная с версий 1.3.10 и 1.2.7.
 Включений может быть несколько.
 </tag-desc>
 
-<tag-name><literal>proxy</literal></tag-name>
-<tag-desc>
-задаёт доверенные адреса (0.8.7, 0.7.63),
-при запросе с которых будет использоваться адрес в переданном
-поле заголовка запроса <header>X-Forwarded-For</header>.
-В отличие от обычных адресов, доверенные адреса проверяются
-последовательно.
-<note>
-Доверенные IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1.
-</note>
-</tag-desc>
-
-<tag-name><literal>proxy_recursive</literal></tag-name>
-<tag-desc>
-включает рекурсивный поиск адреса (1.3.0, 1.2.1).
-При выключенном рекурсивном поиске вместо исходного адреса клиента,
-совпадающего с одним из доверенных адресов, будет использоваться последний
-адрес, переданный в <header>X-Forwarded-For</header>.
-При включённом рекурсивном поиске вместо исходного адреса клиента,
-совпадающего с одним из доверенных адресов, будет использоваться последний
-не доверенный адрес, переданный в <header>X-Forwarded-For</header>.
-</tag-desc>
-
 <tag-name><literal>ranges</literal></tag-name>
 <tag-desc>
-указывает, что адреса задаются в виде диапазонов (0.7.23).
+указывает, что адреса задаются в виде диапазонов.
 Этот параметр должен быть первым.
 Для ускорения загрузки гео-базы нужно располагать адреса в порядке возрастания.
 </tag-desc>
@@ -149,8 +122,6 @@ geo $country {
     default        ZZ;
     include        conf/geo.conf;
     delete         127.0.0.0/16;
-    proxy          192.168.100.0/24;
-    proxy          2001:0db8::/32;
 
     127.0.0.0/24   US;
     127.0.0.1/32   RU;