Mercurial > hg > nginx-site
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;