comparison xml/ru/docs/http/ngx_http_geo_module.xml @ 797:55b633342309

Documented "geo" support of IPv6 address prefixes.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 26 Dec 2012 05:05:29 +0000
parents 753ed7df8910
children 9dab69f2b71d
comparison
equal deleted inserted replaced
796:a2f75649204c 797:55b633342309
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_geo_module" 10 <module name="Модуль ngx_http_geo_module"
11 link="/ru/docs/http/ngx_http_geo_module.html" 11 link="/ru/docs/http/ngx_http_geo_module.html"
12 lang="ru" 12 lang="ru"
13 rev="3"> 13 rev="4">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_geo_module</literal> создаёт переменные, 18 Модуль <literal>ngx_http_geo_module</literal> создаёт переменные,
26 26
27 <para> 27 <para>
28 <example> 28 <example>
29 geo $geo { 29 geo $geo {
30 default 0; 30 default 0;
31 127.0.0.1/32 2; 31
32 127.0.0.1 2;
32 192.168.1.0/24 1; 33 192.168.1.0/24 1;
33 10.1.0.0/16 1; 34 10.1.0.0/16 1;
35
36 ::1 2;
37 2001:0db8::/32 1;
34 } 38 }
35 </example> 39 </example>
36 </para> 40 </para>
37 41
38 </section> 42 </section>
70 Если значение переменной не представляет из себя правильный IP-адрес, 74 Если значение переменной не представляет из себя правильный IP-адрес,
71 то используется адрес “<literal>255.255.255.255</literal>”. 75 то используется адрес “<literal>255.255.255.255</literal>”.
72 </para> 76 </para>
73 77
74 <para> 78 <para>
75 Адреса задаются в виде CIDR или в виде диапазонов (0.7.23). 79 Адреса задаются либо префиксами в формате CIDR
80 (включая одиночные адреса), либо в виде диапазонов (0.7.23).
81 <note>
82 IPv6-префиксы поддерживаются начиная с версии 1.3.10.
83 </note>
84 </para>
85
86 <para>
76 Также поддерживаются следующие специальные параметры: 87 Также поддерживаются следующие специальные параметры:
77 <list type="tag"> 88 <list type="tag">
78 89
79 <tag-name><literal>delete</literal></tag-name> 90 <tag-name><literal>delete</literal></tag-name>
80 <tag-desc> 91 <tag-desc>
82 </tag-desc> 93 </tag-desc>
83 94
84 <tag-name><literal>default</literal></tag-name> 95 <tag-name><literal>default</literal></tag-name>
85 <tag-desc> 96 <tag-desc>
86 значение переменной, если адрес клиента не соответствует 97 значение переменной, если адрес клиента не соответствует
87 ни одному заданному адресу. 98 ни одному из заданных адресов.
88 При использовании CIDR вместо <literal>default</literal> можно 99 При задании адресов в формате CIDR
89 также написать “<literal>0.0.0.0/0</literal>”. 100 вместо <literal>default</literal> можно использовать
101 “<literal>0.0.0.0/0</literal>” и “<literal>::/0</literal>”.
90 Если параметр <literal>default</literal> не указан, значением 102 Если параметр <literal>default</literal> не указан, значением
91 по умолчанию будет пустая строка. 103 по умолчанию будет пустая строка.
92 </tag-desc> 104 </tag-desc>
93 105
94 <tag-name><literal>include</literal></tag-name> 106 <tag-name><literal>include</literal></tag-name>
103 при запросе с которых будет использоваться адрес в переданном 115 при запросе с которых будет использоваться адрес в переданном
104 поле заголовка запроса <header>X-Forwarded-For</header>. 116 поле заголовка запроса <header>X-Forwarded-For</header>.
105 В отличие от обычных адресов, доверенные адреса проверяются 117 В отличие от обычных адресов, доверенные адреса проверяются
106 последовательно. 118 последовательно.
107 <note> 119 <note>
108 IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1. 120 Доверенные IPv6-адреса поддерживаются начиная с версий 1.3.0 и 1.2.1.
109 </note> 121 </note>
110 </tag-desc> 122 </tag-desc>
111 123
112 <tag-name><literal>proxy_recursive</literal></tag-name> 124 <tag-name><literal>proxy_recursive</literal></tag-name>
113 <tag-desc> 125 <tag-desc>