Nginx重寫功能（rewrite與location）

阿新 • • 發佈：2022-05-10

一、常用的Nginx 正則表示式
二、訪問路由location
三、訪問重新rewrite
- 1、rewrite的概述
- 2、rewrite 執行順序如下：
四、rewrite 示例：

一、常用的Nginx 正則表示式

字元	涵義以及示例
^	匹配輸入字串的起始位置
$	匹配輸入字串的結束位置
*	匹配前面的字元零次或多次；如“ol*”能匹配“o”及“ol”、“oll”
+	匹配前面的字元一次或多次；如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o”
?	匹配前面的字元零次或一次；例如“do(es)?”能匹配“do”或者“does”，”?”等效於”{0,1}”
.	匹配除“\n”之外的任何單個字元，若要匹配包括“\n”在內的任意字元，請使用諸如“[.\n]”之類的模式
\	將後面接著的字元標記為一個特殊字元或一個原義字元或一個向後引用。如“\n”匹配一個換行符，而“$”則匹配“$”
\d	匹配純數字
\s	匹配空的（空格或者製表符）
{n}	重複 n 次
{n,}	重複 n 次或更多次
{n,m}	重複 n 到 m 次
[ ]	定義匹配的字元範圍
[c]	匹配單個字元 c
[a-z]	匹配 a-z 小寫字母的任意一個
[a-zA-Z0-9]	匹配所有大小寫字母或數字
()	表示式的開始和結束位置
\|	或運算子

二、訪問路由location

1、location的分類

location 大致可以分為三類：

精準匹配：location = / {}
一般匹配：location / {}
正則匹配：location ~ / {}

2、location 常用的匹配規則：

字元	涵義
=	進行普通字元精確匹配，也就是完全匹配
^~	表示普通字元匹配。使用字首匹配。如果匹配成功，則不再匹配其它 location
~	區分大小寫的匹配
~*	不區分大小寫的匹配
!~	區分大小寫的匹配取非
!~*	不區分大小寫的匹配取非

3、location 優先順序：

首先精確匹配 =

其次字首匹配 ^~

其次是按檔案中順序的正則匹配 _或*

然後匹配不帶任何修飾的字首匹配

最後是交給 / 通用匹配

4、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 檔案，如果和正則 ~ /images/abc/1.html 相比，正則優先順序更高

優先順序總結：

(location =) > (location 完整路徑) > (location ^~ 路徑) > (location ,* 正則順序) > (location 部分起始路徑) > (location /）

location匹配

首先看優先順序：精確>字首>正則>一般>通用

優先順序相同：正則看上下順序，上面的優先；一般則看長度，最長匹配優先

精確、字首、正則、一般都沒有匹配到就看通用

5、實際網站使用中的三個匹配規則定義：

5.1 第一個必選規則

直接匹配網站根，通過域名訪問網站首頁比較頻繁，使用這個會加速處理，比如說官網。
這裡是直接轉發給後端應用伺服器了，也可以是一個靜態首頁

location = / {
    proxy_pass http://tomcat_server/;
}

5.2 第二個必選規則是處理靜態檔案請求

這是nginx作為http伺服器的強項！
有兩種配置模式，目錄匹配或字尾匹配,任選其一或搭配使用

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

5.3 第三個規則就是通用規則

比如用來轉發帶.php、.jsp字尾的動態請求到後端應用伺服器
非靜態檔案請求就預設是動態請求

location / {
    proxy_pass http://tomcat_server;
}

三、訪問重新rewrite

1、rewrite的概述

rewrite功能就是，使用nginx提供的全域性變數或自己設定的變數，結合正則表示式和標誌位實現url重寫以及重定向

rewrite只能放在server{},location{},if{}中，並且預設只能對域名後邊的除去傳遞的引數外的字串起作用，

例如：

http://www.xkq.com/kgc/index.php?id=1&u=str 只對/kgc/index.php重寫。

2、rewrite 執行順序如下：

(1) 執行 server 塊裡面的 rewrite 指令

(2) 執行 location 匹配

(3) 執行選定的 location 中的 rewrite 指令

語法: rewrite [flag];

regex ：表示正則匹配規則

replacement ：表示跳轉後的內容

flag ：表示 rewrite 支援的 flag 標記

###flag標記說明###

last ：本條規則匹配完成後，繼續向下匹配新的location URI規則，一般用在 server 和 if 中

break ：本條規則匹配完成即終止，不再匹配後面的任何規則，一般使用在 location 中

redirect：返回302臨時重定向，瀏覽器地址會顯示跳轉後的URL地址

permanent：返回301永久重定向，瀏覽器位址列會顯示跳轉後的URL地址。

四、rewrite 示例：

1、基於域名跳轉

1.1 基於域名跳轉——操作步驟

現在公司舊域名www.xkq.com有業務需求變更，需要使用新域名www.wy.com代替，但是舊域名不能廢除，需要跳轉到新域名上，而且後面的引數保持不變。

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.xkq.com;                                        #域名修改  
    charset utf-8;
    access_log  /var/log/nginx/www.ly.com-access.log;     #日誌修改
    location / {                                                    #新增域名重定向
        if ($host = 'www.xkq.com'){                                  #$host為rewrite全域性變數，代表請求主機頭欄位或主機名
            rewrite ^/(.*)$ http://www.wy.com/$1 permanent;        #$1為正則匹配的內容，即域名後邊的字串
        }
        root   html;
        index  index.html index.htm;
    }
}
 
