server
虚拟服务器配置。可以基于IP配置，也可基于名称配置，二者没有明显的区分。listen指令描述server接收请求的所有地址和端口，server_name配置客户端可以请求到的所有服务器名称列表。
listen
为虚拟服务器接收请求设置IP和端口或者UNIX-domain套接字的路径。
- 可以同时指定IP地址和端口；
- 也可以只指定IP地址或只指定端口；
- 只指定IP地址情况，端口默认是
80； - 地址也可以是主机名（hosts）；
- 0.7.36版本开始可以通过中括号指定IPV6地址；
|
1 2 |
listen [::]:8000; listen [::1]; |
0.8.21版本开始可通过unix:前缀指定UNIX-domain套接字路径；
|
1 |
listen unix:/var/run/nginx.sock; |
- 没有显式配置
listen指定的情况下，如果nginx是以超级权限用户运行的，则默认端口是80，否则默认是端口是8000。
语法
|
1 2 3 4 5 |
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版本开始起用）。
|
1 2 3 4 5 6 7 8 |
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”的配置是无效的。
正则表达式名称
正则表达式配置虚拟服务器名称需满足以下条件：
- 一定要以波浪线（
~）作为起始符号 - 表达式放在在（
^）和（$）之间 - 正则表达式中的点（
.）需要用反斜杠（\）转义 - 如果正则表达式中有花括号（
{}），正则表达式需要用引号（""）括起来
|
1 2 |
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地址
|
1 2 3 4 5 6 7 8 9 |
server { listen 80; server_name example.org www.example.org "" 192.168.1.1 ; ... } |
_符号表示可以匹配所有的名称，无论是正规域名，还是形如“!@#”或者“--” 等不正规的名称皆可匹配。（这种方式不推荐使用）
|
1 2 3 4 5 |
server { listen 80 default_server; server_name _; return 444; } |
可以在server_name指令中通过使用ASCII (Punycode) 表示国际化域名(IDNs)
|
1 2 3 4 5 |
server { listen 80; server_name xn--e1afmkfd.xn--80akhbyknj4f; ... } |
最佳实践
确切名称、以星号起始的通配符名称、以星号结尾的通配符名称分别存储在绑定于端口的三张哈希表中，哈希表搜索顺序如前面所述
- 确切名称
- 以星号起始的通配符名称
- 以星号结束的通配符名称
- 正则表达式
搜索速度由快到慢顺序
- 确切名称
- 通配符
- 正则表达式
因此，尽可能的配置确切名称。比如请求exmaple.org和www.example.org的频率较高，那么如下第一种配置明显优于第二种配置
|
1 2 3 4 5 |
server { listen 80; server_name example.org www.example.org *.example.org; ... } |
|
1 2 3 4 5 |
server { listen 80; server_name .example.org; ... } |
如果配置服务器名称过多或者长度过长，可能需要调整server_names_hash_max_size
和 server_names_hash_bucket_size指令。
location
配置请求URI。
语法
|
1 2 3 |
location [ = | ~ | ~* | ^~ ] uri { ... } location @name { ... } |
默认值
-
说明
- 匹配是针对规范化URI执行的，对形如“%XX”的编码文本会进行解码操作，对
.或者..的相对路径引用会进行解析，对相邻的两个或多个斜杠会压缩成一个； location可以通过前缀串定义，也可以通过正则表达式定义；- 通过正则表达式定义时，
~*作为前修饰符表示大小写不敏感，~作为前修饰符表示大小写敏感； - 根据请求匹配
location的过程- 在配置的
location列表中搜索URI不带参数的最完整字符串，逐渐减短匹配串，最长的成功匹配将会被选择并保存； - 根据配置顺序匹配正则表达式，匹配成功则停止；
- 如果正则表达式匹配成功，则使用正则表达式匹配成功的
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（永久重定向）码会返回给带有后斜杠的请求。可以通过下面的方式配置完全匹配来解决：
|
1 2 3 4 5 6 7 |
location /user/ { proxy_pass http://user.example.com; } location = /user { proxy_pass http://login.example.com; } |
浏览量: 11