Nginx Location配置和ReWrite 语法

梦里梦外; 2023-10-17 09:29 117阅读 0赞

## 1 Location语法规则 ##

### 1.1 Location规则 ###

语法规则： location \[=|~|~\*|^~\] /uri/ \{… \}

首先匹配 =，其次匹配^~,其次是按文件中顺序的正则匹配，最后是交给 /通用匹配。当有匹配成功时候，停止匹配，按当前匹配规则处理请求。

<table style="color:rgb(0,0,0)"> 
 <tbody> 
 <tr> 
 <td style="background:rgb(191,191,191)"> 符号 </td> 
 <td style="background:rgb(191,191,191)"> 含义 </td> 
 </tr> 
 <tr> 
 <td> = </td> 
 <td> =&nbsp;开头表示精确匹配 </td> 
 </tr> 
 <tr> 
 <td> ^~ </td> 
 <td> ^~开头表示uri以某个常规字符串开头，理解为匹配&nbsp;url路径即可。nginx不对url做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格） </td> 
 </tr> 
 <tr> 
 <td> ~ </td> 
 <td> ~&nbsp;开头表示区分大小写的正则匹配 </td> 
 </tr> 
 <tr> 
 <td> ~* </td> 
 <td> ~*&nbsp;开头表示不区分大小写的正则匹配 </td> 
 </tr> 
 <tr> 
 <td> !~和!~* </td> 
 <td> !~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则 </td> 
 </tr> 
 <tr> 
 <td> / </td> 
 <td> 用户所使用的代理（一般为浏览器） </td> 
 </tr> 
 <tr> 
 <td> $http_x_forwarded_for </td> 
 <td> 可以记录客户端IP，通过代理服务器来记录客户端的ip地址 </td> 
 </tr> 
 <tr> 
 <td> $http_referer </td> 
 <td> 可以记录用户是从哪个链接访问过来的 </td> 
 </tr> 
 </tbody> 
</table>

匹配规则示例：

**\[plain\]** [view plain][] [copy][view plain]

1.  location = / \{ 
2.   \#规则A 
3.  \} 
4.  location = /login \{ 
5.   \#规则B 
6.  \} 
7.  location ^~ /static/ \{ 
8.   \#规则C 
9.  \} 
10. location ~ \\.(gif|jpg|png|js|css)$ \{ 
11.  \#规则D 
12. \} 
13. location ~\* \\.png$ \{ 
14.  \#规则E 
15. \} 
16. location !~ \\.xhtml$ \{ 
17.  \#规则F 
18. \} 
19. location !~\* \\.xhtml$ \{ 
20.  \#规则G 
21. \} 
22. location / \{ 
23.  \#规则H 
24. \}

那么产生的效果如下：

1. 访问根目录/，比如http://localhost/将匹配规则A

2. 访问 http://localhost/login 将匹配规则B，http://localhost/register则匹配规则H

3. 访问 http://localhost/static/a.html 将匹配规则C

4. 访问 http://localhost/a.gif,http://localhost/b.jpg 将匹配规则D和规则E，但是规则D顺序优先，规则E不起作用，而http://localhost/static/c.png则优先匹配到规则C

5. 访问 http://localhost/a.PNG 则匹配规则E，而不会匹配规则D，因为规则E不区分大小写。

6. 访问 http://localhost/a.xhtml 不会匹配规则F和规则G，http://localhost/a.XHTML不会匹配规则G，因为不区分大小写。规则F，规则G属于排除法，符合匹配规则但是不会匹配到，所以想想看实际应用中哪里会用到。

7. 访问 http://localhost/category/id/1111 则最终匹配到规则H，因为以上规则都不匹配，这个时候应该是nginx转发请求给后端应用服务器，比如FastCGI（php），tomcat（jsp），nginx作为方向代理服务器存在。

### 1.2 实际常用规则 ###

\#直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理。

\#这里是直接转发给后端应用服务器了，也可以是一个静态首页

\# 第一个必选规则

**\[plain\]** [view plain][] [copy][view plain]

1.  location = / \{ 
2.   proxy\_passhttp://tomcat:8080/index 
3.  \}

\# 第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项

\# 有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用

**\[plain\]** [view plain][] [copy][view plain]

1.   location ^~ /static/ \{ 
2.   \# 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt 
3.   root /webroot/res/; 
4.   \} 
5.  
6.   location ~\* \\.(gif|jpg|jpeg|png|css|js|ico)$\{ 
7.   root /webroot/res/; 
8.   \}

\#第三个规则就是通用规则，用来转发动态请求到后端应用服务器

\#非静态文件请求就默认是动态请求，自己根据实际把握

\#毕竟目前的一些框架的流行，带.php,.jsp后缀的情况很少了

**\[plain\]** [view plain][] [copy][view plain]

1.  location / \{ 
2.   proxy\_pass http://tomcat:8080/ 
3.  \}

