nginx Rewrite重寫地址的實現

2022-07-19 14:05:47

一、Nginx正規表示式

常用的正規表示式元字元

字元	說明
^	匹配輸入字串的起始位置
$	匹配輸入字串的結束位置
*	匹配前面的字元零次或多次
+	匹配前面的字元一次或多次
？	匹配前面的字元零次或一次
.	匹配除“n”之外的任何單個字元
	將後面接著的字元標記為一個特殊字元或一個原義字元或一個向後參照
d	匹配純數位
{n}	重複n次
{n,m}	重複n次或更多次
[ ]	定義匹配的字元範圍
[c]	匹配單個字元c
[a-z]	匹配a-z小寫字母的任意一個
[a-zA-Z]	匹配a-z小寫字母或A-Z大寫字母的任意一個
()	表示式的開始和結束位置
l	或運運算元

從功能看 rewrite 和 location 似乎有點像，都能實現跳轉，主要區別在於 rewrite 是在同一域名內更改獲取資源的路徑，而 location 是對一類路徑做控制存取或反向代理，還可以proxy_pass 到其他機器。

二、location

2.1、location大致可以分為三類

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

2.2、 location 常用的匹配規則

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

2.3、 location優先順序

首先精確匹配 =
其次字首匹配 ^~
其次是按檔案中順序的正則匹配 ~ 或 ~*
然後匹配不帶任何修飾的字首匹配
最後是交給 / 通用匹配

2.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 {} www.baidu.com
匹配任何以 /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 檔案，如果和正則location ~ /images/abc/1.html 相比，正則優先順序更高

優先順序總結：
(location = 完整路徑) > (location ^~ 路徑) > (location ~,~* 正則順序) > (location 部分起始路徑) > (location /)

2.5、location 匹配

首先看優先順序：精確>字首>正則>一般>通用
優先順序相同：正則看上下順序，上面的優先；一般匹配看長度，最長匹配的優先
精確、字首、正則、一般都沒有匹配到，最後再看通用匹配

2.6、實際網站使用中，至少有三個匹配規則定義

1.第一個必選規則

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

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

2.第二個必選規則

是處理靜態檔案請求，這是nginx作為http伺服器的強項有兩種設定模式，目錄匹配或字尾匹配,任選其一或搭配使用

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

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

3.第三個規則

就是通用規則，比如用來轉發帶.php、.jsp字尾的動態請求到後端應用伺服器

非靜態檔案請求就預設是動態請求

location / {
    proxy_pass http://tomcat_server;
}

三、rewrite

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

rewrite只能放在server{},location{},if{}中，並且預設只能對域名後邊的除去傳遞的引數外的字串起作用，例如 http://www.kgc.com/abc/bbs/index.php?a=1&b=2只對/abc/bbs/index.php重寫。

URL：就是具體路徑/位置
URl：指的是一個擁有相同型別/特性的物件集合

3.1、rewrite跳轉實現

Nginx：通過ngx_http_rewrite_module 模組支援URL重寫、支援if條件判斷，但不支援else
跳轉：從一個 location跳轉到另一個location，迴圈最多可以執行10次，超過後nginx將返回500錯誤
PCRE支援：perl相容正規表示式的語法規則匹配
重寫模組 set 指令：建立新的變數並設其值

3.2、rewrite執行順序

執行 server 塊裡面的 rewrite 指令。
執行 location 匹配。
執行選定的 location 中的 rewrite 指令。

3.3、語法格式

rewrite <regex> <replacement> [flag];

regex ：表示正則匹配規則。
replacement ：表示跳轉後的內容。
flag ：表示 rewrite 支援的 flag 標記。

3.4、flag標記說明

last ：本條規則匹配完成後，繼續向下匹配新的location URL規則，一般用在 server 和 if 中。
break ：本條規則匹配完成即終止，不再匹配後面的任何規則，一般使用在 location 中。
redirect ：返回302臨時重定向，瀏覽器地址會顯示跳轉後的URL地址。
permanent ：返回301永久重定向，瀏覽器位址列會顯示跳轉後的URL地址。

四、rewrite 範例

4.1、基於域名的跳轉

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

vim /usr/local/nginx/conf/nginx.conf

server {
    listen       80;
    server_name  www.gc.com;
    charset utf-8;
    access_log  /var/log/nginx/www.gc.com.access.log;
    location / {
        if ($host = 'www.gc.com'){
            rewrite ^/(.*)$ http://www.qqq.com/$1 permanent;
        }
        root   html;
        index  index.html index.htm;
    }
}

echo "192.168.132.6 www.gc.com www.qqq.com" >> /etc/hosts
mkdir -p /var/log/nginx/

systemctl restart nginx
cd /usr/local/nginx/html/test
vim 1.html

將對應的ip和域名寫入etc下hosts檔案

瀏覽器輸入模擬存取 http://www.gc.com/test/1.html(雖然這個請求內容是不存在的)
會跳轉到www.qqq.com/test/1.html，檢視元素可以看到返回301，實現了永久重定向跳轉，而且域名後的引數也正常跳轉。

4.2、基於使用者端 IP 存取跳轉

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

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.gc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.gc.com-access.log;		#紀錄檔修改

	#設定是否合法的IP標記
    set $rewrite true;							#設定變數$rewrite，變數值為boole值true
    #判斷是否為合法IP
	if ($remote_addr = "192.168.190.52"){		#當用戶端IP為192.168.190.52時，將變數值設為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>正在維護!!!等會再來</h1>" > /var/www/html/weihu.html
systemctl restart nginx

只有 IP 為 192.168.190.52 能正常存取，其它地址都是維護頁面

換一個臺伺服器存取顯示存取失敗

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

現在存取的是 http://bbs.gc.com/post/，現在需要將這個域名下面的存取都跳轉到http://www.gc.com/bbs/post/

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

http://bbs.gc.com/post/1.html 跳轉到 http://www.gc.com/bbs/post/1.html

4.4、基於引數匹配的跳轉

現在存取http://www.gc.com/100-(100|200)-100（任意數位）.html 跳轉到http://www.gc.com頁面。

vim /usr/local/nginx/conf/nginx.conf
server {
    listen       80;
    server_name  www.gc.com;
    charset utf-8;
    access_log  /var/log/nginx/www.gc.com.access.log;

    if ($request_uri ~ ^/100-(100|200)-(d+).html$) {
        rewrite (.+) http://www.gc.com permanent;
    }

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

echo "192.168.190.52 www.gc.com" >> /etc/hosts
systemctl restart nginx

瀏覽器存取
http://www.gc.com/100-200-100.html 或 
http://www.gc.com/100-100-100.html 跳轉到http://www.gc.com頁面。

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

要求存取 http://www.gc.com/upload/abc.php 跳轉到首頁。

vim /usr/local/nginx/conf/nginx.conf

server {
    listen       80;
    server_name  www.gc.com;
    charset utf-8;
    access_log  /var/log/nginx/www.gc.com.access.log;
    
location ~* /upload/.*.php$ {
    rewrite (.+) http://www.gc.com permanent;
}

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

echo "192.168.190.52 www.gc.com" >> /etc/hosts
systemctl restart nginx

瀏覽器存取
http://www.gc.com/upload/abc.php 跳轉到http://www.gc.com頁面。

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

要求存取一個具體的頁面如 http://www.gc.com/abc/123.html 跳轉到首頁

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

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

systemctl restart nginx

瀏覽器存取 http://www.gc.com/abc/123.html 跳轉到http://www.gc.com頁面。