Nginx—Rewrite

星球的眼睛  金牌会员 | 2024-9-23 03:41:51 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 500|帖子 500|积分 1500

目次
一、Nginx—Rewrite概述
1、常用的Nginx正则表达式
2、Rewrite功能
3、Rewrite跳转实现
4、Rewrite执行顺序和语法格式
二、location概述
1、location分类
2、location 常用的匹配规则
3、location 优先级
案例一：
案例二：
案例三：
案例四：
案例五：
案例六：
案例七：
案例八：
案例九：
三、Nginx 常见网站配置示例
3.1、网站根目次匹配规则
3.2、静态文件处置处罚规则
3.3、动态请求转发规则
四、Rewrite 案例
1、基于域名的跳转
2、基于客户端 IP 访问跳转
3、基于旧域名跳转到新域名后面加目次
4、基于参数匹配的跳转
5、基于目次下所有 php 末端的文件跳转
6、基于最普通一条 url 请求的跳转

一、Nginx—Rewrite概述

1、常用的Nginx正则表达式

^匹配输入字符串的起始位置
$匹配输入字符串的结束位置
*匹配前面的字符零次或多次
+匹配前面的字符一次或多次
?匹配前面的字符零次或一次
.匹配除 \n 之外的任何单个字符
\转义字符，使后面的字符被视为普通字符或特殊字符
\d匹配数字（相称于 [0-9]）
{n}匹配前面的字符恰好 n 次
{n,}匹配前面的字符至少 n 次
{n,m}匹配前面的字符至少 n 次，至多 m 次
[]界说字符集，匹配括号内的恣意单个字符
[c]匹配单个字符 c
[a-z]匹配小写字母中的恣意一个
[a-zA-Z0-9]匹配所有大小写字母或数字
()组括号，分组和捕捉子表达式
2、Rewrite功能

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


  • 比如：更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求。
②、rewrite只能放在server{},location{},if{}中，而且默认只能对域名后边的除去通报的参数外的字符串起作用，


  • 例如：http://www.kgc.com/abc/bbs/index.php?a=1&b=2 只对/abc/bbs/index.php重写。

3、Rewrite跳转实现

ngx_http_rewrite_module 模块：


  • 支持 URL 重写和条件判定。
  • 通过 if 指令支持条件判定，但不支持 else。
URL 跳转：


  • 可以在 location 块中利用 rewrite 指令实现从一个 location 跳转到另一个 location。
  • 跳转循环最多执行 10 次，超过 10 次会导致 Nginx 返回 500 错误。
PCRE 支持：


  • 支持 Perl 兼容正则表达式（PCRE）语法规则进行匹配。
set 指令：


  • 用于创建新的变量并设定其值。
4、Rewrite执行顺序和语法格式

①、执行顺序：
执行 server 块中的 rewrite 指令：


  • 在 server 块中界说的 rewrite 指令首先被执行，用于处置处罚请求。
执行 location 匹配：


  • 根据请求的 URI，Nginx 会匹配最合适的 location 块。
执行选定的 location 中的 rewrite 指令：


  • 在匹配到的 location 块中，执行该块内界说的 rewrite 指令。
②、语法格式：
  1. rewrite <regex> <replacement> [flag];
复制代码
regex：


  • 表示用于匹配请求 URL 的正则表达式规则。
  • replacement：

    • 表示 URL 重写后的目标内容或路径。

flag（可选）：


  • 用于指定重写的标志，影响重写操作的行为。
常见标志包括：


  • last：停止当前 location 的匹配过程，重新选择合适的 location。
  • break：停止当前 location 的匹配过程，并继承执行当前 location 中的其他指令。
  • redirect：发出一个暂时的 302 重定向响应。
  • permanent：发出一个永世的 301 重定向响应。
二、location概述

1、location分类

①、精准匹配


  • 语法：location = / {...}
  • 阐明：严格匹配指定的 URI，只有当请求的 URI 完全匹配时，才会应用该 location 块中的配置。
②、一样平常匹配：


  • 语法：location / {...}
  • 阐明：前缀匹配，请求的 URI 以指定的前缀开头时会匹配该 location 块。适用于大多数简朴的 URI 匹配情况。
