Mercurial > hg > nginx-site

comparison xml/cn/docs/http/ngx_http_referer_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_referer_module模块"
11 link="/cn/docs/http/ngx_http_referer_module.html"
12 lang="cn"
13 translator="nigelzeng"
14 rev="1">
15
16 <section id="summary">
17
18 <para>
19 <literal>ngx_http_referer_module</literal>模块允许拦截<header>Referer</header>请求头中含有非法值的请求，阻止它们访问站点。
20 需要注意的是伪造一个有效的<header>Referer</header>请求头是相当容易的，
21 因此这个模块的预期目的不在于彻底地阻止这些非法请求，而是为了阻止由正常浏览器发出的大规模此类请求。
22 还有一点需要注意，即使正常浏览器发送的合法请求，也可能没有<header>Referer</header>请求头。
23 </para>
24
25 </section>
26
27
28 <section id="example" name="配置实例">
29
30 <para>
31 <example>
32 valid_referers none blocked server_names
33 *.example.com example.* www.example.org/galleries/
34 ~\.google\.;
35
36 if ($invalid_referer) {
37 return 403;
38 }
39 </example>
40 </para>
41
42 </section>
43
44
45 <section id="directives" name="指令">
46
47 <directive name="referer_hash_bucket_size">
48 <syntax><value>size</value></syntax>
49 <default>64</default>
50 <context>server</context>
51 <context>location</context>
52 <appeared-in>1.0.5</appeared-in>
53
54 <para>
55 设置用来存储有效referer的哈希表的表项长度。
56 详细的情况参见<link doc="../hash.xml">哈希表设置</link>。
57 </para>
58
59 </directive>
60
61
62 <directive name="referer_hash_max_size">
63 <syntax><value>size</value></syntax>
64 <default>2048</default>
65 <context>server</context>
66 <context>location</context>
67 <appeared-in>1.0.5</appeared-in>
68
69 <para>
70 设置用来存储有效referer的哈希表最大<value>桶容量</value>。
71 详细的情况参见<link doc="../hash.xml">哈希表设置</link>。
72 </para>
73
74 </directive>
75
76
77 <directive name="valid_referers">
78 <syntax>
79 <literal>none</literal> |
80 <literal>blocked</literal> |
81 <literal>server_names</literal> |
82 <value>string</value>
83 ...</syntax>
84 <default/>
85 <context>server</context>
86 <context>location</context>
87
88 <para>
89 <header>Referer</header>请求头为指定值时，内嵌变量<var>$invalid_referer</var>被设置为空字符串，
90 否则这个变量会被置成“<literal>1</literal>”。查找匹配时不区分大小写。
91 </para>
92
93 <para>
94 该指令的参数可以为下面的内容：
95 <list type="tag">
96
97 <tag-name><literal>none</literal></tag-name>
98 <tag-desc>
99 缺少<header>Referer</header>请求头；
100 </tag-desc>
101
102 <tag-name><literal>blocked</literal></tag-name>
103 <tag-desc>
104 <header>Referer</header> 请求头存在，但是它的值被防火墙或者代理服务器删除；
105 这些值都不以“<literal>http://</literal>” 或者 “<literal>https://</literal>”字符串作为开头；
106 </tag-desc>
107
108 <tag-name><literal>server_names</literal></tag-name>
109 <tag-desc>
110 <header>Referer</header> 请求头包含某个虚拟主机名；
111 </tag-desc>
112
113 <tag-name>任意字符串</tag-name>
114 <tag-desc>
115 定义一个服务器名和可选的URI前缀。服务器名允许在开头或结尾使用“<literal>*</literal>”符号。
116 当nginx检查时，<header>Referer</header>请求头里的服务器端口将被忽略。
117 </tag-desc>
118
119 <tag-name>正则表达式</tag-name>
120 <tag-desc>
121 必须以“<literal>~</literal>”符号作为开头。
122 需要注意的是表达式会从“<literal>http://</literal>”或者“<literal>https://</literal>”之后的文本开始匹配。
123 </tag-desc>
124
125 </list>
126 </para>
127
128 <para>
129 实例:
130 <example>
131 valid_referers none blocked server_names
132 *.example.com example.* www.example.org/galleries/
133 ~\.google\.;
134 </example>
135 </para>
136
137 </directive>
138
139 </section>
140
141 </module>