Nginx中虚拟服务器server指令配置说明

server

虚拟服务器配置。可以基于IP配置,也可基于名称配置,二者没有明显的区分。listen指令描述server接收请求的所有地址和端口,server_name配置客户端可以请求到的所有服务器名称列表。

listen

为虚拟服务器接收请求设置IP和端口或者UNIX-domain套接字的路径。

  • 可以同时指定IP地址和端口;

  • 也可以只指定IP地址或只指定端口;

  • 只指定IP地址情况,端口默认是80

  • 地址也可以是主机名(hosts);

  • 0.7.36版本开始可以通过中括号指定IPV6地址;

    listen [::]:8000;
    listen [::1];
    
  • 0.8.21版本开始可通过unix:前缀指定UNIX-domain套接字路径;

    listen unix:/var/run/nginx.sock;
    
  • 没有显式配置listen指定的情况下,如果nginx是以超级权限用户运行的,则默认端口是80,否则默认是端口是8000

语法
listen address[:port] [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];

listen port [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];

listen unix:path [default_server] [ssl] [http2 | spdy] [proxy_protocol] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
默认值

listen *:80 | *:8000;

parameters列表

default_server

  • 指定当前服务器是指定地址和端口的默认服务器;
  • 如果所以的listen指令都没有配置default_server指令,则配置列表中的一个服务器为默认服务器;
  • 0.8.21版本之前default_serverdefault

ssl

指定当前端口下的所有请求都工作在SSL模式下(从0.7.14版本开始起用)。

server {
    listen              80;
    listen              443 ssl;
    server_name         www.example.com;
    ssl_certificate     www.example.com.crt;
    ssl_certificate_key www.example.com.key;
    ...
}

表示服务器可以同时处理HTTP和HTTPS请求。

http2

配置当前端口是接受HTTP/2 请求连接的,一般情况下应当同时指定ssl参数(可不指定)。(从1.9.5版本开始起用)

spdy

配置当前端口是接受SPDY请求链接的,一般情况下应当同时指定ssl参数(可不指定)。(在1.3.15-1.9.4版本中使用)

listen指令还有一些针对套接字调用相关的参数,参考官网指导手册

server_name

配置虚拟服务器的名称列表。

通过名称搜索虚拟服务器时,遵循以下规则:

  1. 确切名称匹配
  2. 以“*”起始的最长通配符名称匹配
  3. 以“*”结尾的最长通配符名称陪陪
  4. 第一个正则匹配(匹配顺序与配置顺序有关,匹配到第一个正则停止)
通配符名称

通配符名称是指在虚拟服务器名称前面或者后面配置一个“*”,紧接着“*”的是点(.)。

“*.example.org”可以匹配到“www.example.org”,也可以匹配到“www.sub.example.org”。

“.example.org”可以当做是“example.org”和“*.example.org”的组合。

类似“www.*.example.org”或者“w*.example.org"的配置是无效的。

正则表达式名称

正则表达式配置虚拟服务器名称需满足以下条件:

  • 一定要以波浪线(~)作为起始符号
  • 表达式放在在(^)和($)之间
  • 正则表达式中的点(.)需要用反斜杠(\)转义
  • 如果正则表达式中有花括号({}),正则表达式需要用引号("")括起来
server_name  ~^www\d+\.example\.net$;
server_name  "~^(?<name>\w\d{1,3}+)\.example\.net$";
混合名称

如果需要处理请求投中没有"Host"字段的请求,server_name中可以指定空引号("")。(从0.8.48版本开始,server_name默认是"",之前的版本默认是hostname)

也可以指定为具体的IP地址

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

_符号表示可以匹配所有的名称,无论是正规域名,还是形如“!@#”或者“--” 等不正规的名称皆可匹配。(这种方式不推荐使用)

server {
    listen       80  default_server;
    server_name  _;
    return       444;
}

可以在server_name指令中通过使用ASCII (Punycode) 表示国际化域名(IDNs)

server {
    listen       80;
    server_name  xn--e1afmkfd.xn--80akhbyknj4f;  
    ...
}
最佳实践

确切名称、以星号起始的通配符名称、以星号结尾的通配符名称分别存储在绑定于端口的三张哈希表中,哈希表搜索顺序如前面所述

  1. 确切名称
  2. 以星号起始的通配符名称
  3. 以星号结束的通配符名称
  4. 正则表达式

搜索速度由快到慢顺序

  1. 确切名称
  2. 通配符
  3. 正则表达式

因此,尽可能的配置确切名称。比如请求exmaple.orgwww.example.org的频率较高,那么如下第一种配置明显优于第二种配置

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

如果配置服务器名称过多或者长度过长,可能需要调整server_names_hash_max_size
server_names_hash_bucket_size指令。

location

配置请求URI。

语法
location [ = | ~ | ~* | ^~ ] uri { ... }

location @name { ... }
默认值

-

说明
  • 匹配是针对规范化URI执行的,对形如“%XX”的编码文本会进行解码操作,对.或者..的相对路径引用会进行解析,对相邻的两个或多个斜杠会压缩成一个;

  • location可以通过前缀串定义,也可以通过正则表达式定义;

  • 通过正则表达式定义时,~*作为前修饰符表示大小写不敏感,~作为前修饰符表示大小写敏感;

  • 根据请求匹配location的过程

    1. 在配置的location列表中搜索URI不带参数的最完整字符串,逐渐减短匹配串,最长的成功匹配将会被选择并保存;
    2. 根据配置顺序匹配正则表达式,匹配成功则停止;
    3. 如果正则表达式匹配成功,则使用正则表达式匹配成功的location,否则使用第一步匹配到的location
  • 前缀匹配中匹配到的最长location如果有^~作为前修饰符,则不会进行正则匹配;

  • 如果使用=修饰,会进行确切值的匹配,且匹配成功停止继续匹配;该location不可嵌套其他location

  • 在0.7.1版本到0.8.41版本中,匹配打的前缀location即使没有=或者^~作为前修饰符,也会停止匹配;

  • @作为前缀定义的lcation,不用来处理常规请求,而是用来重定向请求;这种location不能被嵌套,也不能其它location

  • 如果一个前缀字符串定义到location以斜杠(/)结尾,请求被proxy_passfastcgi_passuwsgi_pass,
    scgi_passmemcached_passgrpc_pass处理,请求会转向原请求串不带后斜杠的请求上,301(永久重定向)码会返回给带有后斜杠的请求。可以通过下面的方式配置完全匹配来解决:

    location /user/ {
        proxy_pass http://user.example.com;
    }
    
    location = /user {
        proxy_pass http://login.example.com;
    }
    

其他文章列表

spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml详解
Nginx转发请求过程解析
Nginx中的负载均衡算法
Nginx upstream指令配置说明
Nginx中proxy_pass/proxy_redirect/proxy_set_header配置说明
Nginx中ngx_http_core_module相关指令配置说明
Java自带JVM监控工具jstat使用详细说明
Java自带JVM监控工具jps使用详细说明
Java自带故障分析工具jmap工具使用说明
Java自带故障分析工具jhat工具使用说明

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