③、正则匹配：


  • 语法：location ~ /regex {...}
  • 阐明：利用正则表达式进行匹配，适用于复杂的 URI 匹配场景。正则匹配会在一样平常匹配后进行。
2、location 常用的匹配规则

匹配规则阐明示例=准确匹配 URI，URI 必须完全匹配时才应用location = /yudh { ... }^~普通字符前缀匹配，匹配乐成后停止其他 location 匹配location ^~ /images/ { ... }~区分大小写的正则表达式匹配location ~ .jpg$ { ... }~*不区分大小写的正则表达式匹配location ~* .jPg$ { ... }!~区分大小写的正则表达式匹配取非location !~ .jpg$ { ... }!~*不区分大小写的正则表达式匹配取非location !~* .jPg$ { ... } 3、location 优先级



  • 首先准确匹配 =
  • 其次前缀匹配 ^~
  • 其次是按文件中顺序的正则匹配 ~或~*
  • 然后匹配不带任何修饰的前缀匹配  abc
  • 末了是交给 / 通用匹配      /
案例一：

  1. location = /http://www.kgc.com/data {
  2.     # 配置
  3. }
  4. location = /abc {
  5.     # 配置
  6. }
复制代码


  • location = /http://www.kgc.com/data它不匹配/data，由于location =/http://www.kgc.com/data=为准确匹配 / ，主机名后面不能带任何字符串，比如访问 / 和 /data，则 / 匹配，/data 不匹配。
  • 再比如 location = /abc，它只匹配/abc ；/abc/或 /abcd不匹配。若 location  /abc，则即匹配/abc 或/abcd/ 同时也匹配。
案例二：

  1. location / {
  2.     # 配置
  3. }
复制代码
比如有以下三个地址：


  • http://www.kgc.com/data  
  • http://www.kgc.com/data/abc    
  • /a/usr/local/nginx/html/data/abc 
由于所有的地址都以 / 开头，所以这条规则将匹配到所有请求 比如访问 / 和 /data, 则 / 匹配，/data 也匹配。但若后面是正则表达式会和最长字符串优先匹配（最长匹配）
案例三：

  1. location /documents/ {
  2.     # 配置
  3. }
复制代码
比如有以下一个地址：


  • http://www.kgc.com/documents/abc
它匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继承往下搜刮别的 location；只有别的 location后面的正则表达式没有匹配到时，才会接纳这一条。
案例四：

  1. location /documents/abc {
  2.     # 配置
  3. }
复制代码
匹配任何以 /documents/abc 开头的地址，匹配符合以后，还要继承往下搜刮别的 location；只有别的 location后面的正则表达式没有匹配到时，才会接纳这一条。
案例五：

  1. location ^~ /images/ {
  2.     # 配置
  3. }
复制代码
匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜刮正则，接纳这一条。
案例六：

  1. location ~* \.(gif|jpg|jpeg)$ {
  2.     # 配置
  3. }
复制代码
匹配所有以 gif、jpg或jpeg 末端的请求，然而，所有请求 /images/ 下的图片会被 location ^~ /images/ 处置处罚，由于 ^~ 的优先级更高，所以到达不了这一条正则。
案例七：

  1. location /images/abc {
  2.     # 配置
  3. }
复制代码
 最长字符匹配到 /images/abc，优先级最低，继承往下搜刮别的 location，会发现 ^~ 和 ~ 存在。
案例八：

  1. location ~ /images/abc {
  2.     # 配置
  3. }
复制代码
匹配以/images/abc 开头的，优先级次之，只有去掉 location ^~ /images/ 才会接纳这一条。
案例九：

  1. location /images/abc/1.html {
  2.     # 配置
  3. }
  4. location ~ /images/abc/1.html {
  5.     # 配置
  6. }
