Mercurial > hg > nginx-site

comparison xml/cn/docs/http/server_names.xml @ 558:149f54c158f0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added initial translation in simplified Chinese submitted by the Server Platforms Team at Taobao.com.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 28 Jun 2012 10:27:07 +0000
parents
children 130fad6dc1b4
comparison
equal deleted inserted replaced
557:654096219aba 558:149f54c158f0
1 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
2
3 <article name="虚拟主机名"
4 link="/cn/docs/http/server_names.html"
5 lang="cn"
6 author="Igor Sysoev"
7 editor="Brian Mercer">
8
9
10 <section>
11
12 <para>
13
14 虚拟主机名使用<literal>server_name</literal>指令定义，并用于决定某个请求应由哪台虚拟主机处理。具体请参考《<link doc="request_processing.xml">nginx如何处理一个请求</link>》。虚拟主机名可以使用确切的名字，通配符，或者是正则表达式来定义：
15
16 <programlisting>
17 server {
18 listen 80;
19 server_name nginx.org www.nginx.org;
20 ...
21 }
22
23 server {
24 listen 80;
25 server_name *.nginx.org;
26 ...
27 }
28
29 server {
30 listen 80;
31 server_name mail.*;
32 ...
33 }
34
35 server {
36 listen 80;
37 server_name ~^(?&lt;user&gt;.+)\.nginx\.net$;
38 ...
39 }
40 </programlisting>
41
42 nginx将以下面顺序检测名字：
43
44 <list type="enum">
45
46 <listitem>
47 确切的名字；
48 </listitem>
49
50 <listitem>
51 以星号起始的通配符名字：<url>*.nginx.org</url>；
52 </listitem>
53
54 <listitem>
55 以星号结束的通配符名字：<url>mail.*</url>；
56 </listitem>
57
58 <listitem>
59 正则表达式名字，按在配置文件中出现的顺序遍历。
60 </listitem>
61
62 </list>
63 一旦匹配成功，停止搜索。
64 </para>
65
66 </section>
67
68
69 <section id="wildcard_names"
70 name="通配符名字">
71
72 <para>
73 通配符名字只可以在名字的起始处或结尾处包含一个星号，并且星号与其他字符之间用点分隔。所以，<literal>www.*.nginx.org</literal>和<literal>w*.nginx.org</literal>都是非法的。不过，上面的两个名字可以使用正则表达式描述：<literal>~^www\..+\.nginx\.org$</literal>和<literal>~^w.*\.nginx\.org$</literal>。星号可以匹配名字的多个节（各节都是以点号分隔的），比如<literal>*.nginx.org</literal>不仅匹配<url>www.nginx.org</url>，也匹配<url>www.sub.nginx.org</url>。
74 </para>
75
76 <para>
77 有一种形如<literal>.nginx.org</literal>的特殊通配符，它可以既匹配确切的名字<literal>nginx.org</literal>，又可以匹配一般的通配符名字<literal>*.nginx.org</literal>。
78 </para>
79
80 </section>
81
82
83 <section id="regex_names"
84 name="正则表达式名字">
85
86 <para>
87 nginx使用兼容PCRE的正则表达式。为了使用正则表达式，虚拟主机名必须以波浪线“~”起始：
88
89 <programlisting>
90 server_name ~^www\d+\.nginx\.net$;
91 </programlisting>
92
93 否则该名字会被认为是确切的名字，如果表达式含星号，则会被认为是通配符名字（很可能是一个非法的通配符名字）。不要忘记设置&ldquo;^&rdquo;和&ldquo;$&rdquo;锚点，语法上不是必须的，但是逻辑上是需要的。同时需要注意的是，域名中的点&ldquo;.&rdquo;需要用反斜线&ldquo;\&rdquo;转义。正则表达式中含有&ldquo;{&rdquo;和&ldquo;}&rdquo;，那么正则表达式需要被引用，如：
94
95 <programlisting>
96 server_name "~^(?&lt;name&gt;\w\d<b>{</b>1,3<b>}</b>+)\.nginx\.net$";
97 </programlisting>
98
99 否则nginx就不能启动，错误提示是：
100
101 <programlisting>
102 directive "server_name" is not terminated by ";" in ...
103 </programlisting>
104
105 命名的正则表达式捕获组在后面可以作为变量使用：
106
107 <programlisting>
108 server {
109 server_name ~^(www\.)?(<b>?&lt;domain&gt;</b>.+)$;
110
111 location / {
112 root /sites/<b>$domain</b>;
113 }
114 }
115 </programlisting>
116
117 PCRE使用下面语法支持命名捕获组：
118
119 <table note="yes">
120
121 <tr>
122 <td><literal>?&lt;<value>name</value>&gt;</literal></td>
123 <td>从PCRE-7.0开始支持，兼容Perl 5.10语法</td>
124 </tr>
125
126 <tr>
127 <td><literal>?'<value>name</value>'</literal></td>
128 <td>从PCRE-7.0开始支持，兼容Perl 5.10语法</td>
129 </tr>
130
131 <tr>
132 <td><literal>?P&lt;<value>name</value>&gt;</literal></td>
133 <td>从PCRE-4.0开始支持，兼容Python语法</td>
134 </tr>
135
136 </table>
137
138 如果nginx不能启动，并显示错误信息：
139
140 <programlisting>
141 pcre_compile() failed: unrecognized character after (?&lt; in ...
142 </programlisting>
143
144 说明PCRE版本太旧，应该尝试使用<literal>?P&lt;name&gt;</literal>。捕获组也可以以数字方式引用：
145
146 <programlisting>
147 server {
148 server_name ~^(www\.)?(.+)$;
149
150 location / {
151 root /sites/<b>$2</b>;
152 }
153 }
154 </programlisting>
155
156 不过，这种用法只限于简单的情况（比如上面的例子），因为数字引用很容易被覆盖。
157 </para>
158
159
160 </section>
161
162
163 <section id="miscellaneous_names"
164 name="其他类型的名字">
165
166 <para>
167 如果需要用一个非默认的虚拟主机处理请求头中不含&ldquo;Host&rdquo;字段的请求，需要指定一个空名字：
168
169 <programlisting>
170 server {
171 listen 80;
172 server_name nginx.org www.nginx.org "";
173 ...
174 }
175 </programlisting>
176 </para>
177
178 <para>
179 如果server块中没有定义<literal>server_name</literal>，nginx使用空名字作为虚拟主机名。
180 <note>
181 同样的情况下，nginx 0.8.48版本以下（含）使用<i>本地主机名</i>作为虚拟主机名。
182 </note>
183 </para>
184
185 <para>
186 如果使用IP地址而不是主机名来请求服务器，那么请求头的&ldquo;HOST&rdquo;字段包含的将是IP地址。可以将IP地址作为虚拟主机名来处理这种请求：
187
188 <programlisting>
189 server {
190 listen 80;
191 server_name nginx.org
192 www.nginx.org
193 ""
194 <b>192.168.1.1</b>
195 ;
196 ...
197 }
198 </programlisting>
199 </para>
200
201 <para>
202 在匹配所有的服务器的例子中，可以见到一个奇怪的名字&ldquo;_&rdquo;：
203
204 <programlisting>
205 server {
206 listen 80 default_server;
207 server_name _;
208 return 444;
209 }
210 </programlisting>
211
212 这没什么特别的，它只不过是成千上万的与真实的名字毫不相干的非法域名中的一个而已。当然，也可以使用&ldquo;--&rdquo;、&ldquo;!@#&rdquo;等等。
213 </para>
214
215 <para>
216 nginx直到0.6.25版本还支持一个特殊的名字&ldquo;*&rdquo;，这个名字一直被错误地理解成是一个匹配所有的名字。但它从来没有像匹配所有的名字，或者通配符那样工作过，而是用来支持一种功能，此功能现在已经改由<literal>server_name_in_redirect</literal>指令提供支持了。所以，现在这个特殊的名字&ldquo;*&rdquo;就过时了，应该使用<literal>server_name_in_redirect</literal>指令。需要注意的是，使用<literal>server_name</literal>指令无法描述匹配所有的名字或者默认服务器，需要使用<literal>listen</literal>指令的一个属性来完成这项工作。具体请参考《<link doc="request_processing.xml">nginx如何处理一个请求</link>》。可以定义两个服务器都监听*:80和*:8080端口，然后指定一个作为端口*:8080的默认服务器，另一个作为端口*:80的默认服务器：
217
218 <programlisting>
219 server {
220 listen 80;
221 listen 8080 default_server;
222 server_name nginx.net;
223 ...
224 }
225
226 server {
227 listen 80 default_server;
228 listen 8080;
229 server_name nginx.org;
230 ...
231 }
232 </programlisting>
233 </para>
234
235
236 </section>
237
238
239 <section id="optimization"
240 name="优化">
241
242 <para>
243 确切名字和通配符名字存储在哈希表中。哈希表和监听端口关联，每个端口都最多关联到三张表：确切名字的哈希表，以星号起始的通配符名字的哈希表和以星号结束的通配符名字的哈希表。哈希表的尺寸在配置阶段进行了优化，可以以最小的CPU缓存命中失败来找到名字。nginx首先搜索确切名字的哈希表，如果没有找到，搜索以星号起始的通配符名字的哈希表，如果还是没有找到，继续搜索以星号结束的通配符名字的哈希表。因为名字是按照域名的节来搜索的，所以搜索通配符名字的哈希表比搜索确切名字的哈希表慢。注意<literal>.nginx.org</literal>存储在通配符名字的哈希表中，而不在确切名字的哈希表中。正则表达式是一个一个串行的测试，所以是最慢的，而且不可扩展。
244 </para>
245
246 <para>
247 鉴于以上原因，请尽可能使用确切的名字。举个例子，如果使用<url>nginx.org</url>和<url>www.nginx.org</url>来访问服务器是最频繁的，那么将它们明确的定义出来就更为有效：
248
249 <programlisting>
250 server {
251 listen 80;
252 server_name nginx.org www.nginx.org *.nginx.org;
253 ...
254 }
255 </programlisting>
256
257 下面这种方法相比更简单，但是效率也更低：
258
259 <programlisting>
260 server {
261 listen 80;
262 server_name .nginx.org;
263 ...
264 }
265 </programlisting>
266 </para>
267
268 <para>
269 如果定义了大量名字，或者定义了非常长的名字，那就需要在<i>http</i>配置块中调整<literal>server_names_hash_max_size</literal>和<literal>server_names_hash_bucket_size</literal>的值。<literal>server_names_hash_bucket_size</literal>的默认值可能是32，或者是64，或者是其他值，取决于CPU的缓存行的长度。如果这个值是32，那么定义&ldquo;too.long.server.name.nginx.org&rdquo;作为虚拟主机名就会失败，显示下面错误信息：
270 <programlisting>
271 could not build the server_names_hash,
272 you should increase server_names_hash_bucket_size: 32
273 </programlisting>
274
275 出现了这种情况，那就需要将设置值扩大一倍：
276
277 <programlisting>
278 http {
279 server_names_hash_bucket_size 64;
280 ...
281 </programlisting>
282
283 如果定义了大量名字，得到了另外一个错误：
284
285 <programlisting>
286 could not build the server_names_hash,
287 you should increase either server_names_hash_max_size: 512
288 or server_names_hash_bucket_size: 32
289 </programlisting>
290
291 那么应该先尝试设置<literal>server_names_hash_max_size</literal>的值差不多等于名字列表的名字总量。如果还不能解决问题，或者服务器启动非常缓慢，再尝试提高<literal>server_names_hash_bucket_size</literal>的值。
292 </para>
293
294 <para>
295 如果只为一个监听端口配置了唯一的主机，那么nginx就完全不会测试虚拟主机名了（也不会建立那些名字哈希表）。不过，有一个例外，如果<literal>server_name</literal>是一个含有捕获组的正则表达式，这时nginx就不得不执行这个表达式以得到捕获组。
296 </para>
297
298 </section>
299
300
301 <section id="compatibility"
302 name="兼容性">
303
304 <para>
305 <list type="bullet">
306
307 <listitem>
308 从0.8.48版本开始，默认的虚拟主机名是空名字&ldquo;&rdquo;。
309 </listitem>
310
311 <listitem>
312 从0.8.25版本开始，支持虚拟主机名中使用命名的正则表达式捕获组。
313 </listitem>
314
315 <listitem>
316 从0.7.40版本开始，支持虚拟主机名中使用正则表达式的捕获组。
317 </listitem>
318
319 <listitem>
320 从0.7.12版本开始，支持空名字&ldquo;&rdquo;。
321 </listitem>
322
323 <listitem>
324 从0.6.25版本开始，通配符和正则表达式名字可以作为第一个虚拟主机名。
325 </listitem>
326
327 <listitem>
328 从0.6.7版本开始，支持正则表达式的虚拟主机名。
329 </listitem>
330
331 <listitem>
332 从0.6.0版本开始，支持形如<url>nginx.*</url>的通配符名字。
333 </listitem>
334
335 <listitem>
336 从0.3.18版本开始，支持形如<url>.nginx.org</url>的特殊通配符名字。
337 </listitem>
338
339 <listitem>
340 从0.1.13版本开始，支持形如<url>*.nginx.org</url>的通配符名字。
341 </listitem>
342
343 </list>
344 </para>
345
346 </section>
347
348 </article>