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

2019-12-08 本文已影响0人 Elf_乐易

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_server是default。

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

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

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

确切名称匹配
以“*”起始的最长通配符名称匹配
以“*”结尾的最长通配符名称陪陪
第一个正则匹配（匹配顺序与配置顺序有关，匹配到第一个正则停止）

通配符名称

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

“*.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;  
    ...
}

最佳实践

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

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

搜索速度由快到慢顺序

确切名称
通配符
正则表达式

因此，尽可能的配置确切名称。比如请求exmaple.org和www.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_pass，fastcgi_pass，uwsgi_pass,
scgi_pass，memcached_pass，grpc_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工具使用说明