Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_geoip_module.xml @ 572:17ceffcc7ffb
Brought the ngx_http_map_module documentation up to date.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 05 Jul 2012 13:15:08 +0000 |
parents | a8daad8e83bb |
children | be54c443235a |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
4 |
346 | 5 <module name="Модуль ngx_http_geoip_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
6 link="/ru/docs/http/ngx_http_geoip_module.html" |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
7 lang="ru"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
9 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
10 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 <para> |
346 | 12 Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные, |
13 значения которых зависят от IP-адреса клиента, используя готовые базы данных | |
14 <link url="http://www.maxmind.com">MaxMind</link>. | |
15 </para> | |
16 | |
17 <para> | |
18 По умолчанию этот модуль не собирается, его сборку необходимо | |
19 разрешить с помощью конфигурационного параметра | |
20 <literal>--with-http_geoip_module</literal>. | |
21 <note> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
22 Для сборки и работы этого модуля нужна библиотека |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
23 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>. |
346 | 24 </note> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
25 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
28 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
29 |
346 | 30 <section id="example" name="Пример конфигурации"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
31 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
32 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 http { |
518 | 35 geoip_country GeoIP.dat; |
36 geoip_city GeoLiteCity.dat; | |
37 geoip_proxy 192.168.100.0/24; | |
38 geoip_proxy 2001:0db8::/32; | |
39 geoip_proxy_recursive on; | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
40 ... |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
42 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
43 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
44 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
45 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
46 |
346 | 47 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
48 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
49 <directive name="geoip_country"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
50 <syntax><value>база</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
51 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
52 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
53 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
54 <para> |
346 | 55 Задаёт базу данных для определения страны в зависимости |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
56 от значения IP-адреса клиента. |
346 | 57 При использовании этой базы данных доступны следующие переменные: |
58 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
59 |
346 | 60 <tag-name><var>$geoip_country_code</var></tag-name> |
61 <tag-desc> | |
62 двухбуквенный код страны, например, | |
63 “<literal>RU</literal>”, “<literal>US</literal>”. | |
64 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
65 |
346 | 66 <tag-name><var>$geoip_country_code3</var></tag-name> |
67 <tag-desc> | |
68 трёхбуквенный код страны, например, | |
69 “<literal>RUS</literal>”, “<literal>USA</literal>”. | |
70 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
71 |
346 | 72 <tag-name><var>$geoip_country_name</var></tag-name> |
73 <tag-desc> | |
74 название страны, например, | |
75 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”. | |
76 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
77 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
78 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
79 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
80 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
81 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
82 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
83 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
84 <directive name="geoip_city"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
85 <syntax><value>база</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
86 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
87 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
88 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
89 <para> |
346 | 90 Задаёт базу данных для определения страны, региона и города |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
91 в зависимости от значения IP-адреса клиента. |
346 | 92 При использовании этой базы данных доступны следующие переменные: |
93 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
94 |
346 | 95 <tag-name><var>$geoip_city_country_code</var></tag-name> |
96 <tag-desc> | |
97 двухбуквенный код страны, например, | |
98 “<literal>RU</literal>”, “<literal>US</literal>”. | |
99 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
100 |
346 | 101 <tag-name><var>$geoip_city_country_code3</var></tag-name> |
102 <tag-desc> | |
103 трёхбуквенный код страны, например, | |
104 “<literal>RUS</literal>”, “<literal>USA</literal>”. | |
105 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
106 |
346 | 107 <tag-name><var>$geoip_city_country_name</var></tag-name> |
108 <tag-desc> | |
109 название страны, например, | |
110 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”. | |
111 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
112 |
346 | 113 <tag-name><var>$geoip_region</var></tag-name> |
114 <tag-desc> | |
115 название региона страны (область, край, штат, | |
116 провинция, федеральная земля и тому подобное), например, | |
117 “<literal>Moscow City</literal>”, “<literal>DC</literal>”. | |
118 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
119 |
346 | 120 <tag-name><var>$geoip_city</var></tag-name> |
121 <tag-desc> | |
122 название города, например, | |
123 “<literal>Moscow</literal>”, “<literal>Washington</literal>”. | |
124 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
125 |
346 | 126 <tag-name><var>$geoip_postal_code</var></tag-name> |
127 <tag-desc> | |
128 почтовый индекс. | |
129 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
132 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
135 |
518 | 136 |
137 <directive name="geoip_proxy"> | |
138 <syntax><value>адрес</value> | <value>CIDR</value></syntax> | |
139 <default/> | |
140 <context>http</context> | |
141 <appeared-in>1.3.0</appeared-in> | |
523 | 142 <appeared-in>1.2.1</appeared-in> |
518 | 143 |
144 <para> | |
145 Задаёт доверенные адреса, при запросе с которых будет использоваться | |
146 адрес в переданном поле заголовка запроса <header>X-Forwarded-For</header>. | |
147 </para> | |
148 | |
149 </directive> | |
150 | |
151 | |
152 <directive name="geoip_proxy_recursive"> | |
153 <syntax><literal>on</literal> | <literal>off</literal></syntax> | |
154 <default>off</default> | |
155 <context>http</context> | |
156 <appeared-in>1.3.0</appeared-in> | |
523 | 157 <appeared-in>1.2.1</appeared-in> |
518 | 158 |
159 <para> | |
160 При выключенном рекурсивном поиске вместо исходного адреса клиента, | |
161 совпадающего с одним из доверенных адресов, будет использоваться последний | |
162 адрес, переданный в <header>X-Forwarded-For</header>. | |
163 При включённом рекурсивном поиске вместо исходного адреса клиента, | |
164 совпадающего с одним из доверенных адресов, будет использоваться последний | |
165 не доверенный адрес, переданный в <header>X-Forwarded-For</header>. | |
166 </para> | |
167 | |
168 </directive> | |
169 | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
170 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
171 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
172 </module> |