Nginx 正则表达式和rewrite

Alterego_

墨衍会员 · AI 创作全网分发码龄6年

关注

原创最新推荐文章于 2026-06-10 20:58:01 发布 366 阅读 AI 写同款· GEO 优化 ›

Nginx服务之Rewrite nginx服务之Rewrite功能阅读详情

文章目录

常用的Nginx 正则表达式
location
rewrite

常用的Nginx 正则表达式

^：配输入字符串的起始位置
$：匹配输入字符串的结束位置
*：匹配前面的字符零次或多次。如"12*“能匹配”1”及"12"、"122"
+：匹配前面的字符一次或多次。如"12+“能匹配”12“及”122"、"1222"，但不能匹配"1”
?：匹配前面的字符零次或一次，例如"12(34)?”能匹配"12“或者”1234"，"?“等效于” {0,1}”
.：匹配除" \n“之外的任何单个字符，若要匹配包括”\n“在内的任意字符，请使用诸如”[.\n]“之类的模式
\：将后面接着的字符标记为一个特殊字符或一个原义字符或一个向后引用。如”\n“匹配一个换行符，而”\$“则匹配”$"
\d：匹配纯数字（仅代表一个数字）
{n}：重复n次
{n,}：重复n次或更多次
{n, m}：重复n到m次
[ ]：定义匹配的字符范围
[c]：匹配单个字符 c
[a-z]：匹配a-z小写字母的任意一个（只能匹配一次）
[a-zA-Z0-9]：匹配所有大小写字母或数字（也是只能匹配一次）
()：表达式的开始和结束位置
l ：或运算符

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

location

location的分类

location大致可以分为三类:

精准匹配：location = / {...}
一般匹配：location / {...}
正则匹配：location ~ l {...}

location常用的匹配规则

=：进行普通字符精确匹配,也就是完全匹配。
^~：表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其它location。
~：区分大小写的匹配。
~*：不区分大小写的匹配。
!~：区分大小写的匹配取非。
!~*：不区分大小写的匹配取非。

location优先级

首先精确匹配=
其次前缀匹配^~
其次是按文件中顺序的正则匹配～或～*
然后匹配不带任何修饰的前缀匹配
最后是交给/通用匹配

location示例说明:

`location = / { }`

=为精确匹配 / ，主机名后面不能带任何字符串，比如访问/和/data，则/匹配，/data不匹配
再比如 location = /abc，则只匹配/abc ,/abc/或/abcd不匹配。若location /abc，则即匹配/abc 、/abcd/同时也匹配/abc/

`location / { }`

因为所有的地址都以/开头，所以这条规则将匹配到所有请求。比如访问/和/data，则/匹配，/data也匹配，但若后面是正则表达式会和最长字符串优先匹配（最长匹配）

`location /documents/ { }`

匹配任何以/documents/开头的地址，匹配符合以后，还要继续往下搜索其它 location只有其它 location后面的正则表达式没有匹配到时，才会采用这一条

`location /docunents/abc { }`

匹配任何以/documents/abc开头的地址，匹配符合以后，还要继续往下搜索其它 location只有其它location后面的正则表达式没有匹配到时，才会采用这一条

`location ^~ /images/ { }`

匹配任何以/images/开头的地址，匹配符合以后，停止往下搜索正则，采用这一条

`location ~* \.(gif|jpg|jpeg)$ { }`

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

`location /images/abc { }`

最长字符匹配到/images/abc，优先级最低，继续往下搜索其它 location，会发现^~和～存在

`location ~ /images/abc { }`

匹配以/images/abc开头的，优先级次之，只有去掉location ^~ /images/才会采用这一条

`location /images/abc/1.html {}`

匹配/images/abc/1.html 文件，如果和正则location ~ /images/abc/1.html相比，正则优先级更高

优先级总结

(location = 完整路径) > (location ^~路径) > (location ~,~* 正则顺序) >(Location 部分起始路径)>(location /)

