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  ~^(?.+)\.example\.net$;
    ...
}

当通过名称查找一个虚拟服务器时，如果匹配到多个server_name，究竟使用哪个由以下优先级决定。

1. 全名称
2. 以 * 开头的最长通配符名称，比如 *.example.org
3. 以 * 结尾的最长通配符名称，比如 mail.*
4. 第一个匹配的正则名称（按配置文件中的出现顺序）

通配符名称

通配符名称只能在名称的开始或结束处包含星号，并且只能在点的边上包含星号。所以，诸如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  "~^(?\w\d{1,3}+)\.example\.net$";

A named regular expression capture can be used later as a variable:

server {
    server_name   ~^(www\.)?(?.+)$;

    location / {
        root   /sites/$domain;
    }
}

其他名称（Miscellaneous names）

总是存在一些服务器名称是要被特殊对待的。

1. 请求不含Host头部。如果不使用默认，就必须显示指定一个空字符串。

server {
    listen       80;
    server_name  example.org  www.example.org  "";
    ...
}

2. 请求的Host头部中的值为IP地址

server {
    listen       80;
    server_name  example.org
                 www.example.org
                 ""
                 192.168.1.1
                 ;
    ...
}

3. 请求的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之类的通配符服务器名称