nginx之location匹配规则

Posted 2020-08-17

1.概述

 nginx server块下的一个指令，每个server块可以包含多个location块。

2.作用

（1）基于Nginx服务器接收到的请求字符串（例如：server_name/usr-string），对除虚拟主机名称（也可以是ip别名）之外的字符串（例如：“/usr-string”）进行匹配，对特定的匹配进行处理；

（2）地址定向、数据缓存和应答控制等功能都是在这部分实现；

（3）许多第三方模块的配置也是在location块中提供功能。

3.语法结构

Location [ = | ~ | ~* | ^~ ] uri{ … }

1)uri变量是待匹配的请求字符串，可以是不包含正则表达的字符串，也可以是包含正则的字符串。为了叙述方便，约定下文中，不含正则表达的uri称为“普通uri”，包含正则表达的uri称为“正则uri”。

2)方括号的部分是可选项，用来改变请求字符串与uri的匹配方式

= 用于标准uri前，要求请求字符串与uri严格匹配。如果已经匹配成功，就停止继续向下搜索并立即处理此请求

~ 用于表示uri包含正则表达式，并且区分大小写

~* 用于表示uri包含正则表达式，并且不区分大小写

^~ 用于普通uri前，要求nginx服务器找到标识uri和请求字符串匹配度最高的location，立即使用此location处理请求，而不再使用location块中的正则uri和请求字符串做匹配。当浏览器在传送URI时会对一部分字符进行URL编码，比如空格被编码为“%20”，问号被编码为“%3f”等。^~有一个特点就是它会对uri中的这些符号进行编码处理。比如，如果location块收到的URI为/html/%20/data,则当nginx服务器搜索到配置为“^~/html/ /data”的location时，可以匹配成功。

4.规则

“普通uri”和“普通uri”：先是严格匹配，然后是最大前缀匹配。“普通uri”的执行逻辑跟location编辑顺序无关。

“正则uri”和“正则uri”：按照正则uri在匹配文件中的物理顺序（编辑顺序）匹配的，只要匹配到一条“uri”，就不再考虑后面的。

“普通uri”和“正则uri”：选择出“普通uri”的最大前缀匹配结果后，还需要继续搜索“正则uri”；搜索到“正则uri”，那么“正则uri”覆盖“普通uri”，但也可以告诉nginx，匹配到了“普通uri”后，不需要继续匹配“正则uri”，只需要在“普通uri”前面加上“^~”符号或者是“=”；不同点是“^~”依然遵循“最大前缀”匹配规则，然后“=”不是最大匹配，而是必须严格匹配（exact match）、只要遇到“精确匹配exact match”，即使普通location没有带“=”或“^~”前缀，也一样会终止后面的匹配。

/me 和 /me/的区别

1：普通匹配时，前者是文件，后者是目录，精确匹配/me/

2：正则匹配/me/时，/me不匹配，正则匹配/me时，/me/是可以匹配出来的。

注意：（1）正则匹配可以不写root路径，不写的话就是匹配任何路径。

     （2）“正则uri”让步于“普通uri”的严格精确匹配结果；但覆盖“普通uri”的最大前缀结果。

5.配置案例

Web服务器接收到网络请求之后，首先要在服务器端指定目录中寻找请求资源。在nginx服

务器中，指令root就是用来配置这个根目录的。其语法结构为

Root   path;        //path为nginx服务器接收到请求以后查找资源的根目录路径

例：配置请求的根目录

Web服务器接收到网络请求之后，首先要在服务器端指定目录中寻找请求资源。在nginx服

务器中，指令root就是用来配置这个根目录的，其语法结构为：

Location  /zhang/

{

    Root  /wang;

}

当location块收到“/zhang/index.html”的请求后，将在/wang/zhang/目录下找index.html

响应请求。

 

例：更改location的uri

在location块中，除了使用root指令请求处理目录，还可以使用alias指令改变location接收

到的URI的请求路径，其语法结构为：

Alias path;                                       //path为修改后的根路径

Location ~ ^/zhang/(.+\.(htm|html))$

{

    Alias /yang/other/

}

当location块收到“/zhang/index.html”的请求时，匹配成功。之后根据alias指令的配置，

Nginx服务器将到/yang/other/目录下寻找index.html。可以看到，通过alias的指令，根路径

已经从/zhang到/yang/other了。

 

例：配置网站的默认首页

