Nginx中location规则 与 URL重写（rewrite）详解

最新推荐文章于 2024-05-14 11:33:22 发布
最新推荐文章于 2024-05-14 11:33:22 发布
阅读量952 收藏 3
点赞数
文章标签： nginx 运维 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zl965230/article/details/130340967
版权

1.Nginx中location与rewrite
1.1 location与rewrite常用的正则表达式
符号    作用
^    匹配输入字符串的起始位置
$     匹配输入字符串的结束位置
*    匹配前面的字符零次或多次。如“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]    匹配所有大小写字母或数字
()    表达式的开始和结束位置
|    或预算
1.2  location与rewrite的联系和区别 
rewrite ：对访问的域名或者域名内的URL路径地址重写
location：对访问的路径做访问控制或者代理转发

从功能看 rewrite 和 location 似乎有点像，都能实现跳转，主要区别在于 rewrite 是在同一域名内更改获取资源的路径，而 location 是对一类路径做控制访问或反向代理，还可以proxy_pass 到其他机器

2.location的匹配规则 
 2.1 location的匹配分类与常用规则
location 大致可以分为三类：精准匹配" location = / {...} "   ，一般匹配" location / {...} "和正则匹配" location ~ / {...} "。在nginx.conf的配置文件中location默认使用的是通用匹配 "location /{.....}"

location的匹配规则    规则作用
=     进行普通字符精确匹配，也就是完全匹配
^~    表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其它正则匹配的location。
~     区分大小写的正则匹配。
~*    不区分大小写的正则匹配。
!~     区分大小写的正则匹配取非。
!~*     不区分大小写的正则匹配取非。
2.2 location 示例说明与规则优先实验
示例一：精准匹配 
location = / {
root /var/www/html
 }
 =为精确匹配 / ，主机名后面不能带任何字符串，例如想访问该location制定的匹配网页时，只能访问该主机IP或域名下的"/"（网页也只能存放在/var/www/html/ 下）,而像"/abc,/data，/test"这一类和location等于号后面路径有任何一点差别的，都不会被匹配到。该匹配方式优先级最高，一旦匹配成功则立即采用
 

示例二：通用匹配 
 
location / {
root /var/www/html
}
 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求.用户只要是能访问到该主机的IP或域名，即使不输入路径，也能匹配到相关的网页信息。(文件只要是存放在/var/www/html 中，或则更深的目录也能被匹配到。例如：/var/www/html/test/ 下存放网页，用户访问/test 也能够匹配访问到相关网页)该匹配方式为location匹配中优先级最低的方式，只有其他location匹配方式均为成功，才会采用该方式
 

示例三：一般匹配 
 
#匹配规则a：
location /documents/ {
root  /var/www/html
index index.html
}
 
#匹配规则b：
location /documents/abc {
root  /aaa/bbb/ccc
index index.html
}


 

网页准备

 访问结果

结论：一般匹配时，location后面跟着的路径长度越长 ，则匹配的优先级越高

示例四： 正则匹配与前缀^~匹配
在 /var/www/html/images   下存放了一张 jpg格式的图片

#前缀^~匹配
location ^~ /images/ {
root /var/www/html
 
}
 
#正则匹配
location ~* \.(gif|jpg|jpeg)$ {
 /var/www/html
}
location ^~ /images/ {}匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条 

匹配所有以 gif、jpg或jpeg 结尾的请求。然而，所有请求 /images/ 下的图片会被 location ^~ /images/ 处理，因为 ^~ 的优先级更高，所以到达不了这一条正则 

总结：^~ 前缀匹配是一种针对正则匹配的特殊的一般匹配方式 。前缀^~匹配在上面时：当访问的与前缀^~匹配相关时，就会停止正则匹配，采用该前缀匹配。正则匹配在上面时：当正则匹配匹配到请求时，还会继续查看其他的正则匹配。当遇到前缀^~匹配则会采用前缀匹配，而放弃该正则匹配。此外同是正则匹配的规则，看上下顺序决定优先级顺序

