Nginx中rewrite的用法详解

最新推荐文章于 2024-12-10 04:45:00 发布
原创 最新推荐文章于 2024-12-10 04:45:00 发布 · 6.4k 阅读 · 49 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #linux

本文详细介绍了Nginx的rewrite模块用于URL重写及location配置的原理和应用场景，包括重定向、正则表达式、flag标记的使用，并通过多个实际案例展示了如何实现基于域名、IP、参数等条件的跳转策略。同时，探讨了rewrite与location在处理URL策略上的异同及其执行顺序，为Nginx配置提供了实用参考。

文章目录

一、rewrite简介

1.1 rewrite跳转场景

  • 1、URL看起来更规范、合理
  • 2、企业会将动态URL地址伪装成静态地址提供服务
  • 3、网址换新域名后，让旧的访问跳转到新的域名上
  • 4、服务端某些业务调整

1.2 rewrite跳转实现过程

在这里插入图片描述

1.3 rewrite实际场景

  • 1.3.1 Nginx跳转需求的实现方式
    使用rewrite进行匹配跳转
    使用if匹配全局变量后跳转
    使用location匹配再跳转
  • 1.3.2 rewrite放在server{}，if{}，location{}段中
    location只对域名后边的除去传递参数外的字符串起作用
  • 1.3.3 对域名或参数字符串
    使用if全局变量匹配
    使用proxy_pass反向代理

1.4 nginx正则表达式

常用的正则表达式元字符

^：匹配输入字符串的起始位置
$：匹配输入字符串的结束位置
*****：匹配前面的字符零次或多次
+：匹配前面的字符一次或多次
?：匹配前面的字符零次或一次
.：匹配除\n之外的任何单个字符 使用[.\n]可以匹配包括\n在内的任意字符
****：转义符
\d：匹配纯数字
{n}：重复n次
{n,}：重复n次或更多次
[c]：匹配单个字符c
[a-z]：匹配a-z小写字母的任意一个
[a-zA-Z]：匹配a-z小写字母或A-Z大写字母的任意一个

二、rewrite命令

2.1 rewrite 命令语法

rewrite  <正则表达式>  <跳转后的内容>  [rewrite支持的flag标记]

2.2 flag标记说明

在这里插入图片描述

2.3 last与break比较

1）last：url重写后，马上发起一个新请求。再次进入server块，重试location匹配，超过10次匹配不到报500错误，地址栏不变。
2）break：url重写后，直接使用当前资源，不再使用location余下的语句，完成本次请求，地址栏不变。
总结：last和break在重定向后，地址栏都不会发生变化，这是它们的相同点，不同点在于last会写在server和if中，break是写在location中，last不会终止重写后的url匹配，break会终止重写后的url匹配。

三、location

3.1 location优先级

1、相同类型的表达式，字符串长的会优先匹配
2、按优先级排列（把最先执行的写在配置文件的最上面）
= 类型
^~ 类型表达式
正则表达式（和*）类型
常规字符串匹配类型，按前缀匹配
通用匹配（/），如果没有其它匹配，任何请求都会匹配到

3.2 rewrite与location比较

  • 1、相同点
    都能实现跳转
  • 2、不同点
    rewrite是在同一域名内更改获取资源的路径
    location是对一类路径做控制访问或反向代理，还可以proxy_pass到其他机器
  • 3、rewrite会写在location里，执行顺序
    执行server块里面的rewrite指令
    执行location匹配
    执行选定的location中的rewrite指令
  • 4、location优先级示例
location = / {	###精确匹配 /，主机名后面不能带任何字符串
    [configuraion A ]	
}

location / {	###所有的地址都以/开头，这条规则将匹配到所有请求，但正则和最长字符串会优先匹配
    [configuraion B ]
}

location /documents/ {		###匹配任何以/documents/开头的地址，当后面的正则表达式没有匹配到时，才起作用
    [configuraion C ]
}

location ~ /documents/abc {		###匹配任何以/documents/abc开头的地址，当后面的正则表达式没有匹配到时，才会起作用
    [configuraion D ]
}

location ^~ /images/ {	###以/images/开头的地址，匹配符合后，停止往下匹配
    [configuraion E ]
}

location ~*\.(gif|jpg|gpeg)$ {	###匹配所有以 gif, jpg或jpeg结尾的请求， Images/下的图片会被 [configuration E]处理，因为^~的优先级更高
    [configuraion F ]
}