### 1.3 Location解析过程 ###

![Center][]

总结：

1、 先判断精准命中，如果命中，立即返回结果并结束解析过程。

2、 判断普通命中，如果有多个命中，“记录”下来“最长”的命中结果（记录但不结束，最长的为准）。

3、 继续判断正则表达式的解析结果，按配置里的正则表达式顺序为准，由上至下开始匹配，一旦匹配成功1个，立即返回结果，并结束解析过程。

4、 普通命中顺序无所谓，是因为按命中的长短来确定。正则命中，顺序有所谓，因为是从前入往后命中的。

## 2 ReWrite语法 ##

Nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。rewrite只能放在server\{\},location\{\},if\{\}中，并且只能对域名后边的除去传递的参数外的字符串起作用。

Rewrite主要的功能就是实现URL的重写，Nginx的Rewrite规则采用Pcre，perl兼容正则表达式的语法规则匹配，如果需要Nginx的Rewrite功能，在编译Nginx之前，需要编译安装PCRE库。

通过Rewrite规则，可以实现规范的URL、根据变量来做URL转向及选择配置。

### 2.1 ReWrite相关指令 ###

<table style="color:rgb(0,0,0)"> 
 <tbody> 
 <tr> 
 <td style="background:rgb(191,191,191)"> 指令 </td> 
 <td style="background:rgb(191,191,191)"> 默认值 </td> 
 <td style="background:rgb(191,191,191)"> 使用范围 </td> 
 <td style="background:rgb(191,191,191)"> 作用 </td> 
 </tr> 
 <tr> 
 <td> break </td> 
 <td> none </td> 
 <td> if，server，location </td> 
 <td> 完成当前的规则集，不再处理rewrite指令，需要和last加以区分 </td> 
 </tr> 
 <tr> 
 <td> if ( condition ) { ... } </td> 
 <td> none </td> 
 <td> server，location </td> 
 <td> 用于检测一个条件是否符合，符合则执行大括号内的语句。不支持嵌套，不支持多个条件&amp;&amp;或||处理 </td> 
 </tr> 
 <tr> 
 <td> return </td> 
 <td> none </td> 
 <td> server，if，location </td> 
 <td> 用于结束规则的执行和返回状态码给客户端。状态码的值可以是：204,400,402~406,408,410,411,413,416以及500~504，另外非标准状态码444，表示以不发送任何的Header头来结束连接。 </td> 
 </tr> 
 <tr> 
 <td> rewrite regex replacement flag </td> 
 <td> &nbsp; </td> 
 <td> server,location,if </td> 
 <td> 该指令根据表达式来重定向URI，或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。 </td> 
 </tr> 
 <tr> 
 <td> uninitialized_variable_warn on|off </td> 
 <td> on </td> 
 <td> http,server,location,if </td> 
 <td> 该指令用于开启和关闭未初始化变量的警告信息，默认值为开启。 </td> 
 </tr> 
 <tr> 
 <td> set&nbsp; variable&nbsp; value </td> 
 <td> none </td> 
 <td> &nbsp; </td> 
 <td> 该指令用于定义一个变量，并且给变量进行赋值。变量的值可以是文本、一个变量或者变量和文本的联合，文本需要用引号引起来。 </td> 
 </tr> 
 </tbody> 
</table>

### 2.2 Rewrite全局变量 ###

rewrite全局变量表

<table style="color:rgb(0,0,0)"> 
 <tbody> 
 <tr> 
 <td style="background:rgb(191,191,191)"> 变量 </td> 
 <td style="background:rgb(191,191,191)"> 含义 </td> 
 </tr> 
 <tr> 
 <td> $args </td> 
 <td> 这个变量等于请求行中的参数，同$query_string </td> 
 </tr> 
 <tr> 
 <td> $content length </td> 
 <td> 请求头中的Content-length字段。 </td> 
 </tr> 
 <tr> 
 <td> $content_type </td> 
 <td> 请求头中的Content-Type字段。 </td> 
 </tr> 
 <tr> 
 <td> $document_root </td> 
 <td> 当前请求在root指令中指定的值。 </td> 
 </tr> 
 <tr> 
 <td> $host </td> 
 <td> 请求主机头字段，否则为服务器名称。 </td> 
 </tr> 
 <tr> 
 <td> $http_user_agent </td> 
 <td> 客户端agent信息 </td> 
 </tr> 
 <tr> 
 <td> $http_cookie </td> 
 <td> 客户端cookie信息 </td> 
 </tr> 
 <tr> 
 <td> $limit_rate </td> 
 <td> 这个变量可以限制连接速率。 </td> 
 </tr> 
 <tr> 
 <td> $request_method </td> 
 <td> 客户端请求的动作，通常为GET或POST。 </td> 
 </tr> 
 <tr> 
 <td> $remote_addr </td> 
 <td> 客户端的IP地址。 </td> 
 </tr> 
 <tr> 
 <td> $remote_port </td> 
 <td> 客户端的端口。 </td> 
 </tr> 
 <tr> 
 <td> $remote_user </td> 
 <td> 已经经过Auth Basic Module验证的用户名。 </td> 
 </tr> 
 <tr> 
 <td> $request_filename </td> 
 <td> 当前请求的文件路径，由root或alias指令与URI请求生成。 </td> 
 </tr> 
 <tr> 
 <td> $scheme </td> 
 <td> HTTP方法（如http，https）。 </td> 
 </tr> 
 <tr> 
 <td> $server_protocol </td> 
 <td> 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。 </td> 
 </tr> 
 <tr> 
 <td> $server_addr </td> 
 <td> 服务器地址，在完成一次系统调用后可以确定这个值。 </td> 
 </tr> 
 <tr> 
 <td> $server_name </td> 
 <td> 服务器名称。 </td> 
 </tr> 
 <tr> 
 <td> $server_port </td> 
 <td> 请求到达服务器的端口号。 </td> 
 </tr> 
 <tr> 
 <td> $request_uri </td> 
 <td> 包含请求参数的原始URI，不包含主机名，如”/foo/bar.php?arg=baz”。 </td> 
 </tr> 
 <tr> 
 <td> $uri </td> 
 <td> 不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。 </td> 
 </tr> 
 <tr> 
 <td> $document_uri </td> 
 <td> 与$uri相同。 </td> 
 </tr> 
 </tbody> 
