Mercurial > hg > nginx-site
diff xml/cn/docs/http/ngx_http_geoip_module.xml @ 792:ceb8a4e374b7
Updated the Chinese documentation.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 25 Dec 2012 06:34:37 +0000 |
parents | |
children |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/xml/cn/docs/http/ngx_http_geoip_module.xml @@ -0,0 +1,167 @@ +<?xml version="1.0"?> + +<!-- + Copyright (C) Igor Sysoev + Copyright (C) Nginx, Inc. + --> + +<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> + +<module name="ngx_http_geoip_module 模块" + link="/cn/docs/http/ngx_http_geoip_module.html" + lang="cn" + translator="cfsego" + rev="1"> + +<section id="summary"> + +<para> +<literal>ngx_http_geoip_module</literal> 模块(0.8.6+)创建变量,使用预编译的<link url="http://www.maxmind.com">MaxMind</link>数据库解析客户端IP地址,得到变量值。 +</para> + +<para> +nginx默认不编译这个模块,需要开启<literal>--with-http_geoip_module</literal>编译选项。 +<note> +模块依赖<link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>库。 +</note> +</para> + +</section> + + +<section id="example" name="配置示例"> + +<para> +<example> +http { + geoip_country GeoIP.dat; + geoip_city GeoLiteCity.dat; + geoip_proxy 192.168.100.0/24; + geoip_proxy 2001:0db8::/32; + geoip_proxy_recursive on; + ... +</example> +</para> + +</section> + + +<section id="directives" name="指令"> + +<directive name="geoip_country"> +<syntax><value>database</value></syntax> +<default/> +<context>http</context> + +<para> +指定数据库,用于根据客户端IP地址得到其所在国家。 +使用这个数据库时,配置中可用下列变量: +<list type="tag"> + +<tag-name><var>$geoip_country_code</var></tag-name> +<tag-desc> +双字符国家代码,比如 +“<literal>RU</literal>”,“<literal>US</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_country_code3</var></tag-name> +<tag-desc> +三字符国家代码,比如 +“<literal>RUS</literal>”,“<literal>USA</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_country_name</var></tag-name> +<tag-desc> +国家名称,比如 +“<literal>Russian Federation</literal>”,“<literal>United States</literal>”。 +</tag-desc> + +</list> +</para> + +</directive> + + +<directive name="geoip_city"> +<syntax><value>database</value></syntax> +<default/> +<context>http</context> + +<para> +指定数据库,用于根据客户端IP地址得到其所在的国家、行政区和城市。 +使用这个数据库时,配置中可用下列变量: +<list type="tag"> + +<tag-name><var>$geoip_city_country_code</var></tag-name> +<tag-desc> +双字符国家代码,比如 +“<literal>RU</literal>”,“<literal>US</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_city_country_code3</var></tag-name> +<tag-desc> +三字符国家代码,比如 +“<literal>RUS</literal>”,“<literal>USA</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_city_country_name</var></tag-name> +<tag-desc> +国家名称,比如 +“<literal>Russian Federation</literal>”,“<literal>United States</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_region</var></tag-name> +<tag-desc> +国家行政区名(行政区、直辖区、州、省、联邦管辖区,诸如此类),比如 +“<literal>Moscow City</literal>”,“<literal>DC</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_city</var></tag-name> +<tag-desc> +城市名称,比如 +“<literal>Moscow</literal>”,“<literal>Washington</literal>”。 +</tag-desc> + +<tag-name><var>$geoip_postal_code</var></tag-name> +<tag-desc> +邮编。 +</tag-desc> + +</list> +</para> + +</directive> + + +<directive name="geoip_proxy"> +<syntax><value>address</value> | <value>CIDR</value></syntax> +<default/> +<context>http</context> +<appeared-in>1.3.0</appeared-in> +<appeared-in>1.2.1</appeared-in> + +<para> +定义可信地址。 +如果请求来自可信地址,nginx将使用其<header>X-Forwarded-For</header>头来获得地址。 +</para> + +</directive> + + +<directive name="geoip_proxy_recursive"> +<syntax><literal>on</literal> | <literal>off</literal></syntax> +<default>off</default> +<context>http</context> +<appeared-in>1.3.0</appeared-in> +<appeared-in>1.2.1</appeared-in> + +<para> +如果关闭递归查找,在客户端地址与某个可信地址匹配时,nginx将使用<header>X-Forwarded-For</header>中的最后一个地址来代替原始客户端地址。 +如果开启递归查找,在客户端地址与某个可信地址匹配时,nginx将使用<header>X-Forwarded-For</header>中最后一个与所有可信地址都不匹配的地址来代替原始客户端地址。 +</para> + +</directive> + +</section> + +</module>