复制代码
匹配/images/abc/1.html 文件，如果和正则location ~ /images/abc/1.html 相比，正则优先级更高
优先级总结：
  1. (location = 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (location /)
复制代码
location 匹配顺序：


  • 首先看 优先级：准确>前缀>正则>一样平常>通用
  • 优先级雷同：正则看上下顺序，上面的优先；一样平常匹配看长度，最长匹配的优先
  • 准确、前缀、正则、一样平常 都没有匹配到，末了再看通用匹配  一样平常匹配
三、Nginx 常见网站配置示例

在实际网站的 Nginx 配置中，通常至少会界说三个匹配规则，以实现高效的请求处置处罚。这些规则包括首页的匹配规则、静态文件的处置处罚规则，以及动态请求的转发规则。
3.1、网站根目次匹配规则

这个规则用于直接匹配网站的根目次（/），通常用于访问网站首页。由于通过域名访问网站首页的请求较为频仍，利用这个规则可以加速处置处罚。首页可以是一个静态页面，也可以转发到后端应用服务器。
  1. location = / {
  2.     root   html;
  3.     index  index.html index.htm;
  4. }
复制代码
解释：当请求 URI 为 / 时，Nginx 会寻找 html 目次下的 index.html 或 index.htm 作为首页响应。如果有必要，这个请求也可以被转发到后端服务器进行处置处罚。
3.2、静态文件处置处罚规则

Nginx 作为 HTTP 服务器，处置处罚静态文件请求是其强项。可以通过目次匹配或后缀匹配来处置处罚静态资源请求，任选其一或搭配利用。
目次匹配：匹配以 /static/ 开头的请求，将其映射到文件体系的 /webroot/static/ 目次。
  1. location ^~ /static/ {
  2.     root /webroot/static/;
  3. }
复制代码
后缀匹配：匹配特定后缀的请求，如 .html、.gif、.jpg 等，将这些请求映射到文件体系的 /webroot/res/ 目次。
  1. location ~* \.(html|gif|jpg|jpeg|png|css|js|ico)$ {
  2.     root /webroot/res/;
  3. }
复制代码
解释：目次匹配主要用于静态资源的路径匹配，后缀匹配则用于对特定类型文件的请求匹配。根据实际需求，可以选择一种或两种方式组合利用。
3.3、动态请求转发规则

对于非静态文件的请求，通常会默认以为是动态请求，这类请求需要转发到后端应用服务器进行处置处罚。例如，将带有 .php 或 .jsp 后缀的请求转发给 Tomcat 等后端服务器。
  1. location / {
  2.     proxy_pass http://tomcat_server;
  3. }
复制代码
解释：这个通用规则将所有未匹配到前面规则的请求（即大多数动态请求）转发到后端应用服务器 http://tomcat_server 进行处置处罚。
四、Rewrite 案例

1、基于域名的跳转

在某些情况下，可能需要将旧域名的所有请求重定向到新域名，而且保持 URL 中的参数不变。以下是一个 Nginx 配置示例，用于将旧域名 www.kgc.com 的请求永世重定向到新域名。
编辑 Nginx 配置文件
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
设置 Nginx 服务器块
  1. server {
  2.     listen       80;
  3.     server_name  www.kgc.com;    //旧域名
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;    //设置访问日志
  8.     location / {
  9.         //添加域名重定向逻辑//
  10.         if ($host = 'www.kgc.com') {    //$host 变量表示请求的主机名
  11.             rewrite ^/(.*)$ http://www.benet.com/$1 permanent;     //将旧域名的请求重定向到新域名，保持参数不变
  12.         }
  13.         root   html;
  14.         index  index.html index.htm;
  15.     }
  16. }
复制代码
更新 /etc/hosts 文件
  1. echo "172.16.88.22 www.kgc.com www.benet.com" >> /etc/hosts
复制代码
重启 Nginx 服务并测试
  1. systemctl reload nginx
复制代码
在浏览器中访问旧域名，如 http://www.kgc.com/test/1.html，你将会看到页面自动跳转到 http://www.benet.com/test/1.html，而且浏览器的开发者工具中会表现返回的 301 状态码，表示实现了永世重定向。
2、基于客户端 IP 访问跳转

在某些情况下，可能需要根据客户端的 IP 地址来控制对网站的访问。例如，新的业务版本上线期间，所有的访问都需要跳转到维护页面，只有特定的公司 IP 地址可以正常访问网站。以下是 Nginx 的配置示例，用于实现这个需求。
首先，打开 Nginx 的主配置文件 nginx.conf 并进行编辑
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
在配置文件中，添加如下的 server 块配置，用于处置处罚旧域名的请求并将其重定向到新域名。
  1. server {
  2.     listen       80;
  3.     server_name  www.kgc.com;    //设置域名
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;    //设置访问日志
  8.     //设置 IP 访问控制变量
  9.     set $rewrite true;     //默认所有 IP 需要重定向到维护页面
  11.     # 判断是否为合法 IP 地址
  12.     if ($remote_addr = "172.16.88.22") {  //如果客户端 IP 为 172.16.88.22
  13.         set $rewrite false;  //不进行重写，允许正常访问
  14.     }
  16.     //对于非法 IP 地址进行重写跳转
  17.     if ($rewrite = true) {    //如果变量 $rewrite 仍为 true
  18.         rewrite (.+) /weihu.html;  //重定向到维护页面
  19.     }
  21.     //配置维护页面的 location
  22.     location = /weihu.html {
  23.         root /var/www/html;  //设置维护页面文件所在目录
  24.     }
  26.     //配置正常访问的 location
  27.     location / {
  28.         root   html;  //设置正常网站的根目录
  29.         index  index.html index.htm;
  30.     }
  31. }
复制代码
在 /var/www/html/ 目次下创建一个简朴的维护页面
  1. mkdir -p /var/www/html/
  2. echo "<h1>We are maintaining now!</h1>" > /var/www/html/weihu.html
复制代码
重启 Nginx 服务并测试
  1. systemctl restart nginx
复制代码


  • 访问网站时，只有 IP 为 172.16.88.22的用户 可以大概正常访问网站的内容。
  • 其他所有 IP 的访问请求都会被重定向到 /weihu.html 维护页面，并表现维护信息 We are maintaining now!。
3、基于旧域名跳转到新域名后面加目次

当旧域名需要重定向到新域名的特定路径时，可以利用 Nginx 的 rewrite 指令进行配置。以下是如何将旧域名 http://bbs.kgc.com/post/ 下的所有请求跳转到新域名。
打开 Nginx 的主配置文件 nginx.conf 并进行编辑
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
在配置文件中，添加如下的 server 块配置，用于处置处罚旧域名的重定向
  1. server {
  2.     listen       80;
  3.     server_name  bbs.kgc.com;    //旧域名
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;    //设置访问日志
  8.     //设置旧域名下 /post 的重定向规则
  9.     location /post {
  10.         rewrite ^/post(.*)$ http://www.kgc.com/bbs/post$1 permanent;  //进行永久重定向
  11.     }
  13.     //配置其他请求的处理
  14.     location / {
  15.         root   html;
  16.         index  index.html index.htm;
  17.     }
  18. }
复制代码
在新域名的对应路径下创建一个测试文件
  1. mkdir -p /usr/local/nginx/html/bbs/post
  2. echo "this is 1.html" > /usr/local/nginx/html/bbs/post/1.html
复制代码
修改本地 hosts 文件，为了在本地测试，将旧域名映射到本地服务器的 IP 地址
  1. echo "172.16.88.22 bbs.kgc.com" >> /etc/hosts
复制代码
重启 Nginx 服务并测试
  1. systemctl restart nginx
复制代码
在浏览器中访问 http://bbs.kgc.com/post/1.html。你应该会被重定向到http://www.kgc.com/bbs/post/1.html。这表明重定向规则已经乐成应用，而且旧域名的请求被准确地转发到了新域名下的相应路径。
4、基于参数匹配的跳转

在实际应用中，有时需要根据特定的 URL 参数模式将用户请求重定向到其他页面。下面是如何利用 Nginx 的 rewrite 指令实现这样的需求：将访问 http://www.kgc.com/100-(100|200)-100.html 的请求重定向到 http://www.kgc.com 首页。
打开 Nginx 的主配置文件 nginx.conf 并进行编辑：
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
在配置文件中，添加如下的 server 块配置，用于处置处罚基于参数匹配的跳转：
  1. server {
  2.     listen       80;
  3.     server_name  www.kgc.com;    //域名设置
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;     //设置访问日志
  8.     # 设置基于参数匹配的跳转规则
  9.     if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
  10.         rewrite (.+) http://www.kgc.com permanent;    //重定向到首页
  11.     }
  13.     # 配置其他请求的处理
  14.     location / {
  15.         root   html;
  16.         index  index.html index.htm;
  17.     }
  18. }
