Mercurial > hg > nginx-site

comparison xml/cn/docs/http/ngx_http_geo_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_geo_module 模块"
11 link="/cn/docs/http/ngx_http_geo_module.html"
12 lang="cn"
13 translator="cfsego"
14 rev="1">
15
16 <section id="summary">
17
18 <para>
19 <literal>ngx_http_geo_module</literal> 模块创建变量，并根据客户端IP地址对变量赋值。
20 </para>
21
22 </section>
23
24
25 <section id="example" name="配置示例">
26
27 <para>
28 <example>
29 geo $geo {
30 default 0;
31 127.0.0.1/32 2;
32 192.168.1.0/24 1;
33 10.1.0.0/16 1;
34 }
35 </example>
36 </para>
37
38 </section>
39
40
41 <section id="directives" name="指令">
42
43 <directive name="geo">
44 <syntax block="yes">[<value>$address</value>] <value>$variable</value></syntax>
45 <default/>
46 <context>http</context>
47
48 <para>
49 定义从指定的变量获取客户端的IP地址。默认情况下，nginx从<var>$remote_addr</var>变量取得客户端IP地址，但也可以从其他变量获得（0.7.27版），比如：
50 <example>
51 geo $arg_remote_addr $geo {
52 ...;
53 }
54 </example>
55 如果该变量的值不能代表一个合法的IP地址，那么nginx将使用地址“<literal>255.255.255.255</literal>”。
56 </para>
57
58 <para>
59 nginx通过CIDR或者地址段（0.7.23版）来描述地址，同时支持下面的特殊参数：
60 <list type="tag">
61
62 <tag-name><literal>delete</literal></tag-name>
63 <tag-desc>
64 删除指定网络（0.7.23版）。
65 </tag-desc>
66
67 <tag-name><literal>default</literal></tag-name>
68 <tag-desc>
69 如果客户端地址不能匹配任意一个定义的地址，nginx将使用此值。
70 如果使用CIDR，可以用“<literal>0.0.0.0/0</literal>”代替<literal>default</literal>。
71 </tag-desc>
72
73 <tag-name><literal>include</literal></tag-name>
74 <tag-desc>
75 包含一个定义地址和值的文件。可以多次包含。
76 </tag-desc>
77
78 <tag-name><literal>proxy</literal></tag-name>
79 <tag-desc>
80 定义可信地址（0.8.7，0.7.63版）。
81 如果请求来自可信地址，nginx将使用其<header>X-Forwarded-For</header>头来获得地址。
82 相对于普通地址，可信地址是顺序检测的。
83 <note>
84 从1.3.0和1.2.1版本起，nginx开始支持IPv6地址。
85 </note>
86 </tag-desc>
87
88 <tag-name><literal>proxy_recursive</literal></tag-name>
89 <tag-desc>
90 开启递归查找地址（1.3.0，1.2.1版）。
91 如果关闭递归查找，在客户端地址与某个可信地址匹配时，nginx将使用<header>X-Forwarded-For</header>中的最后一个地址来代替原始客户端地址。
92 如果开启递归查找，在客户端地址与某个可信地址匹配时，nginx将使用<header>X-Forwarded-For</header>中最后一个与所有可信地址都不匹配的地址来代替原始客户端地址。
93 </tag-desc>
94
95 <tag-name><literal>ranges</literal></tag-name>
96 <tag-desc>
97 指示地址将定义为地址段的形式（0.7.23版）。这个参数应该第一个被定义。为了加速装载地址库，地址应按升序定义。
98 </tag-desc>
99
100 </list>
101 </para>
102
103 <para>
104 举例：
105 <example>
106 geo $country {
107 default ZZ;
108 include conf/geo.conf;
109 delete 127.0.0.0/16;
110 proxy 192.168.100.0/24;
111 proxy 2001:0db8::/32;
112
113 127.0.0.0/24 US;
114 127.0.0.1/32 RU;
115 10.1.0.0/16 RU;
116 192.168.1.0/24 UK;
117 }
118 </example>
119 </para>
120
121 <para>
122 <path>conf/geo.conf</path>文件中可能包含下列文本行：
123 <example>
124 10.2.0.0/16 RU;
125 192.168.2.0/24 RU;
126 </example>
127 </para>
128
129 <para>
130 nginx将使用能最精确匹配客户端地址的配置中定义的值。比如，对于地址127.0.0.1，nginx会选取“<literal>RU</literal>”而非“<literal>US</literal>”，作为变量值。
131 </para>
132
133 <para>
134 地址段的例子：
135 <example>
136 geo $country {
137 ranges;
138 default ZZ;
139 127.0.0.0-127.0.0.0 US;
140 127.0.0.1-127.0.0.1 RU;
141 127.0.0.1-127.0.0.255 US;
142 10.1.0.0-10.1.255.255 RU;
143 192.168.1.0-192.168.1.255 UK;
144 }
145 </example>
146 </para>
147
148 </directive>
149
150 </section>
151
152 </module>