annotate xml/ru/docs/http/ngx_http_geoip_module.xml @ 2680:8751cab1d562

Corrected example description in js_import.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 12 Mar 2021 20:34:11 +0000
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>