annotate xml/ru/docs/http/ngx_http_geoip_module.xml @ 2846:fdf1464e1977

Moved banner to the external file to make partial rollout possible. An idea is to have several banners and show them with different probability specified by split directive in the nginx.conf
author Sergey Budnevitch <sb@waeme.net>
date Tue, 10 May 2022 18:07:27 +0400
parents 07402a11fd8d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 523
diff changeset
7
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
9
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
10 <module name="Модуль ngx_http_geoip_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 link="/ru/docs/http/ngx_http_geoip_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
13 rev="5">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
15 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
18 Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
19 значения которых зависят от IP-адреса клиента, используя готовые базы данных
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
20 <link url="http://www.maxmind.com">MaxMind</link>.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
21 </para>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
22
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
23 <para>
840
9dab69f2b71d Documented nginx 1.2.7 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 833
diff changeset
24 При использовании баз данных с поддержкой IPv6 (1.3.12, 1.2.7)
824
c66610f9a53f GeoIP: IPv6 support.
Ruslan Ermilov <ru@nginx.com>
parents: 689
diff changeset
25 IPv4-адреса ищутся отображёнными на IPv6.
c66610f9a53f GeoIP: IPv6 support.
Ruslan Ermilov <ru@nginx.com>
parents: 689
diff changeset
26 </para>
c66610f9a53f GeoIP: IPv6 support.
Ruslan Ermilov <ru@nginx.com>
parents: 689
diff changeset
27
c66610f9a53f GeoIP: IPv6 support.
Ruslan Ermilov <ru@nginx.com>
parents: 689
diff changeset
28 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
29 По умолчанию этот модуль не собирается, его сборку необходимо
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
30 разрешить с помощью конфигурационного параметра
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
31 <literal>--with-http_geoip_module</literal>.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
32 <note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33 Для сборки и работы этого модуля нужна библиотека
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
34 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
35 </note>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
41 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
44 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
45 http {
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
46 geoip_country GeoIP.dat;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
47 geoip_city GeoLiteCity.dat;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
48 geoip_proxy 192.168.100.0/24;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
49 geoip_proxy 2001:0db8::/32;
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
50 geoip_proxy_recursive on;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
51 ...
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
54
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
56
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
57
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
58 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
59
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60 <directive name="geoip_country">
689
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
61 <syntax><value>файл</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
62 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
66 Задаёт базу данных для определения страны в зависимости
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67 от значения IP-адреса клиента.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
68 При использовании этой базы данных доступны следующие переменные:
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
69 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
71 <tag-name id="var_geoip_country_code"><var>$geoip_country_code</var></tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
72 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
73 двухбуквенный код страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
74 “<literal>RU</literal>”, “<literal>US</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
75 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
77 <tag-name id="var_geoip_country_code3"><var>$geoip_country_code3</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
78 </tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
79 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
80 трёхбуквенный код страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
81 “<literal>RUS</literal>”, “<literal>USA</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
82 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
84 <tag-name id="var_geoip_country_name"><var>$geoip_country_name</var></tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
85 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
86 название страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
87 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
88 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
92
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
94
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96 <directive name="geoip_city">
689
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
97 <syntax><value>файл</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
98 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
99 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
100
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
101 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
102 Задаёт базу данных для определения страны, региона и города
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103 в зависимости от значения IP-адреса клиента.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
104 При использовании этой базы данных доступны следующие переменные:
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
105 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
107 <tag-name id="var_geoip_area_code"><var>$geoip_area_code</var></tag-name>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
108 <tag-desc>телефонный код области (только для США).
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
109 <note>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
110 Данная переменная может содержать неактуальную информацию, т.к.
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
111 соответствующее поле базы данных объявлено устаревшим.
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
112 </note>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
113 </tag-desc>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
114
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
115 <tag-name id="var_geoip_city_continent_code">
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
116 <var>$geoip_city_continent_code</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
117 </tag-name>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
118 <tag-desc>двухбуквенный код континента, например,
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
119 “<literal>EU</literal>”, “<literal>NA</literal>”.
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
120 </tag-desc>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
121
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
122 <tag-name id="var_geoip_city_country_code"><var>$geoip_city_country_code</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
123 </tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
124 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
125 двухбуквенный код страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
126 “<literal>RU</literal>”, “<literal>US</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
127 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
128
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
129 <tag-name id="var_geoip_city_country_code3"><var>$geoip_city_country_code3</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
130 </tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
131 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
132 трёхбуквенный код страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
133 “<literal>RUS</literal>”, “<literal>USA</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
134 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
136 <tag-name id="var_geoip_city_country_name"><var>$geoip_city_country_name</var>
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
137 </tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
138 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
139 название страны, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
140 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
141 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
142
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
143 <tag-name id="var_geoip_dma_code"><var>$geoip_dma_code</var></tag-name>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
144 <tag-desc>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
145 DMA-код региона в США (также известный как “код агломерации”), согласно
833
e23004ce65ef GeoIP: shortened some descriptions and link scope (Russian).
Homutov Vladimir <vl@nginx.com>
parents: 827
diff changeset
146 <link url="https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions">геотаргетингу</link>
e23004ce65ef GeoIP: shortened some descriptions and link scope (Russian).
Homutov Vladimir <vl@nginx.com>
parents: 827
diff changeset
147 Google AdWords API.
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
148 </tag-desc>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
149
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
150 <tag-name id="var_geoip_latitude"><var>$geoip_latitude</var></tag-name>
833
e23004ce65ef GeoIP: shortened some descriptions and link scope (Russian).
Homutov Vladimir <vl@nginx.com>
parents: 827
diff changeset
151 <tag-desc>широта.</tag-desc>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
152
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
153 <tag-name id="var_geoip_longitude"><var>$geoip_longitude</var></tag-name>
833
e23004ce65ef GeoIP: shortened some descriptions and link scope (Russian).
Homutov Vladimir <vl@nginx.com>
parents: 827
diff changeset
154 <tag-desc>долгота.</tag-desc>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
155
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
156 <tag-name id="var_geoip_region"><var>$geoip_region</var></tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
157 <tag-desc>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
158 двухсимвольный код региона страны (область, край, штат,
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
159 провинция, федеральная земля и тому подобное), например,
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
160 “<literal>48</literal>”, “<literal>DC</literal>”.
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
161 </tag-desc>
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
162
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
163 <tag-name id="var_geoip_region_name"><var>$geoip_region_name</var></tag-name>
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
164 <tag-desc>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
165 название региона страны (область, край, штат,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
166 провинция, федеральная земля и тому подобное), например,
827
0753cec83ac4 GeoIP: updated description of module variables.
Homutov Vladimir <vl@nginx.com>
parents: 824
diff changeset
167 “<literal>Moscow City</literal>”, “<literal>District of Columbia</literal>”.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
168 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
169
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
170 <tag-name id="var_geoip_city"><var>$geoip_city</var></tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
171 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
172 название города, например,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
173 “<literal>Moscow</literal>”, “<literal>Washington</literal>”.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
174 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
176 <tag-name id="var_geoip_postal_code"><var>$geoip_postal_code</var></tag-name>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
177 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
178 почтовый индекс.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
179 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
180
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
181 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
183
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
185
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
186
689
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
187 <directive name="geoip_org">
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
188 <syntax><value>файл</value></syntax>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
189 <default/>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
190 <context>http</context>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
191 <appeared-in>1.0.3</appeared-in>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
192
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
193 <para>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
194 Задаёт базу данных для определения названия организации
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
195 в зависимости от значения IP-адреса клиента.
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
196 При использовании этой базы данных доступна следующая переменная:
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
197 <list type="tag">
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
198
1155
07402a11fd8d Assigned IDs to tags describing variables.
Vladimir Homutov <vl@nginx.com>
parents: 840
diff changeset
199 <tag-name id="var_geoip_org"><var>$geoip_org</var></tag-name>
689
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
200 <tag-desc>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
201 название организации, например, “The University of Melbourne”.
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
202 </tag-desc>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
203
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
204 </list>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
205 </para>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
206
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
207 </directive>
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
208
3cc1c7bb0674 Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
209
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
210 <directive name="geoip_proxy">
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
211 <syntax><value>адрес</value> | <value>CIDR</value></syntax>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
212 <default/>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
213 <context>http</context>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
214 <appeared-in>1.3.0</appeared-in>
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 518
diff changeset
215 <appeared-in>1.2.1</appeared-in>
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
216
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
217 <para>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
218 Задаёт доверенные адреса, при запросе с которых будет использоваться
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
219 адрес в переданном поле заголовка запроса <header>X-Forwarded-For</header>.
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
220 </para>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
221
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
222 </directive>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
223
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
224
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
225 <directive name="geoip_proxy_recursive">
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
226 <syntax><literal>on</literal> | <literal>off</literal></syntax>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
227 <default>off</default>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
228 <context>http</context>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
229 <appeared-in>1.3.0</appeared-in>
523
a8daad8e83bb Documented 1.2.1 changes.
Ruslan Ermilov <ru@nginx.com>
parents: 518
diff changeset
230 <appeared-in>1.2.1</appeared-in>
518
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
231
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
232 <para>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
233 При выключенном рекурсивном поиске вместо исходного адреса клиента,
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
234 совпадающего с одним из доверенных адресов, будет использоваться последний
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
235 адрес, переданный в <header>X-Forwarded-For</header>.
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
236 При включённом рекурсивном поиске вместо исходного адреса клиента,
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
237 совпадающего с одним из доверенных адресов, будет использоваться последний
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
238 не доверенный адрес, переданный в <header>X-Forwarded-For</header>.
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
239 </para>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
240
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
241 </directive>
65750bdde8fb Documented recent changes.
Ruslan Ermilov <ru@nginx.com>
parents: 346
diff changeset
242
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
243 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
245 </module>