location /images/abc {	###最长字符匹配到 /images/abc，优先级最低
    [configuraion G ]
}

location ~ /images/abc {	###以/ Images/abc开头的，优先级次之
    [configuraion H ]
}

location /images/abc/1.html {	###如果和正则 ~ images/abc/1.htm相比，正则优先级更高
    [configuraion I ]
}

3.3 location常用优先级规则

1、匹配某个具体文件

（location = 完整路径）>（location ^~ 完整路径）>（location ~* 完整路径）=（location ~ 完整路径）>（location 目录）>（location /）

2、用目录做匹配访问整个文件

（location = 目录）>（location ^~ 目录）>（location ~* 目录）=（location ~ 目录）>（localtion 目录）>（location /）

四、实用案例

环境准备：需安装nginx服务

4.1 基于域名的跳转

现在公司旧域名www.old.com有业务需求有变更，需要使用新域名www.new.com代替。
要求：
旧域名不能废除，需要跳转到新域名上，而且后面的参数保持不变

修改配置文件

[root@client1 ~]# ln -s /usr/local/nginx/conf/nginx.conf /etc/nginx.conf
[root@client1 ~]# vi /etc/nginx.conf
......
    server {
        listen       80;
        server_name  www.old.com;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
            if ($host = 'www.old.com')  #rewrite的配置
               {
         rewrite ^/(.*)$ http://www.new.com/$1 permanent;    #将旧域名重写为新域名
               }
        }
......
#重启服务，可能需要重启电脑
systemctl restart nginx

添加映射

vi /etc/hosts
192.168.235.10 www.old.com www.new.com

验证，访问www.old.com，域名会自动跳转成新域名
在这里插入图片描述

4.2 基于客户端ip访问跳转

要求：
公司内部可以用来访问服务器的地址为192.168.35.10，其他客户端访问时跳转到error网页提示网页在维护，不可用
修改配置文件