复制代码


  • $request_uri：表示包罗请求参数的原始 URI，不包罗主机名。
  • if ($request_uri ~ ^/100-(100|200)-(\d+).html$)：匹配 URL 中符合 100-100-100.html 或 100-200-100.html 模式的请求。
  • rewrite (.+) http://www.kgc.com permanent;：将符合条件的请求永世重定向到 http://www.kgc.com 首页。
重启 Nginx 服务并测试
  1. systemctl restart nginx
复制代码
利用浏览器访问以下链接：


  • http://www.kgc.com/100-100-100.html
  • http://www.kgc.com/100-200-100.html
两者均应被重定向到 http://www.kgc.com 首页，表明 Nginx 已乐成匹配并重定向请求。
Nginx 相干变量解释


  • $request_uri：包罗原始请求 URI 和参数（如 /abc/bbs/index.html?a=1&b=2）。
  • $uri：仅包罗请求的路径部分，不包罗参数（如 /abc/bbs/index.html）。
  • $document_uri：与 $uri 雷同，表示当前请求的路径部分，不包罗参数。
5、基于目次下所有 php 末端的文件跳转

在某些情况下，可能需要将访问特定目次下所有以 .php 末端的文件请求重定向到网站首页。以下是如安在 Nginx 中配置这类跳转的详细步骤。
首先，打开 Nginx 的主配置文件 nginx.conf 进行编辑：
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
在配置文件中，添加如下的 server 块，用于处置处罚对特定目次下 .php 文件的重定向：
  1. server {
  2.     listen       80;
  3.     server_name  www.kgc.com;  # 设置域名
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;  # 设置访问日志
  8.     # 配置对 /upload/ 目录下所有 .php 文件的跳转
  9.     location ~* /upload/.*\.php$ {
  10.         rewrite (.+) http://www.kgc.com permanent;  # 将匹配的请求永久重定向到首页
  11.     }
  12.    
  13.     # 配置其他请求的处理
  14.     location / {
  15.         root   html;
  16.         index  index.html index.htm;
  17.     }
  18. }
