Nginx localhost路由匹配规则

URI 即统一标识资源符,通用的 URI 语法格式如下:

scheme:[//[user[:password]@]host[:port]][/path][?query][#fragment]

格式说明如下:
  • 在 Nginx 的应用场景中,URL 与 URI 并无明确区别。URI 标准(RFC3986)中约定,URL 是 URI 的一个子集;
  • scheme 是 URI 请求时遵守的协议,常见的有 HTTP、HTTPS、FTP;
  • host[:port] 是主机名与端口号,HTTP 协议的默认端口是 80,HTTPS 协议的默认端口是 443;
  • [/path] 是访问路径与访问文件名;
  • [?query] 是访问参数,访问参数以“?”开始作标识,由多个以“&”连接的 key=value 形式的字符串组成。

1、URI 匹配规则

location 是 Nginx 对 HTTP 请求中的 URI 进行匹配处理的指令,location 的语法形式如下:

location [=|~|~*|^~|@] pattern { ... }

其中,[=|~*|^~|@]部分称为 location 修饰语(Modifier),修饰语定义了与 URI 的匹配方式。pattern 为匹配项,可以是字符串或正则表达式。

无修饰语:完全匹配 URI 中除访问参数以外的内容,匹配项的内容只能是字符串,不能是正则表达式。

location /images {
    root /data/web;
}

修饰语“=”:完全匹配 URI 中除访问参数以外的内容,Linux 系统下会区分大小写,Windows 系统下则不会。

location = /images {
    root /data/web;
}

修饰语“~”:完全匹配 URI 中除访问参数以外的内容,Linux 系统下会区分大小写,Windows 系统下则会无效。匹配项的内容必须是正则表达式。

location ~ /images/.*\.(gif|jpg|png)$ {
    root /data/web;
}

修饰语“~*”:完全匹配 URI 中除访问参数以外的内容,不区分大小写。匹配项的内容必须是正则表达式。

location ~* \.(gif|jpg|png)$ {
    root /data/web;
}

修饰语“^~”:完全匹配 URI 中除访问参数以外的内容,匹配项的内容如果不是正则表达式,则不再进行正则表达式测试。

location ^~ /images {
    root /data/web;
}

修饰语“@”:定义一个只能内部访问的 location 区域,可以被其他内部跳转指令使用,如 try_files 或 error_page。

location @images { 
    proxy_pass http://images; 
}

2、匹配顺序

1) 先检测匹配项的内容为非正则表达式修饰语的 location,然后再检测匹配项的内容为正则表达式修饰语的 location。

2) 匹配项的内容为正则与非正则都匹配的 location,按照匹配项的内容为正则匹配的 location 执行。

3) 所有匹配项的内容均为非正则表达式的 location,按照匹配项的内容完全匹配的内容长短进行匹配,即匹配内容多的 location 被执行。

4) 所有匹配项的内容均为正则表达式的 location,按照书写的先后顺序进行匹配,匹配后就执行,不再做后续检测。

3、其他事项

当 location 为正则匹配且内部有 proxy_pass 指令时,proxy_pass 的指令值中不能包含无变量的字符串。修饰语“^~”不受该规则限制。

location ~ /images { 
    proxy_pass http://127.0.0.1:8080;                                 # 正确的指令值
    proxy_pass http://127.0.0.1:8080$request_uri;             # 正确的指令值
    proxy_pass http://127.0.0.1:8080/image$request_uri; # 正确的指令值
    proxy_pass http://127.0.0.1:8080/;                               # 错误的指令值
}

4、访问路由指令

访问路由指令如下面表格所示。

表:合并空斜线指令
名称 合并空斜线指令
指令 merge_slashes
作用域 http, server, location
默认值 on
指令值选项 off 或 on
指令说明 当指令值为 on,在访问路径中相邻斜线内容为空时进行合并

配置样例如下:

http {
    merge_slashes off;
}


表:跳转主机名指令
名称 跳转主机名指令
指令 server_name_in_redirect
作用域 http, server, location
默认值 off
指令说明 默认情况下,Nginx 重定向时,会用当前 server 指令域中主机的 IP 与 path 拼接成完整的 URL 进行重定向。开启该参数后,Nginx 会先查看当前指令域中 server_name 的第一个主机名,如果没有,则会查找请求头中 host 字段的内容,如果再没有则会用 IP 与 path 进行拼接

配置样例如下:

http {
    server_name_in_redirect on;
}


表:跳转端口指令
名称 跳转端口指令
指令 port_in_redirect
作用域 http, server, location
默认值 on
指令说明 Nginx 重定向时,会用当前 server 指令域的监听端口与主机拼接成完整的URL进行重定向。当指令值为 off 时,则默认用 80 端口

配置样例如下:

http {
    port_in_redirect on;
}


表:子请求输出缓冲区大小指令
名称 子请求输出缓冲区大小指令
指令 subrequest_output_buffer_size
作用域  http, server, location
默认值 4k 或 8k
指令说明 设置用于存储子请求响应报文的缓冲区大小,默认值与操作系统的内存页大小一致

配置样例如下:

http {
   subrequest_output_buffer_size 64K;
}


表:绝对跳转指令
名称 绝对跳转指令
指令 absolute_redirect
作用域 http, server, location
默认值   on
指令值选项 off 或 on
指令说明 Nginx 发起的重定向使用绝对路径做跳转,即用主机名和端口及访问路径的方式,如果关闭的话,则跳转为默认相对当前请求的主机名和端口的访问路径

配置样例如下:

http {
    absolute_redirect off;
}


表:响应刷新指令
名称  响应刷新指令
指令 msie_refresh
作用域 http, server, location
默认值 on
指令值选项 on 或 off
指令说明 Nginx 处理页面跳转或刷新的方式通常是以向客户端返回 3xx 状态码来实现。该指令是当客户端为 msie 时,在返回 HTML 头部添加“<meta http-equiv=\"Refresh\" content=\"0;\" url=*>”

配置样例如下:

http {
   msie_refresh off;
}