Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_geoip_module.xml @ 825:ae15915990ad
Documented the "gzip_ratio" variable.
author | Homutov Vladimir <vl@nginx.com> |
---|---|
date | Wed, 30 Jan 2013 19:52:12 +0400 |
parents | c66610f9a53f |
children | 0753cec83ac4 |
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 | 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 | 12 lang="ru" |
824 | 13 rev="2"> |
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 | 18 Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные, |
19 значения которых зависят от IP-адреса клиента, используя готовые базы данных | |
20 <link url="http://www.maxmind.com">MaxMind</link>. | |
21 </para> | |
22 | |
23 <para> | |
824 | 24 При использовании баз данных с поддержкой IPv6 (1.3.12) |
25 IPv4-адреса ищутся отображёнными на IPv6. | |
26 </para> | |
27 | |
28 <para> | |
346 | 29 По умолчанию этот модуль не собирается, его сборку необходимо |
30 разрешить с помощью конфигурационного параметра | |
31 <literal>--with-http_geoip_module</literal>. | |
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 | 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 | 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 | 46 geoip_country GeoIP.dat; |
47 geoip_city GeoLiteCity.dat; | |
48 geoip_proxy 192.168.100.0/24; | |
49 geoip_proxy 2001:0db8::/32; | |
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 | 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 | 66 Задаёт базу данных для определения страны в зависимости |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
67 от значения IP-адреса клиента. |
346 | 68 При использовании этой базы данных доступны следующие переменные: |
69 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 |
346 | 71 <tag-name><var>$geoip_country_code</var></tag-name> |
72 <tag-desc> | |
73 двухбуквенный код страны, например, | |
74 “<literal>RU</literal>”, “<literal>US</literal>”. | |
75 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
76 |
346 | 77 <tag-name><var>$geoip_country_code3</var></tag-name> |
78 <tag-desc> | |
79 трёхбуквенный код страны, например, | |
80 “<literal>RUS</literal>”, “<literal>USA</literal>”. | |
81 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
82 |
346 | 83 <tag-name><var>$geoip_country_name</var></tag-name> |
84 <tag-desc> | |
85 название страны, например, | |
86 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”. | |
87 </tag-desc> | |
76
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 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
90 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
91 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
92 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
93 |
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 <directive name="geoip_city"> |
689
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
96 <syntax><value>файл</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
76
diff
changeset
|
97 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
99 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
100 <para> |
346 | 101 Задаёт базу данных для определения страны, региона и города |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
102 в зависимости от значения IP-адреса клиента. |
346 | 103 При использовании этой базы данных доступны следующие переменные: |
104 <list type="tag"> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
105 |
346 | 106 <tag-name><var>$geoip_city_country_code</var></tag-name> |
107 <tag-desc> | |
108 двухбуквенный код страны, например, | |
109 “<literal>RU</literal>”, “<literal>US</literal>”. | |
110 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
111 |
346 | 112 <tag-name><var>$geoip_city_country_code3</var></tag-name> |
113 <tag-desc> | |
114 трёхбуквенный код страны, например, | |
115 “<literal>RUS</literal>”, “<literal>USA</literal>”. | |
116 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
117 |
346 | 118 <tag-name><var>$geoip_city_country_name</var></tag-name> |
119 <tag-desc> | |
120 название страны, например, | |
121 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”. | |
122 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
123 |
346 | 124 <tag-name><var>$geoip_region</var></tag-name> |
125 <tag-desc> | |
126 название региона страны (область, край, штат, | |
127 провинция, федеральная земля и тому подобное), например, | |
128 “<literal>Moscow City</literal>”, “<literal>DC</literal>”. | |
129 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 |
346 | 131 <tag-name><var>$geoip_city</var></tag-name> |
132 <tag-desc> | |
133 название города, например, | |
134 “<literal>Moscow</literal>”, “<literal>Washington</literal>”. | |
135 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
136 |
346 | 137 <tag-name><var>$geoip_postal_code</var></tag-name> |
138 <tag-desc> | |
139 почтовый индекс. | |
140 </tag-desc> | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
141 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
142 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
143 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
144 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
145 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
146 |
518 | 147 |
689
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
148 <directive name="geoip_org"> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
149 <syntax><value>файл</value></syntax> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
150 <default/> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
151 <context>http</context> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
152 <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
|
153 |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
154 <para> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
155 Задаёт базу данных для определения названия организации |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
156 в зависимости от значения IP-адреса клиента. |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
157 При использовании этой базы данных доступна следующая переменная: |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
158 <list type="tag"> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
159 |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
160 <tag-name><var>$geoip_org</var></tag-name> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
161 <tag-desc> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
162 название организации, например, “The University of Melbourne”. |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
163 </tag-desc> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
164 |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
165 </list> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
166 </para> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
167 |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
168 </directive> |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
169 |
3cc1c7bb0674
Documented geoip_org directive and fixed parameter names
Vladimir Homutov <vl@nginx.com>
parents:
589
diff
changeset
|
170 |
518 | 171 <directive name="geoip_proxy"> |
172 <syntax><value>адрес</value> | <value>CIDR</value></syntax> | |
173 <default/> | |
174 <context>http</context> | |
175 <appeared-in>1.3.0</appeared-in> | |
523 | 176 <appeared-in>1.2.1</appeared-in> |
518 | 177 |
178 <para> | |
179 Задаёт доверенные адреса, при запросе с которых будет использоваться | |
180 адрес в переданном поле заголовка запроса <header>X-Forwarded-For</header>. | |
181 </para> | |
182 | |
183 </directive> | |
184 | |
185 | |
186 <directive name="geoip_proxy_recursive"> | |
187 <syntax><literal>on</literal> | <literal>off</literal></syntax> | |
188 <default>off</default> | |
189 <context>http</context> | |
190 <appeared-in>1.3.0</appeared-in> | |
523 | 191 <appeared-in>1.2.1</appeared-in> |
518 | 192 |
193 <para> | |
194 При выключенном рекурсивном поиске вместо исходного адреса клиента, | |
195 совпадающего с одним из доверенных адресов, будет использоваться последний | |
196 адрес, переданный в <header>X-Forwarded-For</header>. | |
197 При включённом рекурсивном поиске вместо исходного адреса клиента, | |
198 совпадающего с одним из доверенных адресов, будет использоваться последний | |
199 не доверенный адрес, переданный в <header>X-Forwarded-For</header>. | |
200 </para> | |
201 | |
202 </directive> | |
203 | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
204 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
205 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
206 </module> |