复制代码


  • location ~* /upload/.*\.php$：该行界说了对 /upload/ 目次下所有以 .php 末端的文件进行正则匹配，~* 表示不区分大小写。
  • rewrite (.+) http://www.kgc.com permanent;：将符合条件的请求永世重定向到 http://www.kgc.com 首页。
重启 Nginx 服务并测试重定向
  1. systemctl restart nginx
复制代码
利用浏览器访问以下链接：


  • http://www.kgc.com/upload/123.php
请求将被重定向到 http://www.kgc.com 首页，表明 Nginx 已乐成匹配并重定向请求。
6、基于最普通一条 url 请求的跳转

在一些场景中，可能需要将访问特定页面的请求重定向到网站的首页。以下是如安在 Nginx 中配置这类 URL 请求跳转的详细步骤。
首先，打开 Nginx 的主配置文件 nginx.conf 进行编辑
  1. vim /usr/local/nginx/conf/nginx.conf
复制代码
在配置文件中，添加如下的 server 块，用于处置处罚对特定 URL 的重定向：
  1. server {
  2.     listen       80;
  3.     server_name  www.kgc.com;    //设置域名
  5.     charset utf-8;
  6.     access_log  /var/log/nginx/www.kgc.com-access.log;    //设置访问日志
  8.     //配置对 /abc/123.html 页面请求的跳转
  9.     location ~* ^/abc/123.html {
  10.         rewrite (.+) http://www.kgc.com permanent;  //将匹配的请求永久重定向到首页
  11.     }
  13.     //配置其他请求的处理
  14.     location / {
  15.         root   html;
  16.         index  index.html index.htm;
  17.     }
  18. }
复制代码


  • location ~* ^/abc/123.html：该行界说了对详细 URL /abc/123.html 进行匹配，~* 表示不区分大小写。
  • rewrite (.+) http://www.kgc.com permanent;：将符合条件的请求永世重定向到 http://www.kgc.com 首页。
重启 Nginx 服务并测试重定向
  1. systemctl restart nginx
复制代码
利用浏览器访问以下链接：


  • http://www.kgc.com/abc/123.html
请求将被重定向到 http://www.kgc.com 首页，表明 Nginx 已乐成匹配并重定向请求。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

星球的眼睛

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

挺好的 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表