实际网站使用中，至少有三个匹配规则定义

直接匹配网站根

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

location = / {
    root html;
    index index.html index.htm;
}

处理静态文件请求

这是nginx作为http服务器的强项
有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用

location ^~ /static/ {
    root /webroot/staticl;
}

location ~* \.(html|gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/resl;
}

通用规则

比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器非静态文件请求就默认是动态请求

location / {
    proxy_pass http://tomcat server;
}

rewrite

rewrite功能是什么

rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。

比如：更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。

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

rewrite跳转实现

Nginx

通过ngx_http_rewrite_module模块支持URL重写、支持if条件判断，但不支持else

跳转

从一个location跳转到另一个location，循环最多可以执行10次，超过后nginx将返回500错误

PCRE支持

perl兼容正则表达式的语法规则匹配

重写模块set指令

创建新的变量并设其值

rewrite执行顺序

执行server块里面的rewrite指令。
执行location匹配。
执行选定的location中的rewrite指令。

语法格式

格式：rewrite <regex> <replacement> [flag];
regex：表示正则匹配规则。
replacement：表示跳转后的内容。
flag：表示rewrite支持的flag标记。

flag标记说明

last：本条规则匹配完成后，继续向下匹配新的location URL规则，一般用在server和 if 中。
break：本条规则匹配完成即终止，不再匹配后面的任何规则，一般使用在location中。
redirect：返回302临时重定向，浏览器地址会显示跳转后的URL地址。
permanent：返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。

rewrite示例

基于域名的跳转

现在公司旧域名ww.wo’l’f.com有业务需求变更，需要使用新域名www.ice.com代替，但是旧域名不能废除，需要跳转到新域名上，面且后面的参数保持不变。

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


echo "192.168.101.11 www.wolf.com www.ice.com" >> /etc/hosts
systemctl restart nginx

浏览器输入模拟访问http://www.wolf.com/test/1.html(虽然这个请求内容是不存在的)
会跳转到www.ice.com/test/1.html，查看元素可以看到返回301，实现了永久重定向跳转，而且域名后的参数也正常跳转。

基于客户端IP 访问跳转

今天公司业务新版本上线，要求所有IP访问任何内容都显示一个固定维护页面，只有公司IP∶192.168.101.11访问正常。

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.wolf.com;      #域名修改
    charset utf一8;
    access_log   /var/log/nginx/www.wolf.com-access.log;      #日志修改

    #设置是否合法的IP标记
    set $rewrite true;                        #设置变量$rewrite，变量值为boole值true
    #判断是否为合法IP
    if ($remote_addr = "192.168.101.11"){     #当客户端IP为192.168.101.110时，将变量值设为false，不进行重写
        set $rewrite false ;
    }
    #除了合法IP，其它都是非法IP，进行重写跳转维护页面
    if ($rewrite = true){                     #当变量值为true时，进行重写
        rewrite (.+) /weihu.html;             #重写在访问IP后边插入/weihu.html，例如192.168.101.15/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

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

基于旧域名跳转到新域名后面加目录

现在访问的是 http://bbs.wolf.com，现在需要将这个域名下面的访问都跳转到http://www.wolf.com/bbs

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  bbs.wolf.com;      #域名修改
    charset utf-8;
    access_log /var/log/nginx/www.wolf.com-access.log;
    #添加
    location /post {
        rewrite (.+) http://www.wolf.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.101.11 bbs.wolf.com" >>/etc/ hosts
systemctl restart nginx

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

基于参数匹配的跳转

现在访问http://www.wolf.com/100-(1001200)-100.html跳转到nttp://ww.wolf.com页面。

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


systemctl restart nginx

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

基于目录下所有php结尾的文件跳转

要求访问http://www.wolf.com/upload/123.php跳转到首页。

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


systemctl restart nginx

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

基于最普通一条url请求的跳转

要求访问一个具体的页面如http://www.wolf.com/abc/123.html跳转到首页

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


systemctl restart nginx