nginx-3 服务器名称
服务器名称作为在server_name
指令的参数,掌控着使用哪个server
处理request
的决定权。详见如何处理一个请求。它可以分为全名称(exact names)、通配符名称(wildcard names)和正则名称(regular expressions)三种类型。
server {
listen 80;
server_name example.org www.example.org;
...
}
server {
listen 80;
server_name *.example.org;
...
}
server {
listen 80;
server_name mail.*;
...
}
server {
listen 80;
server_name ~^(?<user>.+)\.example\.net$;
...
}
当通过名称查找一个虚拟服务器时,如果匹配到多个server_name
,究竟使用哪个由以下优先级决定。
- 全名称
- 以 * 开头的最长通配符名称,比如
*.example.org
- 以 * 结尾的最长通配符名称,比如
mail.*
- 第一个匹配的正则名称(按配置文件中的出现顺序)
通配符名称
通配符名称只能在名称的开始或结束处包含星号,并且只能在点的边上包含星号。所以,诸如www.*.example.org
和w*.example.org
都是不合法的。但是,这类名称可以通过正则表达式实现。例如~^www\..+\.example\.org$
和~^w.*\.example\.org$
。一个星号可以匹配多个名称部分。例如,*.example.org
既可以匹配www.example.org
也可以匹配www.sub.example.org
。
.example.org
是个特殊的通配符名称,既可以匹配全名称example.org
,也可以匹配通配符名称*.example.org
。
正则名称
要使用正则表达式,服务器名称必须要以波浪号~起头。
server_name ~^www\d+\.example\.net$;
否则,它将被视为一个全名称,或者如果表达式包含一个星号,它将被视为一个通配符名称(很可能是一个无效的名称)。不要忘记设置“^”和“表示结尾)。还要注意域名点应该用反斜杠转义。包含花括号{}的正则表达式应该被""引用。
server_name "~^(?<name>\w\d{1,3}+)\.example\.net$";
A named regular expression capture can be used later as a variable:
server {
server_name ~^(www\.)?(?<domain>.+)$;
location / {
root /sites/$domain;
}
}
其他名称(Miscellaneous names)
总是存在一些服务器名称是要被特殊对待的。
- 请求不含Host头部。如果不使用默认,就必须显示指定一个空字符串。
server {
listen 80;
server_name example.org www.example.org "";
...
}
- 请求的Host头部中的值为IP地址
server {
listen 80;
server_name example.org
www.example.org
""
192.168.1.1
;
...
}
- 请求的Host头部中的值为无效域名,如---或者!@#
server {
listen 80 default_server;
server_name _;
return 444;
}
不存在匹配所有的域名并且指定默认服务器,默认服务器是listem port的属性。
server {
listen 80;
listen 8080 default_server;
server_name example.net;
...
}
server {
listen 80 default_server;
listen 8080;
server_name example.org;
...
}
国际化名称
国际化域名(IDN)应使用服务器名称指令中的ASCII(punycode)表示形式指定:
server {
listen 80;
server_name xn--e1afmkfd.xn--80akhbyknj4f; # пример.испытание
...
}
优化(Optimization)
查找速度
全名称 > 通配符名称 > 正则名称
因此,为了最佳的查找性能,应该优先使用全名称,再考虑通配符名称,最后再考虑正则名称。
server {
listen 80;
server_name example.org www.example.org *.example.org;
...
}
# 显然,上面的配置的查找性能更好。下面会被解释成 *.example.org。
server {
listen 80;
server_name .example.org;
...
}
如果定义了大量的服务器名称,或者定义了过长的服务器名称。则可能需要在HTTP级别使用server_names_hash_max_size
和server_names_hash_bucket_size
指令调整值。
兼容性(Compatibility)
对应server_name的参数,不同版本的nginx所支持的特性有所不同。
- 0.9.4 开始支持
$hostname
这个特殊的服务器名称 - 0.8.48 开始
server_name
的默认值是空字符串""
- 0.8.25 开始支持
Named regular expression server name captures
- 0.7.47 开始支持
Regular expression server name captures
- 0.7.12 开始支持空服务器名称
""
- 0.6.25 开始支持通配符或者正则表达式名称作为首个服务器名称(server_name)
- 0.6.7 开始支持正则表达式服务器名称
- 0.6.0 开始支持
example.*
之类的通配符服务器名称 - 0.3.18 开始支持
.example.org
这类特殊格式服务器名称 - 0.1.13 开始支持
*.example.org
之类的通配符服务器名称