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,究竟使用哪个由以下优先级决定。

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

通配符名称

通配符名称只能在名称的开始或结束处包含星号,并且只能在点的边上包含星号。所以,诸如www.*.example.orgw*.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)

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

  1. 请求不含Host头部。如果不使用默认,就必须显示指定一个空字符串。
server {
    listen       80;
    server_name  example.org  www.example.org  "";
    ...
}
  1. 请求的Host头部中的值为IP地址
server {
    listen       80;
    server_name  example.org
                 www.example.org
                 ""
                 192.168.1.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_sizeserver_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之类的通配符服务器名称
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,509评论 6 504
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,806评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,875评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,441评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,488评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,365评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,190评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,062评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,500评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,706评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,834评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,559评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,167评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,779评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,912评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,958评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,779评论 2 354

推荐阅读更多精彩内容