Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_geo_module.xml @ 966:95c3c3bbf1ce
Text review.
author | Egor Nikitin <yegor.nikitin@gmail.com> |
---|---|
date | Wed, 14 Aug 2013 12:03:41 +0400 |
parents | 9dab69f2b71d |
children |
comparison
equal
deleted
inserted
replaced
965:fadccc156188 | 966:95c3c3bbf1ce |
---|---|
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_geo_module</literal> module creates variables | 18 The <literal>ngx_http_geo_module</literal> module creates variables |
19 whose values depend on the client IP address. | 19 with values depending on the client IP address. |
20 </para> | 20 </para> |
21 | 21 |
22 </section> | 22 </section> |
23 | 23 |
24 | 24 |
50 <context>http</context> | 50 <context>http</context> |
51 | 51 |
52 <para> | 52 <para> |
53 Describes the dependency of values of the specified variable | 53 Describes the dependency of values of the specified variable |
54 on the client IP address. | 54 on the client IP address. |
55 By default an address is taken from the <var>$remote_addr</var> variable | 55 By default, the address is taken from the <var>$remote_addr</var> variable, |
56 but it can also be taken from another variable (0.7.27), for example: | 56 but it can also be taken from another variable (0.7.27), for example: |
57 <example> | 57 <example> |
58 geo $arg_remote_addr $geo { | 58 geo $arg_remote_addr $geo { |
59 ...; | 59 ...; |
60 } | 60 } |
63 | 63 |
64 <para> | 64 <para> |
65 <note> | 65 <note> |
66 Since variables are evaluated only when used, the mere existence | 66 Since variables are evaluated only when used, the mere existence |
67 of even a large number of declared “<literal>geo</literal>” variables | 67 of even a large number of declared “<literal>geo</literal>” variables |
68 does not incur any extra costs for request processing. | 68 does not cause any extra costs for request processing. |
69 </note> | 69 </note> |
70 </para> | 70 </para> |
71 | 71 |
72 <para> | 72 <para> |
73 If the value of a variable does not represent a valid IP address | 73 If the value of a variable does not represent a valid IP address |
91 deletes the specified network (0.7.23). | 91 deletes the specified network (0.7.23). |
92 </tag-desc> | 92 </tag-desc> |
93 | 93 |
94 <tag-name><literal>default</literal></tag-name> | 94 <tag-name><literal>default</literal></tag-name> |
95 <tag-desc> | 95 <tag-desc> |
96 a value of variable if the client address does not | 96 a value set to the variable if the client address does not |
97 match any of the specified addresses. | 97 match any of the specified addresses. |
98 When addresses are specified in CIDR notation, | 98 When addresses are specified in CIDR notation, |
99 “<literal>0.0.0.0/0</literal>” and “<literal>::/0</literal>” | 99 “<literal>0.0.0.0/0</literal>” and “<literal>::/0</literal>” |
100 can be used instead of <literal>default</literal>. | 100 can be used instead of <literal>default</literal>. |
101 When <literal>default</literal> is not specified, the default | 101 When <literal>default</literal> is not specified, the default |
122 </tag-desc> | 122 </tag-desc> |
123 | 123 |
124 <tag-name><literal>proxy_recursive</literal></tag-name> | 124 <tag-name><literal>proxy_recursive</literal></tag-name> |
125 <tag-desc> | 125 <tag-desc> |
126 enables recursive address search (1.3.0, 1.2.1). | 126 enables recursive address search (1.3.0, 1.2.1). |
127 If recursive search is disabled then instead of an original client | 127 If recursive search is disabled then instead of the original client |
128 address that matches one of the trusted addresses, the last | 128 address that matches one of the trusted addresses, the last |
129 address sent in <header>X-Forwarded-For</header> will be used. | 129 address sent in <header>X-Forwarded-For</header> will be used. |
130 If recursive search is enabled then instead an original client | 130 If recursive search is enabled then instead of the original client |
131 address that matches one of the trusted addresses, the last | 131 address that matches one of the trusted addresses, the last |
132 non-trusted address sent in <header>X-Forwarded-For</header> will be used. | 132 non-trusted address sent in <header>X-Forwarded-For</header> will be used. |
133 </tag-desc> | 133 </tag-desc> |
134 | 134 |
135 <tag-name><literal>ranges</literal></tag-name> | 135 <tag-name><literal>ranges</literal></tag-name> |
136 <tag-desc> | 136 <tag-desc> |
137 indicates that addresses are specified as ranges (0.7.23). | 137 indicates that addresses are specified as ranges (0.7.23). |
138 This parameter should be the first. | 138 This parameter should be the first. |
139 To speed up loading of a geo base, addresses should be put in increasing order. | 139 To speed up loading of a geo base, addresses should be put in ascending order. |
140 </tag-desc> | 140 </tag-desc> |
141 | 141 |
142 </list> | 142 </list> |
143 </para> | 143 </para> |
144 | 144 |