指令index用来设置网站的默认首页，他一般可以有两个作用：一是，用户在发出请求访问

网站时，请求地址可以不写首页名称；二是，可以对一个请求，根据其请求内容而设置不同

的首页。该指令的语法结构为：

Index file …..;

File可以包含多个文件名 ，其间使用空格分隔，也可以包含其它变量。此变量默认为

“index.html”。

例：

Location ~ ^/data/(.+)/web/ $

{

   Index index.$1.html  index.zhang.html  index.html

}

当location块接收到“/data/locationtest/web/“时，匹配成功，它首先将预置变量$1置为”

locationtest“，然后在/data/locationtest/web/路径下按照index的配置次序依次寻找index.loca

tiontest/web/路径下按照index的配置次序依次寻找index.locationtest.html页、

index.zhang.html页和index.html页，首先找到哪个页面，就使用哪个页面响应请求。

 

设置网站的错误页面

如果用户尝试查看网页时遇到问题，服务器会将HTTP错误从网站发送到web浏览器。如果

无法显示页面，web服务器会显示网站发送的实际错误网页或web浏览器内置的友好错误

信息。Nginx服务器支持自定义错误网页的显示内容。可以通过这一功能在网站发生错误时

为用户提供人性化的错误显示页面。

一般来说，HTTP2XX代表请求正常完成，HTTP3XX代表网站重定向，HTTP4XX代表客户端出

现错误，HTTP5XX代表服务器端出现错误。

Nginx服务器设置网站错误页面的指令为error_page，语法结构为：

Error_page code … [=[response]] uri

Code，要处理的HTTP错误代码

Response，可选项，将code指定的错误代码转化为新的错误代码response。

Uri，错误页面的路径或者网站地址。如果设置为路径，则是以nginx服务器安装路径下的

Html目录为根路径的相对路径；如果设置为网址，则nginx服务器会直接访问该网址获取错

误页面，并返回给用户端。

例：

Error_page  404  /404.html

设置nginx服务器使用“nginx安装路径/html/404.html”页面响应404错误。

Error_page  403  http://somewebsite.com/forbidden.html；

设置nginx服务器使用http://somewebsite.com/forbidden.html页面响应403错误。

Error_page 410 =310  /empty.gif

设置nginx服务器产生404的HTTP消息时，使用“nginx安装路径/html/empty.gif”返回给

用户端301消息（“已移动消息”）。

在前面error_page指令的分析中我们看到，变量uri实际上是一个相对于nginx服务器安装

路径的相对路径。如过不想将错误页面放到nginx服务器的安装路径下管理，可以使用另外

一个location指令定向错误页面到新的路径下面。

例：

Error_page  404  /404.html

Location  /404.html

{

   Root /myserver/errorpages/

}

首先捕获“/404.html”请求，然后将请求定向到新的路径下面即可。

公司案例

原始配置：

    location / {

        root   /usr/share/nginx/html;

        index  index.html index.htm;

}                                           //配置项目首页，指定路径

 

    error_page   500 502 503 504  /50x.html;

    location = /50x.html {

        root   /usr/share/nginx/html;

    }                                        //配置5XX错误页面，重新定向

 

    location  /media/

    {

        root         /data/static;

        expires      30d;

    }                                       //配置匹配/media/的location块

 

    location  /forum/

    {

         root        /data/static;

    }                                     //配置匹配/forum/的location块

 

    location /zhang/

    {

        proxy_pass http://127.0.0.1:8080;

        proxy_redirect off;

        proxy_set_header HOST $host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        client_max_body_size 10m;

        client_body_buffer_size 128k;

        #proxy_connect_timeout 90;

        #proxy_send_timeout 90;

        #proxy_read_timeout 90;

        #proxy_buffer_size 4k;

        #proxy_buffers 4 32k;

        #proxy_busy_buffers_size 64k;

        #proxy_temp_file_write_size 64k;

    }                                     //配置匹配/zhang/的location块，将请求直接丢给后端tomcat。

 

    location ~ .*\.(js|css)?$

    {

        expires      1h;

    }                                    //将所有js|cs文件缓存到浏览器1小时

}

问题：当在浏览器输入http://xx.xx.xx.xx/zhang/imsgTest.jsp，会出现404的错误

本文出自 “庭中有奇树” 博客，请务必保留此出处http://zhangdl.blog.51cto.com/11050780/1869524