示例五：正则匹配与一般匹配 
正则匹配
location ~ /images/abc {
root /var/www/html
}
 
#location后面路径更长的一般匹配
location /images/abc/1.html {
root /aaa/bbb/ccc
 匹配/images/abc/1.html 文件，location /images/abc/1.html 和正则location  ~ /images/abc 相比，正则优先级更高。匹配的网页是正则中的网页

示例六：前缀^~匹配与一般匹配 
 
location ^~ /images/abc {
root /var/www/html
 
}
 
location /images/abc/1.html {
root /aaa/bbb/ccc
 因为前缀^~匹配时一般匹配的一种特殊存在，但是与一般匹配比较时，依旧遵循一般匹配的路径长度决定优先级的原则。 匹配/images/abc/1.html 文件，访问页面是下面的长路径一般匹配规则中设置的网页

2.3 location匹配规则顺序总结 
在所有条件相同的条件下（location后面路径长度相同）优先级比较：  (location = 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)

location匹配规则优先通用的总结 ：

  (1) 存在精准匹配时，直接采用

（2）在没有精准匹配的情况下，先看前缀匹配的长度，然后根据最长的前缀匹配的优先级去确定是否再去看其它正则匹配location。
 

（3）如果最长的前缀匹配带有 ^~ 则不再看其它正则匹配location，如果最长的前缀匹配是没有修饰符的一般匹配则会再看其它正则匹配location

（4）   前缀匹配看长度，最长的优先匹配
正则匹配看上下顺序，由上往下依次匹配，当有匹配成功时候，停止匹配，按当前匹配规则处理请求

（5）只有在精准、前缀、正则、一般 都没有匹配到的时候才会看通用匹配

2.4 location的运用拓展 
 实际网站使用中，至少有三个匹配规则定义：

 #第一个必选规则
直接匹配网站根目录首页，通过域名访问网站首页比较频繁，使用这个会加速处理，比如说官网。
可以是一个静态首页，也可以直接转发给后端应用服务器

 
location = /index.html {
    root   html;
    index  index.html index.htm;
}
 #第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项
有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用

 
location ^~ /static/ {
    root /webroot/;
}
 
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/res/;
}
#第三个规则就是通用规则，比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器
非静态文件请求就默认是动态请求 

location / {
    proxy_pass http://tomcat_server;
}
3.rewrite 重写 
3.1 rewrite 的功能介绍 

rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。
比如：更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。

rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用，
例如 http://www.yang.com/abc/bbs/index.php?a=1&b=2 只对/abc/bbs/index.php重写。

 3.2  rewrite的跳转实现与执行顺序
rewrite跳转实现：
Nginx：通过ngx_http_rewrite_module 模块支持URL重写、支持if条件判断，但不支持else
跳转：从一个 location跳转到另一个location，循环最多可以执行10次，超过后nginx将返回500错误
PCRE支持：perl兼容正则表达式的语法规则匹配
重写模块 set 指令：创建新的变量并设其值

rewrite 执行顺序如下：
(1) 执行 server 块里面的 rewrite 指令。
(2) 执行 location 匹配。
(3) 执行选定的 location 中的 rewrite 指令。

3.3 rewrite在nginx.conf 中的语法格式
语法格式：rewrite <regex> <replacement> [flag];

regex ：表示正则匹配规则。
replacement ：表示跳转后的内容。
flag ：表示 rewrite 支持的 flag 标记。

 ###flag标记说明###
last ：本条规则匹配完成后，不终止重写后的url匹配，一般用在 server 和 if 中。
break ：本条规则匹配完成即终止，终止重写后的url匹配，一般使用在 location 中。
redirect ：返回302临时重定向，浏览器地址会显示跳转后的URL地址。
permanent ：返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。

3.4 rewrite运用示例 
示例一：基于域名的跳转 
需求：某公司旧域名www.yang.com有业务需求变更，需要使用新域名www.wang.com代替，但是旧域名不能废除，需要跳转到新域名上，而且后面的参数保持不变。

配置设置：

 
vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.kgc.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;        #日志修改
    location / {
    #添加域名重定向
        if ($host = 'www.yang.com'){                        #$host为rewrite全局变量，代表请求主机头字段或主机名
            rewrite ^/(.*)$ http://www.wang.com/$1 permanent;    #$1为正则匹配的内容，即“域名/”之后的字符串
        }
        root   html;
        index  index.html index.htm;
    }
}

