diff xml/ru/docs/stream/ngx_stream_geoip_module.xml @ 1750:0e591e97737c

Documented the geoip module in stream.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 13 Jul 2016 21:15:55 +0300
parents xml/ru/docs/http/ngx_http_geoip_module.xml@07402a11fd8d
children 8e2a95422dc4
line wrap: on
line diff
copy from xml/ru/docs/http/ngx_http_geoip_module.xml
copy to xml/ru/docs/stream/ngx_stream_geoip_module.xml
--- a/xml/ru/docs/http/ngx_http_geoip_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_geoip_module.xml
@@ -1,34 +1,33 @@
 <?xml version="1.0"?>
 
 <!--
-  Copyright (C) Igor Sysoev
   Copyright (C) Nginx, Inc.
   -->
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Модуль ngx_http_geoip_module"
-        link="/ru/docs/http/ngx_http_geoip_module.html"
+<module name="Модуль ngx_stream_geoip_module"
+        link="/ru/docs/http/ngx_stream_geoip_module.html"
         lang="ru"
-        rev="5">
+        rev="1">
 
 <section id="summary">
 
 <para>
-Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные,
+Модуль <literal>ngx_stream_geoip_module</literal> (1.11.3) создаёт переменные,
 значения которых зависят от IP-адреса клиента, используя готовые базы данных
 <link url="http://www.maxmind.com">MaxMind</link>.
 </para>
 
 <para>
-При использовании баз данных с поддержкой IPv6 (1.3.12, 1.2.7)
+При использовании баз данных с поддержкой IPv6
 IPv4-адреса ищутся отображёнными на IPv6.
 </para>
 
 <para>
 По умолчанию этот модуль не собирается, его сборку необходимо
 разрешить с помощью конфигурационного параметра
-<literal>--with-http_geoip_module</literal>.
+<literal>--with-stream_geoip_module</literal>.
 <note>
 Для сборки и работы этого модуля нужна библиотека
 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
@@ -42,13 +41,18 @@ IPv4-адреса ищутся отображёнными на IPv6.
 
 <para>
 <example>
-http {
+stream {
     geoip_country         GeoIP.dat;
     geoip_city            GeoLiteCity.dat;
-    geoip_proxy           192.168.100.0/24;
-    geoip_proxy           2001:0db8::/32;
-    geoip_proxy_recursive on;
-    ...
+
+    map $geoip_city_continent_code $nearest_server {
+        default        example.com;
+        EU          eu.example.com;
+        NA          na.example.com;
+        AS          as.example.com;
+    }
+   ...
+}
 </example>
 </para>
 
@@ -60,7 +64,7 @@ http {
 <directive name="geoip_country">
 <syntax><value>файл</value></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 
 <para>
 Задаёт базу данных для определения страны в зависимости
@@ -96,7 +100,7 @@ http {
 <directive name="geoip_city">
 <syntax><value>файл</value></syntax>
 <default/>
-<context>http</context>
+<context>stream</context>
 
 <para>
 Задаёт базу данных для определения страны, региона и города
@@ -187,8 +191,7 @@ Google AdWords API.
 <directive name="geoip_org">
 <syntax><value>файл</value></syntax>
 <default/>
-<context>http</context>
-<appeared-in>1.0.3</appeared-in>
+<context>stream</context>
 
 <para>
 Задаёт базу данных для определения названия организации
@@ -206,40 +209,6 @@ Google AdWords API.
 
 </directive>
 
-
-<directive name="geoip_proxy">
-<syntax><value>адрес</value> | <value>CIDR</value></syntax>
-<default/>
-<context>http</context>
-<appeared-in>1.3.0</appeared-in>
-<appeared-in>1.2.1</appeared-in>
-
-<para>
-Задаёт доверенные адреса, при запросе с которых будет использоваться
-адрес в переданном поле заголовка запроса <header>X-Forwarded-For</header>.
-</para>
-
-</directive>
-
-
-<directive name="geoip_proxy_recursive">
-<syntax><literal>on</literal> | <literal>off</literal></syntax>
-<default>off</default>
-<context>http</context>
-<appeared-in>1.3.0</appeared-in>
-<appeared-in>1.2.1</appeared-in>
-
-<para>
-При выключенном рекурсивном поиске вместо исходного адреса клиента,
-совпадающего с одним из доверенных адресов, будет использоваться последний
-адрес, переданный в <header>X-Forwarded-For</header>.
-При включённом рекурсивном поиске вместо исходного адреса клиента,
-совпадающего с одним из доверенных адресов, будет использоваться последний
-не доверенный адрес, переданный в <header>X-Forwarded-For</header>.
-</para>
-
-</directive>
-
 </section>
 
 </module>