</table>

### 2.3 Rewrite语法规则 ###

<table style="color:rgb(0,0,0)"> 
 <tbody> 
 <tr> 
 <td style="background:rgb(191,191,191)"> 操作符 </td> 
 <td style="background:rgb(191,191,191)"> 含义 </td> 
 </tr> 
 <tr> 
 <td> = ,!= </td> 
 <td> 比较的一个变量和字符串。 </td> 
 </tr> 
 <tr> 
 <td> ~，&nbsp;~* </td> 
 <td> 与正则表达式匹配的变量，如果这个正则表达式中包含}，;则整个表达式需要用"或'包围。 </td> 
 </tr> 
 <tr> 
 <td> -f，!-f </td> 
 <td> 检查一个文件是否存在。 </td> 
 </tr> 
 <tr> 
 <td> -d, !-d </td> 
 <td> 检查一个目录是否存在。 </td> 
 </tr> 
 <tr> 
 <td> -e，!-e </td> 
 <td> 检查一个文件、目录、符号链接是否存在。 </td> 
 </tr> 
 <tr> 
 <td> -x，&nbsp;!-x </td> 
 <td> 检查一个文件是否可执行。 </td> 
 </tr> 
 </tbody> 
</table>

### 2.4 if指令 ###

**\[plain\]** [view plain][] [copy][view plain]

1.   if 语法格式 
2.   if 空格 (条件) \{ 
3.   重写模式 
4.   \} 
5.  
6.   \# 限制浏览器访问 
7.   if ($http\_user\_agent ~ Firefox) \{ 
8.   rewrite ^(.\*)$ /firefox/$1 break; 
9.   \} 
10. 
11.  if ($http\_user\_agent ~ MSIE) \{ 
12.  rewrite ^(.\*)$ /msie/$1 break; 
13.  \} 
14. 
15.  if ($http\_user\_agent ~ Chrome) \{ 
16.  rewrite ^(.\*)$ /chrome/$1 break; 
17.  \}

### 2.5 return指令 ###

**\[plain\]** [view plain][] [copy][view plain]

1.  \# 限制IP访问 
2.  if ($remote\_addr = 192.168.197.142) \{ 
3.   return 403; 
4.  \}

### 2.6 rewrite指令 ###

\#判断目录是否存在

\#服务器内部的rewrite和302跳转不一样.跳转的话URL都变了,变成重新http请求index.html,而内部rewrite,上下文没变。

**\[plain\]** [view plain][] [copy][view plain]

1.  if (!-e $document\_root$fastcgi\_script\_name) \{ 
2.   rewrite ^.\*$ /index.html break; 
3.  \}

### 2.7 set指令 ###

\# set指令是设置变量用的,可以用来达到多条件判断时作标志用

\#判断IE并重写,且不用break;我们用set变量来达到目的

**\[plain\]** [view plain][] [copy][view plain]

1.   if ($http\_user\_agent ~\* msie) \{ 
2.   set $isie 1; 
3.   \} 
4.  
5.   if ($fastcgi\_script\_name = ie.html) \{ 
6.   set $isie 0; 
7.   \} 
8.  
9.   if ($isie 1) \{ 
10.  rewrite ^.\*$ ie.html; 
11.  \}

[view plain]: http://blog.csdn.net/yuan_xw/article/details/51333451#
[Center]: https://img-blog.csdn.net/20160506174803273?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center