Nginx：location与rewrite
目录
一.location与rewrite区别
1.1.基于Nginx的location与rewrite常用的正则表达式（Nginx的正则表达式）
二.location模块
2.1.location的三种匹配类别
2.2.location的常用匹配规则
2.3.location匹配优先级
2.4.location模块使用实例
三.rewrite模块
3.1.rewrite介绍
3.2.rewrite执行顺序
3.3.rewrite跳转实现
3.4.rewrite跳转场景
四.rewrite模块使用实例
4.1.基于域名的跳转
1）修改主配置文件
2）创建所需目录与文件
3）添加域名与IP地址映射关系
4）网页测试
4.2.基于客户端 IP 访问跳转
1）修改主配置文件
2）设置维护界面并重启服务并网页验证
4.3.基于旧域名跳转到新域名后面加目录
1）修改主配置文件
2）添加临时域名和IP的映射关系
3）创建准备的网页文件
4）浏览器验证
4.4.基于参数匹配的跳转
1）修改主配置文件
2）检查语法并重启
3）网页验证
4.5.基于目录下所有 php 结尾的文件跳转
1）修改主配置文件
2）检查语法并重启服务
3）网页验证
4.6.基于最普通一条 url 请求的跳转
1）修改主配置文件
2）检查配置文件并且重启服务
3）网页测试
一.location与rewrite区别
从功能看 rewrite 和 location 似乎有点像，都能实现跳转，主要区别在于 rewrite 是在同一域名内更改获取资源的路径，而 location 是对一类路径做控制访问或反向代理，还可以proxy_pass 到其他机器。
rewrite：对访问的域名或者域名内的URL路径地址重写
location：对访问的路径做访问控制或者代理转发
Nginx常见模块
http
http块是Nginx服务器配置中的重要部分，代理、缓存和日志定义等绝大多数的功能和第三方模块的配置都可以放在这模块中。作用包括：文件引入、MIME-Type定义、日志自定义、是否使用sendfile传输文件、连接超时时间、单连接请求数上限等。
server
server块，虚拟主机（虚拟服务器）。作用：使得Nginx服务器可以在同一台服务器上只要运行一组Nginx进程，就可以运行多个网站。location
location块是server块的一个指令。作用：基于Nginx服务器接收到的请求字符串，虚拟主机名称（ip，域名）、url匹配，对特定请求进行处理。
1.1.基于Nginx的location与rewrite常用的正则表达式（Nginx的正则表达式）
| 符号 | 作用 |
| ^ | 匹配输入字符串的起始位置 |
| $ | 匹配输入字符串的结束位置 |
| * | 匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll” |
| + | 匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o” |
| ? | 匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” |
| . | 匹配除“\n”之外的任何单个字符，若要匹配包括“\n”在内的任意字符，请使用诸如“[.\n]”之类的模式,表示任意一个字符 |
| \ | 将后面接着的字符标记为一个特殊字符或一个原义字符或一个向后引用。如“\n”匹配一个换行符，而“\$”则匹配“$” |
| \d | 匹配纯数字[0-9] \s ：匹配空的（空格（空白符 ）或者制表符） \w ：任意单词字符包括下划线[A-Za-z0-9_] |
| {n} | 重复 n 次 |
| {n,} | 重复 n 次或更多次 |
| {n,m} | 重复 n 到 m 次 |
| [ ] | 定义匹配的字符范围，匹配括号中的一个字符 |
| [c] |
匹配单个字符 c |
| [a-z] | 匹配 a-z 小写字母的任意一个 |
| [a-zA-Z0-9] | 匹配所有大小写字母或数字 |
| ( ) | 匹配所有大小写字母或数字，表达式的开始和结束的位置 |
| | | 或运算符 |
二.location模块
2.1.location的三种匹配类别
精准匹配：location = / {}
一般匹配：location / {}
正则匹配：location ~ / {}
在nginx.conf的配置文件中location默认使用的是通用匹配 "location /{.....}"。
2.2.location的常用匹配规则
| 规则表达式 | 规则含义 |
| = | 进行普通字符精确匹配。也就是完全匹配 |
| ^~ | 表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其他 location |
| ~ | 表示执行一个正则匹配，区分大小写 |
| ~* | 表示执行一个正则匹配，不区分大小写 |
| !~ | 表示执行一个正则匹配，区分大小写不匹配 |
| !~* | 表示执行一个正则匹配，不区分大小写不匹配 |
2.3.location匹配优先级
首先精确匹配 =
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配 ~或~*
然后匹配不带任何修饰的前缀匹配
最后是交给 / 通用匹配
location示例说明：
（1）location = / {}
=为精确匹配 / ，主机名后面不能带任何字符串，比如访问 / 和 /data，则 / 匹配，/data 不匹配
再比如 location = /abc，则只匹配/abc ，/abc/或 /abcd不匹配。若 location /abc，则即匹配/abc 、/abcd/ 同时也匹配 /abc/。
（2）location / {}
因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求 比如访问 / 和 /data, 则 / 匹配， /data 也匹配，
但若后面是正则表达式会和最长字符串优先匹配（最长匹配）
（3）location /documents/ {}
匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的正则表达式没有匹配到时，才会采用这一条
（4）location /documents/abc {}
匹配任何以 /documents/abc 开头的地址，匹配符合以后，还要继续往下搜索其它 location
只有其它 location后面的正则表达式没有匹配到时，才会采用这一条
（5）location ^~ /images/ {}
匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条
（6）location ~* \.(gif|jpg|jpeg)$ {}
匹配所有以 gif、jpg或jpeg 结尾的请求
然而，所有请求 /images/ 下的图片会被 location ^~ /images/ 处理，因为 ^~ 的优先级更高，所以到达不了这一条正则
（7）location /images/abc {}
最长字符匹配到 /images/abc，优先级最低，继续往下搜索其它 location
（8）location ~ /images/abc {}
匹配以/images/abc 开头的，优先级次之，只有去掉 location ^~ /images/ 才会采用这一条
（9）location /images/abc/1.html {}
匹配/images/abc/1.html 文件，如果和正则location ~ /images/abc/1.html 相比，正则优先级更高
优先级总结
(location = 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)
location 匹配
首先看 优先级：精确= > 前缀^~ > 正则~,~* > 一般 > 通用/
优先级相同：正则看上下顺序，上面的优先；一般匹配看长度，最长匹配的优先
精确、前缀、正则、一般 都没有匹配到，最后再看通用匹配
2.4.location模块使用实例
1）精确匹配优先级小于一般匹配的特殊情况
location = / { } 和 location / { } ，按道理应匹配前者，但实际确实匹配后者，匹配只写域名精确匹配不生效
1. #在配置文件添加匹规则
vim /apps/nginx/conf/nginx.conf
#默认网页
location / {
root html;
index index.html index.htm; }
#添加的网页
location = / {
root /web/test/;
}
2. #新建网页站点目录
mkdir -p /web/test
3. #在站点目录下新建index.html
vim /web/test/index.html
This is a test!
4. #检查语法并重启
nginx -t
systemctl restart nginx.service
5. #在网页中测试
192.168.47.105
2）解决方法
在 /根后 加上index.html 后生效
1. #修改配置文件
vim /apps/nginx/conf/nginx.conf
location = /index.html { # 加上index.html
root /web/dog/;
}
2. #检查语法、重启服务
nginx -t
systemctl restart nginx.service
3. #网页测试
192.168.47.105
3）实际网站使用中的三个匹配规则
①第一个必选规则
直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，比如说官网。
这里是直接转发给后端应用服务器了，也可以是一个静态首页
location = / {
proxy_pass http://tomcat_server/;
}
②第二个必选规则是处理静态文件请求
这是nginx作为http服务器的强项！
有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
root /webroot/res/;
}
③第三个通用规则
比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器
非静态文件请求就默认是动态请求
location / {
proxy_pass http://tomcat_server;
}
三.rewrite模块
3.1.rewrite介绍
rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。
比如：更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。
rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用。
例如：http://www.kgc.com/abc/bbs/index.php?a=1&b=2 只对/abc/bbs/index.php重写。
现在 Nginx 已经成为很多公司作为前端反向代理服务器的首选，在实际工作中往往会 遇到很多跳转（重写 URL）的需求。比如更换域名后需要保持旧的域名能跳转到新的域名 上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。如果在后端使用的 Apache 服务器，虽然也能做跳转，规则库也很强大，但是用 Nginx 跳转效率会更高，这也是学习 本章的目的所在。
3.2.rewrite执行顺序
(1) 执行server块里面的rewrite指令。
(2) 执行location匹配。
(3) 执行选定的location中的rewrite 指令。
3.3.rewrite跳转实现
Nginx：通过ngx_http_rewrite_module 模块支持URL重写、支持if条件判断，但不支持else
跳转：从一个 location跳转到另一个location，循环最多可以执行10次，超过后nginx将返回500错误
PCRE支持：perl兼容正则表达式的语法规则匹配
重写模块 set 指令：创建新的变量并设其值
1.使用rewrite进行匹配跳转
2. 使用if匹配全局变量后跳转
3. 使用location匹配在跳转
rewrite放在server{ }、if{ }、location{}段中
location只对域名后边的除去传递参数外的字符串起作用
3.4.rewrite跳转场景
可以调整用户浏览的 URL，看起来更规范，合乎开发及产品人员的需求
为了让搜索引擎搜录网站内容及用户体验更好，企业会将动态 URL 地址伪装成静态地址提供服务。
网址换新域名后，让旧的访问跳转到新的域名上。例如，访问京东的 360buy.com会跳转到 jd.com
根据特殊变量、目录、客户端的信息进行 URL 调整等。
rewrite
[flag];
regex ：表示正则匹配规则。
replacement ：表示跳转后的内容。
flag ：表示 rewrite 支持的 flag 标记。
flag标记说明
last ：本条规则匹配完成后，不终止重写后的url匹配，一般用在 server 和 if 中。
break ：本条规则匹配完成即终止，终止重写后的url匹配，一般使用在 location 中。
redirect ：返回302临时重定向，浏览器地址会显示跳转后的URL地址。
permanent ：返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。
四.rewrite模块使用实例
4.1.基于域名的跳转
现在公司旧域名www.liu.com有业务需求变更，需要使用新域名www.xing.com代替，但是旧域名不能废除，需要跳转到新域名上，而且后面的参数保持不变。
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
server {
listen 80;
server_name www.liu.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.liu.com-access.log; #日志修改
location / { #添加域名重定向
if ($host = 'www.liu.com'){ #$host为rewrite全局变量，代表请求主机头字段或主机名
rewrite ^/(.*)$ http://www.xing.com/$1 permanent; #$1为正则匹配的内容，即域名后边的字符串
}
root html;
index index.html index.htm;
}
}
2）创建所需目录与文件
#创建日志文件夹，检查语法
mkdir -p /var/log/nginx
nginx -t
#创建网页test目录与文件1.html
mkdir -p /apps/nginx/html/test
vim /apps/nginx/html/test/1.html
------------------------------------------
Here is the content of test
-------------------------------------------
#上传1.jpg图片文件
cd /apps/nginx/html/test
rz -E
3）添加域名与IP地址映射关系
#添加映射关系
echo "192.168.47.105 www.liu.com www.xing.com" >> /etc/hosts
#重启服务
systemctl restart nginx 
4）网页测试
#打开浏览器输入
www.liu.com/test/1.html
会发现重定向到www.xing.com/test/1.html
4.2.基于客户端 IP 访问跳转
公司业务新版本上线，要求所有 IP 访问任何内容都显示一个固定维护页面，只有公司 IP ：192.168.47.104访问正常。
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
server {
listen 80;
server_name www.zr.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.zr.com-access.log; #日志修改
#设置是否合法的IP标记
set $rewrite true; #设置变量$rewrite，变量值为boole值true
#判断是否为合法IP
if ($remote_addr = "192.168.47.104"){ #当客户端IP为192.168.47.104时，将变量值设为false，不进行重写
set $rewrite false;
}
#除了合法IP，其它都是非法IP，进行重写跳转维护页面
if ($rewrite = true){ #当变量值为true时，进行重写
rewrite (.+) /weihu.html; #将域名后边的路径重写成/weihu.html后转发，例如www.kgc.com/weihu.html
}
location = /weihu.html {
root /var/www/html; #网页返回/var/www/html/weihu.html的内容
}
location / {
root html;
index index.html index.htm;
}
}
2）设置维护界面并重启服务并网页验证
mkdir -p /var/www/html/
cd /var/www/html
vim weihu.html
this is weihu chuansong web!
echo "192.168.47.104 www.zr.com" >>/etc/hosts
systemctl restart nginx
4.3.基于旧域名跳转到新域名后面加目录
现在访问的是 http://mail.zr.com/post，现在需要将这个域名下面的访问都跳转到http://www.zr.com/
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
-------------------------------------
server {
listen 80;
server_name bbs.zr.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.zr.com-access.log;
#添加
location /post {
rewrite (.+) http://www.zr.com/mail$1 permanent; #这里的$1为位置变量，代表/post
}
location / {
root html;
index index.html index.htm;
}
2）添加临时域名和IP的映射关系
vim /etc/hosts
192.168.47.105 www.zr.com mail.zr.com
3）创建准备的网页文件
mkdir -p /apps/nginx/html/mail/post
vim /apps/nginx/html/mail/post/1.html
-------------------------------------------
hello
---------------------------------------------
nginx -t
systemctl restart nginx
4）浏览器验证
输入mail.zr.com/post/1.html
显示为www.zr.com/mail/post/1.html
4.4.基于参数匹配的跳转
访问http://www.zr.com/100-(100|200)-100.html 跳转到http://www.jiu.com页面。
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
--------------------------------------
server {
listen 80;
server_name www.zr.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.zr.com-access.log;
if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
rewrite (.*) http://www.zr.com permanent;
}
location / {
root html;
index index.html index.htm;
}
}
2）检查语法并重启
nginx -t
systemctl restart nginx
3）网页验证
#在浏览器输入
www.zr.com/100-200-100.html
#在浏览器输入错误范围
www.zr.com/100-500-100.html
4.5.基于目录下所有 php 结尾的文件跳转
要求访问 http://www.zr.com/upload/123.php 跳转到首页。
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
------------------------------------
server {
listen 80;
server_name www.zr.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.zr.com-access.log;
location ~* /upload/.*\.php$ {
rewrite (.+) http://www.zr.com permanent;
}
location / {
root html;
index index.html index.htm;
}
}
2）检查语法并重启服务
nginx -t
systemctl restart nginx
3）网页验证
#在浏览器输入
www.zr.com/upload/123.php
4.6.基于最普通一条 url 请求的跳转
要求访问一个具体的页面如 http://www.zr.com/abc/123.html 跳转到首页
1）修改主配置文件
vim /apps/nginx/conf/nginx.conf
----------------------------------------
server {
listen 80;
server_name www.zr.com; #域名修改
charset utf-8;
access_log /var/log/nginx/www.zr.com-access.log main;
location ~* ^/abc/123.html {
rewrite (.+) http://www.zr.com permanent;
}
location / {
root html;
index index.html index.htm;
}
}
2）检查配置文件并且重启服务
nginx -t
systemctl restart nginx
3）网页测试
#在浏览器输入
www.zr.com/abc/123.html