[root@client1 ~]# vi /etc/nginx.conf 
    #gzip  on;   
    server {
        listen       80;
        server_name  www.aa.com;  #设置域名
        
        set $rewrite true;
            if ($remote_addr = "192.168.235.10"){   #仅本服务器访问时可访问正常页面
                 set $rewrite false;
            }
            
            if ($rewrite = true){   #其余客户机访问时，跳转到error网页
                 rewrite (.+) /error.html;
            }
            
            location = /error.html {
            root /usr/local/nginx/html;  #error网页目录
            }
            
            location / {
            root   html;
            index  index.html index.htm;
            ......

重启服务并关闭防火墙

systemctl restart nginx
systemctl stop firewalld
setenforce 0

添加映射

vi /etc/hosts
192.168.235.10 www.aa.com

其他客户机打开显示维护
在这里插入图片描述

4.3 基于新旧域名跳转并加目录

将域名http://old.aa.com下面的发帖都跳转到http://www.bb.com/bbs，且域名跳转后保持参数不变

修改配置文件

[root@client1 ~]# vi /etc/nginx.conf 
    server {
        listen       80;
        server_name  old.aa.com;    
        #charset koi8-r;    
        #access_log  logs/host.access.log  main;
                  
        location  /post {    #访问post路径下的网页，会跳转到，www.bb.com/bbs,下对应的网页
             rewrite (.+) http://www.bb.com/bbs$1 permanent;
        }
  
        location / {
            root   html;
            index  index.html index.htm;
            .....   
#重启服务
systemctl restart nginx

创建bbs目录

[root@client1 ~]# cd /usr/local/nginx/html/
[root@client1 html]# mkdir -p bbs/post
[root@client1 html]# cd bbs/post/
[root@client1 post]# vi index.html
welcom new web

添加IP与主机的映射，用哪个主机访问，就要在哪个主机上添加映射

[root@client1 post]# vi /etc/hosts
192.168.235.10 old.aa.com www.bb.com

测试。访问old.aa.com/post/index.html,，会跳转成如下页面
在这里插入图片描述

4.4 基于参数匹配的跳转

访问http://www.bb.com/100-(100|200)-任意数字.html
跳转到http://wwwbb.com页面。
修改配置文件

[root@client1 post]# vi /etc/nginx.conf 

    server {
        listen       80;
        server_name  www.bb.com;
        #charset koi8-r;
        #access_log  logs/host.access.log  main;
        #如果访问的域名跟上100-100-数字或100-200-数字.html的形式结尾，则跳转
        if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
            rewrite (.*) http://www.bb.com permanent;
        }

        location / {
            root   /usr/local/nginx/html;
            index  index.html index.htm;
......
#重启服务
systemctl restart nginx

测试，访问www.bb.com/100-200-13.html，或www.bb.com/100-100-99.html
在这里插入图片描述

4.5 基于目录下所有PHP文件的跳转

访问http://wwwbb.com/upload/test.php跳转到首页
修改配置文件

[root@client1 post]# vi /etc/nginx.conf
 server {
        listen       80;
        server_name  www.bb.com;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location ~* /upload/.*\.php$ {   #访问upload/目录下所有的PHP结尾的网页时跳转，不区分大小写
            rewrite (.+) http://www.bb.com permanent;
        }
        location  / {
            root   html;
            index  index.html index.htm;
        }
        ......
#重启服务
systemctl restart nginx

在这里插入图片描述

4.6 基于最普通url请求的跳转

访问一个具体的页面跳转到首页，如浏览器访问http://www.bbcom/test/test.html跳转到首页。
修改配置文件

[root@client1 post]# vi /etc/nginx.conf
 server {
        listen       80;
        server_name  www.bb.com;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location ~* ^/test/test.html {
          rewrite (.+) http://www.bb.com permanent;
        }
        location  / {
            root   html;
            index  index.html index.htm;
        }
        ......
#重启服务
systemctl restart nginx

在这里插入图片描述

糖果剑客
关注
详解nginx中location、rewrite用法总结
09-29
**Nginx中的Location与Rewrite用法详解** 在Nginx服务器配置中，`location`和`rewrite`是两个非常关键的指令，用于处理HTTP请求的路由和URL重写。理解并熟练运用这两个指令对于优化网站性能和提供灵活的URL管理至关...
Nginx Rewrite 详解
Y_Prodigal的博客
10-16 1787
Nginx Rewrite 详解
Nginx Rewrite概述分类和优先级——以及各种场景实验——超详细！！！
优快云著名博主
09-07 1958
Nginx Rewrite一、Nginx Rewrite概述1.1、Nginx Rewrite概述二、Nginx Rewrite基本操作2.1、Rewrite命令2.2、location分类和优先级2.2.1、location分类2.2.2、location优先级2.2.3、location优先级规则三、Rewrite使用场景实验搭建基础环境3.1、基于域名测试3.2、基于客户端IP访问跳转3.3、基于旧域名跳转到新域名3.4、基于参数匹配的跳转3.5、基于目录下所有以php结尾的文件跳转3.6、基于普通一
Nginx 之Rewrite 使用详解
zhangxueyi的专栏
12-10 2775
Nginx 的 `rewrite` 模块提供了强大的 URL 重写和重定向功能，可以用于实现各种复杂的 URL 处理需求。通过合理配置 `rewrite` 指令，可以提高网站的可用性、改善 SEO、实现域名迁移等。
Nginx-Rewrite&Location的网页匹配、跳转
自由
08-20 2094
一、常用的Nginx 正则表达式 字符 功能 ^ 匹配输入字符串的起始位置 $ 匹配输入字符串的结束位置 * 匹配前面的字符零次或多次；如“ol*”能匹配“o”及“ol”、“oll” + 匹配前面的字符一次或多次；如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o” ? 匹配前面的字符零次或一次；例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}” . 匹配除“\n”之外的任何单个字符，若要匹配包括“\n”在内的任意字符，请使
Nginx的Rewrite的运用
DTY9999的博客
06-04 3032
nginx里location的优先级以及rewrite的使用
Nginx之rewrite指令用法
Orion的博客
11-02 1816
/•将URL /images/1.html 重写为 /pics/1.html。//•将URL /pics/1.html 重写为 /photos/1.html。将URL /images/1.html 重写为 /pics/1.html, 重新进入server段后匹配了/pics location段,然后又被重写。将URL /images/1.html 重写为 /pics/1.html, 并且不再匹配其他location段。，浏览器的地址栏也会显示。
Nginx——Rewrite用法详解
方才coding
09-24 1万+
目录 1、Rewrite的定义 2、应用场景 3、Rewirte的语法 4、正则表达式 5、示例 1、Rewrite的定义 rewrite功能就是使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。 rewrite只能放在 server { }, location { }, if { }中，并且只能对域名后边的除去传递的参数外的字...
Nginx—Rewrite
A6985HG的博客
08-14 8641
①、精准匹配说明：严格匹配指定的 URI，只有当请求的 URI 完全匹配时，才会应用该location块中的配置。②、一般匹配说明：前缀匹配，请求的 URI 以指定的前缀开头时会匹配该location块。适用于大多数简单的 URI 匹配情况。③、正则匹配说明：使用正则表达式进行匹配，适用于复杂的 URI 匹配场景。正则匹配会在一般匹配后进行。
rewrite 的语法
系统运维
08-16 365
rewrite 的语法 语法:rewrite regex replacement flag 默认:none 作用域:server, location, if This directive changes URI in accordance with the regular expression and the replacement string. Direct...
nginx的rewrite用法
u013862108的博客
04-20 722
地址重写可以达到目的：缩短URL，隐藏实际路径提高安全性易于用户记忆和键入易于被搜索引擎收录常见网站应用场景：1. 网站文件移动或文件目录名称改变，出于SEO需要，你需要保持旧的URL规则：rewrite regex replacement flag- flag ： break, last, redirect, permanentlast : 停止当前这个请求，并根据rewrite匹配的规则重新发...
Nginx Rewrite规则详解
热门推荐
pang040328的专栏
11-17 1万+
Nginx Rewrite 规则相关指令 相关指令有if,rewrite,set,return,break等，其中最关键的就是rewrite.一个简单的Nginx Rewrite规则语法如下：rewrite ^/b/(.*)\.html /play.php?video=$1 break;  1.break指令 默认值：none ;使用环境：server,location,if ;
nginx rewrite功能使用
m0_67394360的博客
06-07 386
大家在浏览某些网站的时候，有没有发现，当输入：www.abc.com或者www.abcd.com的时候，页面均能正常显示www.abc.com的主页内容。这就是nginx rewrite的一个使用场景。rewrite功能实现依赖于pcre的支持，因此在编译安装Nginx服务器之前，需安装pcre库(nginx使用ngx_http_rewrite_module模块来解析和处理Rewrite功能的相关配置)在真正了解rewrite的使用之前，有必要全面系统学习下rewrite相关的指令和语法使用，下面来逐一了解
Nginx模块之rewrite模块
rmh0713的博客
02-23 4116
rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用。
Nginx的Rewrite基本用法
zhaoitfans的博客
04-01 522
Nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。rewrite只能放在server{},location{},if{}中，并且只能对域名后边的除去传递的参数外的字符串起作用。 Rewrite主要的功能就是实现URL的重写，Nginx的Rewrite规则采用Pcre，perl兼容正则表达式的语法规则匹配，如果需要Nginx的Rewrite功能，在编译Ngi...
Nginx中rewrite用法
石头
07-12 1903
rewrite功能：就是使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标志位实现url重写以及重定向。 （1）flag标志位： last #本条规则匹配完成后，继续向下匹配新的location URI规则 break #本条规则匹配完成即终止，不再匹配后面的任何规则 redirect #返回302临时重定向，浏览器地址会显示跳转后的URL地址 permanent ...
nginx中rewrite详解
最新发布
04-24
<think>好的，我现在要详细回答用户关于Nginx rewrite规则的问题。首先，我需要整理用户提供的引用内容，提取关键点，并确保回答结构清晰，符合用户的要求。用户希望了解rewrite的详细用法和规则，以及使用示例，所以我要覆盖基本语法、执行顺序、flag标志、正则表达式、与location的配合，以及常见示例。同时，需要引用提供的资料来支持内容，并生成相关问题。 首先，根据引用[5]，rewrite的基本语法是rewrite regex replacement [flag];，其中regex是正则，replacement是替换目标，flag可选。需要解释每个部分的作用，并提到支持的flag类型，比如last、break、redirect、permanent，这些在引用[5]的示例中有提到。 然后，执行顺序部分，根据引用[3]，Nginx的location匹配优先级会影响rewrite的执行顺序，可能需要按优先级列出，比如精确匹配(=) > 前缀匹配(^~) > 正则匹配(~或~*) > 通用匹配。同时，根据引用[5]中的例子，说明rewrite规则在server块和location块中的执行顺序，比如server块中的rewrite先执行，然后是location中的。 接下来，flag标志的详细说明。根据引用[4]和[5]，break会停止当前location的后续rewrite，而last会重新发起请求。需要区分两者的不同，比如break在当前位置终止，而last会重新走匹配流程。redirect和permanent分别对应302和301重定向，这部分引用[5]的示例中有说明。 正则表达式部分需要解释常用符号，如^表示开始，$结束，()捕获组，$1引用，这些在引用[5]的正则例子中都有用到，比如^/html/(.+?).html$和$1的引用。 与location的配合使用，根据引用[2]和[4]，可能需要多个location块来处理不同的rewrite规则，因为一旦匹配到某个location，可能不会继续执行其他location中的rewrite。例如，引用[2]的示例中，/test和/yy的location分别处理不同的重写，并且使用last和break标志。 常见示例部分需要包括域名重定向、路径转换、动态参数处理等，这些在引用[5]中有多个例子，比如将/search/key重写为/search.html?keyword=key，使用正则捕获组。同时，引用[3]提到的目录匹配优先级也可能影响示例的选择。 注意事项方面，根据引用[1]，需要提到避免过度使用if指令，推荐使用rewrite来保持配置简洁。此外，测试配置和正则调试的重要性，引用[5]中的例子展示了不同的flag效果，需要注意配置后的重载和测试。 最后，生成相关问题，可能需要包括不同flag的区别、正则表达式的编写、与location的优先级问题、性能优化等，确保问题覆盖用户可能关心的其他方面。 现在需要组织这些信息，确保结构清晰，使用中文，正确应用LaTeX格式，引用标记正确，并附上相关问题。需要避免使用Markdown格式，但用户示例中允许代码块，因此可以保留代码示例。同时，确保每个引用来源正确标注，如[^1]、[^2]等。</think>### Nginx rewrite规则详解及使用示例 #### 一、rewrite基本语法 Nginx的rewrite指令语法为： $$rewrite\ \ \ regex\ \ \ replacement\ \ \ [flag];$$ 其中： - **regex**：正则表达式，用于匹配请求URI - **replacement**：替换后的目标URI - **flag**：标志位（可选），控制重写行为[^5] #### 二、执行顺序与优先级 1. **server块**中的rewrite规则优先执行 2. 根据location匹配优先级执行： $$(location=) \succ (location\verb|^~|) \succ (location~\*) \succ (location/)$$ [^3] 3. 同一作用域内按配置顺序执行 #### 三、flag标志详解 | 标志 | 行为 | HTTP状态码 | |-----------|----------------------------------------------------------------------|------------| | **last** | 停止当前处理，重新发起请求匹配location | - | | **break** | 立即停止后续所有rewrite规则 | - | | redirect | 返回临时重定向 | 302 | | permanent | 返回永久重定向 | 301 | 示例对比： ```nginx # last会重新匹配location，break直接终止 location / { rewrite ^/a.html /b.html last; # 重新发起请求 rewrite ^/b.html /c.html break; # 终止后续处理[^4] } ``` #### 四、正则表达式关键符号 - `^`：匹配字符串开始（如`^/user`） - `$`：匹配字符串结束（如`.html$`） - `()`：捕获分组，通过`$1`-`$9`引用 - `.*`：匹配任意字符（贪婪模式） - `.+?`：非贪婪匹配 #### 五、典型应用场景 1. **域名重定向** ```nginx rewrite ^/(.*) http://newdomain.com/$1 permanent; [^5] ``` 2. **路径转换** ```nginx rewrite ^/product/(\d+)$ /item?id=$1 break; # 将/product/123转为/item?id=123 ``` 3. **动态参数处理** ```nginx rewrite ^/search/([^/]+)/?$ /search.html?keyword=$1? permanent; [^5] ``` 4. **文件扩展名隐藏** ```nginx rewrite ^/(.*)/$ /$1/index.html; # 将/about/重写为/about/index.html ``` #### 六、与location配合规则 ```nginx location /test { rewrite ^/test/(.*) /yy/$1 last; # 重写后重新匹配location[^2] } location /yy { rewrite ^/yy/(.*) http://baidu.com break; # 直接终止处理链[^2] } ``` #### 七、注意事项 1. 避免过度使用`if`判断，优先使用rewrite实现条件逻辑[^1] 2. 测试时建议先用`redirect`标志观察效果 3. 正则表达式需进行边界限定（如`^`和`$`） 4. 修改配置后需执行`nginx -s reload`重载配置
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值