Mercurial > hg > nginx-site

comparison xml/cn/docs/http/ngx_http_geoip_module.xml @ 792:ceb8a4e374b7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated the Chinese documentation.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 25 Dec 2012 06:34:37 +0000
parents
children
comparison
equal deleted inserted replaced
791:15f2bab0740d 792:ceb8a4e374b7
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Igor Sysoev
5 Copyright (C) Nginx, Inc.
6 -->
7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9
10 <module name="ngx_http_geoip_module 模块"
11 link="/cn/docs/http/ngx_http_geoip_module.html"
12 lang="cn"
13 translator="cfsego"
14 rev="1">
15
16 <section id="summary">
17
18 <para>
19 <literal>ngx_http_geoip_module</literal> 模块（0.8.6+）创建变量，使用预编译的<link url="http://www.maxmind.com">MaxMind</link>数据库解析客户端IP地址，得到变量值。
20 </para>
21
22 <para>
23 nginx默认不编译这个模块，需要开启<literal>--with-http_geoip_module</literal>编译选项。
24 <note>
25 模块依赖<link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>库。
26 </note>
27 </para>
28
29 </section>
30
31
32 <section id="example" name="配置示例">
33
34 <para>
35 <example>
36 http {
37 geoip_country GeoIP.dat;
38 geoip_city GeoLiteCity.dat;
39 geoip_proxy 192.168.100.0/24;
40 geoip_proxy 2001:0db8::/32;
41 geoip_proxy_recursive on;
42 ...
43 </example>
44 </para>
45
46 </section>
47
48
49 <section id="directives" name="指令">
50
51 <directive name="geoip_country">
52 <syntax><value>database</value></syntax>
53 <default/>
54 <context>http</context>
55
56 <para>
57 指定数据库，用于根据客户端IP地址得到其所在国家。
58 使用这个数据库时，配置中可用下列变量：
59 <list type="tag">
60
61 <tag-name><var>$geoip_country_code</var></tag-name>
62 <tag-desc>
63 双字符国家代码，比如
64 “<literal>RU</literal>”，“<literal>US</literal>”。
65 </tag-desc>
66
67 <tag-name><var>$geoip_country_code3</var></tag-name>
68 <tag-desc>
69 三字符国家代码，比如
70 “<literal>RUS</literal>”，“<literal>USA</literal>”。
71 </tag-desc>
72
73 <tag-name><var>$geoip_country_name</var></tag-name>
74 <tag-desc>
75 国家名称，比如
76 “<literal>Russian Federation</literal>”，“<literal>United States</literal>”。
77 </tag-desc>
78
79 </list>
80 </para>
81
82 </directive>
83
84
85 <directive name="geoip_city">
86 <syntax><value>database</value></syntax>
87 <default/>
88 <context>http</context>
89
90 <para>
91 指定数据库，用于根据客户端IP地址得到其所在的国家、行政区和城市。
92 使用这个数据库时，配置中可用下列变量：
93 <list type="tag">
94
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>
100
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>
106
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>
112
113 <tag-name><var>$geoip_region</var></tag-name>
114 <tag-desc>
115 国家行政区名（行政区、直辖区、州、省、联邦管辖区，诸如此类），比如
116 “<literal>Moscow City</literal>”，“<literal>DC</literal>”。
117 </tag-desc>
118
119 <tag-name><var>$geoip_city</var></tag-name>
120 <tag-desc>
121 城市名称，比如
122 “<literal>Moscow</literal>”，“<literal>Washington</literal>”。
123 </tag-desc>
124
125 <tag-name><var>$geoip_postal_code</var></tag-name>
126 <tag-desc>
127 邮编。
128 </tag-desc>
129
130 </list>
131 </para>
132
133 </directive>
134
135
136 <directive name="geoip_proxy">
137 <syntax><value>address</value> | <value>CIDR</value></syntax>
138 <default/>
139 <context>http</context>
140 <appeared-in>1.3.0</appeared-in>
141 <appeared-in>1.2.1</appeared-in>
142
143 <para>
144 定义可信地址。
145 如果请求来自可信地址，nginx将使用其<header>X-Forwarded-For</header>头来获得地址。
146 </para>
147
148 </directive>
149
150
151 <directive name="geoip_proxy_recursive">
152 <syntax><literal>on</literal> | <literal>off</literal></syntax>
153 <default>off</default>
154 <context>http</context>
155 <appeared-in>1.3.0</appeared-in>
156 <appeared-in>1.2.1</appeared-in>
157
158 <para>
159 如果关闭递归查找，在客户端地址与某个可信地址匹配时，nginx将使用<header>X-Forwarded-For</header>中的最后一个地址来代替原始客户端地址。
160 如果开启递归查找，在客户端地址与某个可信地址匹配时，nginx将使用<header>X-Forwarded-For</header>中最后一个与所有可信地址都不匹配的地址来代替原始客户端地址。
161 </para>
162
163 </directive>
164
165 </section>
166
167 </module>