其他操作步骤： 

echo "192.168.73.105  www.yang.com www.wang.com" >> /etc/hosts
systemctl restart nginx
浏览器输入模拟访问 http://www.yang.com/test/1.html(虽然这个请求内容是不存在的)
 

实验结果：

会跳转到www.wang.com/test/1.html，查看元素可以看到返回301，实现了永久重定向跳转，而且域名后的参数也正常跳转。

示例二：基于客户端 IP 访问跳转
需求：某公司业务新版本上线，要求所有 IP 访问任何内容都显示一个固定维护页面，只有公司 IP ：192.168.73.105（指定的IP）访问正常。

配置设置 ：

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.kgc.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;        #日志修改
 
    #设置是否合法的IP标记
    set $rewrite true;                            #设置变量$rewrite，变量值为boole值true
    #判断是否为合法IP
    if ($remote_addr = "192.168.73.105"){        #当客户端IP为192.168.73.105时，将变量值设为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;
    }
}

其他操作步骤：


mkdir -p /var/www/html/  #创建维护网页目录
echo "<h1>We are maintaining now!</h1>" > /var/www/html/weihu.html  #添加维护网页内容 
systemctl restart nginx    #重启nginx服务
 

访问测试结果：

 只有 IP 为 192.168.73.105 能正常访问，其它地址都是维护页面

注意：如果rewrite (.+) /weihu.html; 换成rewrite (.+) /weihu.html permanent; 的话，若不是 192.168.73.105 的主机访问会使浏览器修改请求访问的 URL 成 http://www.yang.com/weihu.html 再请求访问，这样就会进入一直在 rewrite 的死循环，访问请求会一直被重写成 http://www.yang.com/weihu.html 再请求访问 
 

 示例三：基于旧域名跳转到新域名后面加目录
需求：现在访问的是 http://yang.wang.com/post/，现在需要将这个域名下面的访问都跳转到http://www.yang.com/bbs/post/ 

 
vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  yang.wang.com www.yang.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;
    #添加
    location /post {
        rewrite (.+) http://www.yang.com/bbs$1 permanent;        #这里的$1为位置变量，代表/post
    }
    
    location / {
        root   html;
        index  index.html index.htm;
    }
}

其它设置

mkdir -p /usr/local/nginx/html/bbs/post
echo "this is 1.html"  >> /usr/local/nginx/html/bbs/post/1.html
echo "192.168.73.105 yang.wang.com"  >> /etc/hosts
systemctl restart nginx
 

访问结果：

使用浏览器访问 http://yang.wang.com/post/1.html 跳转到http://www.yang.com/bbs/post/1.html 

示例四：基于参数匹配的跳转
 需求：现在访问http://www.yang.com/100-(100|200)-100.html 跳转到http://www.yang.com页面

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.yang.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;
    
    if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
        rewrite (.+) http://www.yang.com permanent;
    }
 
    location / {
        root   html;
        index  index.html index.htm;
    }
}

变量说明：
$request_uri：包含请求参数的原始URI，不包含主机名，如：http://www.yang.com/abc/bbs/index.html?a=1&b=2 中的 /abc/bbs/index.php?a=1&b=2
$uri：这个变量指当前的请求URI，不包括任何参数，如:/abc/bbs/index.html
$document_uri：与$uri相同，这个变量指当前的请求URI，不包括任何传递参数，如:/abc/bbs/index.html

 重启nginx服务，访问结果：