echo "192.168.2.66 www.xkq.com www.wy.com" >> /etc/hosts
 
systemctl restart nginx                 #重啟服務

瀏覽器輸入模擬訪問 http://www.xkq.com/test/index.html會跳轉到www.wy.com/test/index.html，檢視元素可以看到返回301，實現了永久重定向跳轉，而且域名後的引數也正常跳轉

1.2 例項操作：基於域名跳轉

1.2.1 修改主配置檔案

1.2.2 重啟服務並新增對映關係

1.2.3 建立網頁

1.2.4 瀏覽器中訪問測試

2、基於客戶端 IP 訪問跳轉

2.1 基於客戶端 IP 訪問跳轉的操作步驟

要求：今天公司業務新版本上線，要求所有 IP 訪問任何內容都顯示一個固定維護頁面，只有公司 IP ：192.168.2.66訪問正常

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.xkq.com;        #域名修改  
    charset utf-8;
    access_log  /var/log/nginx/www.xkq.com-access.log;       #日誌修改
 
    #設定是否合法的IP標記
    set $rewrite true;                          #設定變數$rewrite，變數值為boole值true
    #判斷是否為合法IP
    if ($remote_addr = "192.168.2.66"){       #當客戶端IP為192.168.2.66時，將變數值設為false，不進行重寫
        set $rewrite false;
    }
    #除了合法IP，其它都是非法IP，進行重寫跳轉維護頁面
    if ($rewrite = true){                       #當變數值為true時，進行重寫
        rewrite (.+) /index.html;               #重寫在訪問IP後邊插入/index.html，例如192.168.2.66/index.html
    }
    location = /index.html {
        root /var/www/html;                     #網頁返回/var/www/html/index.html的內容
    }
     
    location / {
        root   html;
        index  index.html index.htm;
    }
}
 
mkdir -p /var/www/html/
echo "<h1>正在維護</h1>" > /var/www/html/index.html
systemctl restart nginx

2.2 例項操作：基於客戶端 IP 訪問跳轉

2.2.1 修改配置檔案

2.2.2 檢查配置檔案並重啟服務

2.2.3 建立跳轉後的網頁目錄和內容

2.2.4 瀏覽器訪問測試

本機訪問

其他主機訪問

訪問之前做域名IP對映

3、基於舊域名跳轉到新域名後面加目錄

3.1 基於舊域名跳轉到新域名後面加目錄的操作步驟

現在訪問的是 http://bbs.xkq.com/test，現在需要將這個域名下面的訪問都跳轉到http://www.xkq.com/bbs/test

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  bbs.xkq.com;        #域名修改  
    charset utf-8;
    access_log  /var/log/nginx/bbs.xkq.com-access.log;
    #新增
    location /test {
        rewrite (.+) http://www.xkq.com/bbs$1 permanent;     #這裡的$1為位置變數，代表/test
    }
     
    location / {
        root   html;
        index  index.html index.htm;
    }
}
 
mkdir -p /usr/local/nginx/html/bbs/post
echo "this is web"  >> /usr/local/nginx/html/bbs/test/1.html
echo "192.168.2.66 bbs.xkq.com www.xkq.com"  >> /etc/hosts
systemctl restart nginx

使用瀏覽器訪問 http://bbs.xkq.com/ test/1.html 跳轉到 http://www.xkq.com/bbs/test/1.html　　

3.2 例項操作：基於舊域名跳轉到新域名後面加目錄

3.2.1 修改主配置檔案

3.2.2 重啟服務並建立網頁檔案

3.2.3 新增對映關係並使用瀏覽器訪問測試

跳轉前

跳轉後

4、基於引數匹配的跳轉

4.1 基於引數匹配的跳轉的步驟

訪問http://www.xkq.com/100-(100|200)-100.html 跳轉到http://www.xkq.com頁面

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

解釋：

$request_uri: 包含請求引數的原始URI，不包含主機名，如: http://www.kgc.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

用瀏覽器訪問 http://www.xkq.com/100-200-100.html 或 http://www.xkq.com/100-100-100.html 跳轉到http://www.xkq.com頁面　

4.2 例項操作：基於引數匹配的跳轉

4.2.1 修改配置檔案

4.2.2 瀏覽器訪問測試

跳轉前

跳轉後

5、基於目錄下所有 php 結尾的檔案跳轉

要求訪問 http://www.xkq.com/upload/123.php 跳轉到首頁。

5.1 基於目錄下所有 php 結尾的檔案跳轉的操作步驟

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

瀏覽器訪問 http://www.xkq.com/upload/888.php 跳轉到http://www.xkq.com頁面。

5.2 例項操作：基於目錄下所有 php 結尾的檔案跳轉

5.2.1 修改配置檔案

5.2.2 瀏覽器訪問測試

跳轉前

跳轉後

6、基於最普通一條 url 請求的跳轉

6.1 基於最普通一條 url 請求的跳轉的操作步驟

要求訪問一個具體的頁面如 http://www.xkq.com/abc/888.html 跳轉到首頁

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

瀏覽器訪問 http://www.xkq.com/abc/888.html 跳轉到http://www.xkq.com頁面。　　