使用浏览器访问 http://www.yang.com/100-200-100.html 或 http://www.kgc.com/100-100-100.html 跳转到http://www.yang.com页面。

示例五：基于目录下所有 php 结尾的文件跳转 
需求：要求访问 http://www.yang.com/upload/123.php 跳转到首页。

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.yang.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;
    
    location ~* /upload/.*\.php$ {
        rewrite (.+) http://www.yang.com permanent;
    }
 
    location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx

访问结果：

浏览器访问 http://www.yang.com/upload/123.php 跳转到http://www.yang.com页面。

示例六：基于最普通一条 url 请求的跳转 
 需求：要求访问一个具体的页面如 http://www.yang.com/abc/123.html 跳转到首页

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.yang.com;        #域名修改    
    charset utf-8;
    access_log  /var/log/nginx/www.yang.com-access.log;
    
    location ~* ^/abc/123.html {
        rewrite (.+) http://www.yang.com permanent;
    }
 
    location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx

访问结果：

浏览器访问 http://www.yang.com/abc/123.html 跳转到http://www.yang.com页面。

zl965230
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
详解nginx配置location总结及rewrite规则写法
09-30
本篇文章主要介绍了详解nginx配置location总结及rewrite规则写法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
Nginx服务器如何设置url链接
01-09
对于LNMP这样架构的网站来说，一般都是基于php框架开发，php框架一般都会讲究优雅链接，比如Laravel，CodeIgniter，ThinkPHP等都是支持这种链接模式的，在服务器配置上也叫作url重写，目前框架大都采用单一入口的index.php然后基于MVC模式的话一般是/index.php/Model/function这种请求方式，所以如果能去掉index.php入口文件整个url就显得简洁美观，和Python、Java等开发的网站url模式统一，Apache和nginx都支持这种url的模式，下面说一下nginx配置的方式 　　首先进入nginx的安装目录，上篇文章中说了在配置文
nginx配置改变默认访问路径
热门推荐
喝完牛奶好睡觉的博客
03-11 2万+
在安装完nginx服务后，url访问的默认路径是安装的路径html文件夹下的内容，如果需要指定自定义的路径，需要配置nginx.conf文件内容，这样通过url访问就可以了，比如： http://127.0.0.1/ 对应的物理路径 c:/a/b/c 修改配置文件： server { listen 80; server_name localhost; #charset koi8-r
服务器nginx反向代理修改url路径
qq_55269092的博客
05-24 6431
服务器nginx反向代理修改url路径
通过nginx 修改访问URL的路径
qq_33201718的博客
03-13 5246
今天遇到这样一个需求 访问nginx 的 URL http://8.8.8.8/a/b/c 通过代理后URL 变为 http://9.9.9.9/b/c 解决办法 nginx 的配置如下 location /a { proxy_pass http://9.9.9.9; rewrite “^/a/(.*)$” /KaTeX parse error: Expected 'EOF', got '#'...
nginx反向代理替换URL
weixin_47139540的博客
05-07 8436
系列文章目录 nginx反向代理替换URL 文章目录系列文章目录前言一、location作用二、直接替换location 匹配部分 前言 nginx 提供反向代理服务，日常开发过程中有时候我们需要使用nginx 作为代理服务根据url的不同去访问不同的服务器或者不同端口，如下提供两种方案。 一、location作用 location作用：根据用户请求的URL来执行 如果location 后面没有 location配置中： 当用户请求“/”时,将匹配configuration A 当用户请求“/index
Nginx实现URL路径转接
qq_24615449的博客
03-30 6210
Nginx实现URL路径转接
Nginx：URL重写（示意图+举例+配置讲解）
lifetime_gear的博客
10-14 1145
本文讲解了Nginx的url rewrite功能。
Nginx 替换请求路径重定向url rewrite
wangyu136117373的博客
08-02 2508
nginx 域名替换重定向
Nginx URL重写rewrite机制原理及使用实例
09-29
主要介绍了Nginx URL重写（rewrite）机制原理及使用实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
详解常用的nginx rewrite重写规则
09-30
主要介绍了详解常用的nginx rewrite重写规则，Nginx的rewrite功能是使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。感兴趣的可以一起来了解一下
详解nginx rewrite和根据url参数location
01-20
最近项目中涉及到旧老项目迁移，需要在nginx上做些配置，所以简单学习了下，好记性不如烂笔头，先记下来。 rewrite 首先查看下nginx是否支持rewrite： ./nginx -V 不支持说明安装nginx时候缺少pcre,需要重新安装...
nginx配置location总结location正则写法及rewrite规则写法
09-30
本文详细讲述了Nginx location正则写法，Nginx 的Rewrite规则以及Nginx.conf中if指令与全局变量
nginx修改请求path
风烟
11-12 4430
问题背景 有时候我们想把abc的路径修改为实际请求的是/def这个路径 我们就可以这样写，利用rewrite来实现 解决方案 改path location ^~ /abc { rewrite ^/abc$ /def break; proxy_pass http://aaa.com; } 也可以进行地址拼接转换 server { location ^~/v1/ { rewrite ^/v1/(.*)$ /$1 break; proxy_pas
mysql galere nginx_Nginx高级应用之Location Url 配置
weixin_42298373的博客
02-07 218
基本配置为了探究nginx的url配置规则，当然需要安装nginx。我使用了vagrant创建了一个虚拟环境的Ubuntu，通过apt-get安装nginx。这样就不会污染mac的软件环境。通过vragrant再创建一个项目进行实验。/vagrant目录下创建了一个pro用于项目的根目录，同时配置nginx的配置文件(/etc/nginx/sites-enabled/pro.conf)pro t...
nginx proxy_pass 代理转发请求时修改url路径
m0_37549390的博客
02-27 1711
nginx代理，向后转发请求时修改请求路径
如何使用 Nginx Ingress 快速实现 URL 重写
easylife206的专栏
09-04 1042
公众号关注「奇妙的 Linux 世界」设为「星标」，每天带你玩转 Linux ！什么是URL重写URL重写（URL rewriting）是一种在Web服务器上修改或转换请求URL的过程。它通常涉及使用服务器配置或规则来更改传入的URL，以便在不改变实际请求资源的情况下，实现不同的行为，如重定向、路径映射、参数处理等。URL重写在服务器层面进行，因此客户端（如浏览器）对于URL的请求不会感知到这些...
基于Nginx Rewrite 与 Location 的网页匹配 跳转
zcien的博客
03-13 685
基于Nginx Rewrite 与 Location 的网页匹配 跳转
RPKI资源公共密钥基础架构体系的搭建
最新发布
if_Echo_else的博客
05-14 596
一、安装二、目录说明三、管理命令。
nginx中location匹配规则
03-16
在nginx中，location是用来匹配请求URI的一种规则。它可以用来指定不同的处理方式，比如代理、重定向、缓存等。location匹配规则有以下几种： 1. 精确匹配：使用“=”符号，如location = /index.html，只有当请求URI为/index.html时才会匹配。 2. 前缀匹配：使用“^~”符号，如location ^~ /images/，只要请求URI以/images/开头就会匹配。 3. 正则匹配：使用“~”或“~*”符号，如location ~ \.(gif|jpg|png)$，只有当请求URI以.gif、.jpg或.png结尾时才会匹配。其中“~”表示区分大小写，“~*”表示不区分大小写。 4. 最长前缀匹配：没有特殊符号，如location /，会匹配所有请求URI。 当有多个location规则匹配同一个请求URI时，nginx会按照以下顺序选择匹配规则： 1. 精确匹配优先于其他匹配规则。 2. 如果有多个前缀匹配规则匹配同一个请求URI，则选择最长的前缀匹配规则。 3. 如果有多个正则匹配规则匹配同一个请求URI，则选择第一个匹配成功的规则。 4. 如果没有匹配成功的规则，则使用最长前缀匹配规则。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值