【轉】Nginx之正則表達式、location匹配簡介以及rewrite重寫

原文：https://blog.csdn.net/Xt991124/article/details/122434683

---

一、Nginx正則表達式

^ ：匹配輸入字符串的起始位置



$ ：匹配輸入字符串的結束位置



* ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll”



+ ：匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o”



? ：匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效於”{0,1}”



. ：匹配除“\n”之外的任何單個字符，若要匹配包括“\n”在內的任意字符，請使用諸如“[.\n]”之類的模式



\ ：將後面接着的字符標記爲一個特殊字符或一個原義字符或一個向後引用。如“\n”匹配一個換行符，而“\$”則匹配“$”



\d ：匹配純數字



\w ：匹配字母或數字或下劃線或漢字



\s ：匹配任意的空白符



\b ：匹配單詞的開始或結束



{n} ：重複 n 次



{n,} ：重複 n 次或更多次



{n,m} ：重複 n 到 m 次



[] ：定義匹配的字符範圍



[c] ：匹配單個字符 c



[a-z] ：匹配 a-z 小寫字母的任意一個



[a-zA-Z0-9] ：匹配所有大小寫字母或數字



() ：表達式的開始和結束位置



| ：或運算符

二、location 匹配簡介

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

1、匹配規則格式

①、精準匹配

②、一般匹配

③、正則匹配

2、常用的匹配規則

= ：進行普通字符精確匹配，也就是完全匹配。



^~ ：表示普通字符匹配。使用前綴匹配。如果匹配成功，則不再匹配其它 location。



~ ：區分大小寫的匹配。



~* ：不區分大小寫的匹配。



!~ ：區分大小寫的匹配取非。



!~* ：不區分大小寫的匹配取非。
      location = / {



          #規則A



      }



      location = /lucien {



          #規則B



      }



      location ^~ /lucien/ {



          #規則C



      }



      location ~ \.(gif|jpg|png)$ {



          #規則D



      }



      location ~* \.png$ {



          #規則E



      }



      location !~ \.html$ {



          #規則F



      }



      location !~* \.html$ {



          #規則G



      }



      location / {



          #規則H



      }

3、匹配的優先級

首先精確匹配 =



其次前綴匹配 ^~



再其次是按文件中順序的正則匹配 ~或~*



然後匹配不帶任何修飾的前綴匹配(一般匹配)



最後是交給 / 通用匹配

4、示例

（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 相比，正則優先級更高

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

①、第一個必選規則

直接匹配網站根，通過域名訪問網站首頁比較頻繁，使用這個會加速處理，比如說官網。



這裏是直接轉發給後端應用服務器了，也可以是一個靜態首頁



 



location = / {



    proxy_pass http://tomcat_server/;



}

②、第二個必選規則

處理靜態文件請求，這是nginx作爲http服務器的強項



有兩種配置模式，目錄匹配或後綴匹配,任選其一或搭配使用



 



location ^~ /static/ {



    root /webroot/static/;



}



 



location ~* \.(html|gif|jpg|jpeg|png|css|js|ico)$ {



    root /webroot/res/;



}

③、第三個規則

通用規則，比如用來轉發帶.php、.jsp後綴的動態請求到後端應用服務器



非靜態文件請求就默認是動態請求



 



location / {



    proxy_pass http://tomcat_server;



}

三、rewrite重寫

rewrite功能就是使用nginx提供的全局變量或自己設置的變量，結合正則表達式和標記實現URL重寫以及重定向。
例如：更換域名後需要保持舊的域名能夠轉到新的域名上、某網頁發生改變需要跳轉到新的頁面、網站防盜鏈等等需求。
rewrite只能放在server{}，location{}，if{}中，並且默認只能對域名後面的除去傳遞的參數外的字符串起作用。
例如：http://www.lucien.com/a/we/index.php?id=1&u=str 只對/a/we/index.php重寫。

1、rewrite 跳轉實現

Nginx：通過ngx_http_rewrite_module模塊支持URL重寫、支持if條件判斷，但不支持else
跳轉：從一個location跳轉到另一個location,循環最多可以執行10次，超過後nginx將返回500錯誤
PCRE支持：perl兼容正則表達式的語法規則匹配
重寫模塊set指令：創建新的變量併爲其賦值

2、rewrite執行順序

1、執行server塊裏面的rewrite指令
2、執行location匹配
3、執行選定的location中的rewrite指令

3、rewrite語法格式

語法rewrite<regex><replacement><flag>;



regex:表示正則匹配規則



replacement:表示跳轉後的內容



flag:表示rewrite支持的flag標記

4、flag標記說明

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

四、rewrite 示例

1、基於域名的跳轉

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

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



server {



	listen       80;



	server_name  www.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com.access.log;		#日誌修改



	location / {



	#添加域名重定向



        if ($host = 'www.lic.com'){						            #$host爲rewrite全局變量，代表請求主機頭字段或主機名



			rewrite ^/(.*)$ http://www.kiki.com/$1 permanent;		#$1爲正則匹配的內容，即域名後邊的字符串



        }



        root   html;



        index  index.html index.htm;



    }



}

echo “192.168.184.10 www.lic.com www.kiki.com” >> /etc/hosts

systemctl restart nginx

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

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

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

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



server {



	listen       80;



	server_name  www.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com-access.log  main;		#日誌修改



 



	#設置是否合法的IP標記



    set $rewrite true;							#設置變量$rewrite，變量值爲boole值true



    #判斷是否爲合法IP



	if ($remote_addr = "192.168.184.10"){		#當客戶端IP爲192.168.184.10時，將變量值設爲false，不進行重寫



        set $rewrite false;



    }



	#除了合法IP，其它都是非法IP，進行重寫跳轉維護頁面



    if ($rewrite = true){						#當變量值爲true時，進行重寫



        rewrite (.+) /weihu.html;				#重寫在訪問IP後邊插入/weihu.html，例如192.168.184.11/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 'hello weihu!' > /var/www/html/weihu.html



systemctl restart nginx

瀏覽器訪問
只有 IP 爲 192.168.184.10 能正常訪問，其它地址都是維護頁面

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

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

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



server {



	listen       80;



	server_name  kiki.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com-access.log;



	#添加



	location /post {



        rewrite (.+) http://www.lic.com/kiki$1 permanent;		#這裏的$1爲位置變量，代表/post



    }



	



	location / {



        root   html;



        index  index.html index.htm;



    }



}

mkdir -p /usr/local/nginx/html/kiki/post



systemctl restart nginx.service 

使用瀏覽器訪問
http://kiki.lic.com/post/1.html 跳轉到 http://www.lic.com/kiki/post/1.html

echo 'this is 1.html' > /usr/local/nginx/html/kiki/post/1.html



systemctl restart nginx.service 

4、基於參數匹配的跳轉

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

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



server {



	listen       80;



	server_name  www.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com-access.log  main;



	



	if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {



        rewrite (.+) http://www.lic.com permanent;



    }







	location / {



        root   html;



        index  index.html index.htm;



    }



}

systemctl restart nginx

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

5、基於目錄下所有 php 結尾的文件跳轉

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

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



server {



	listen       80;



	server_name  www.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com-access.log  main;



	



location ~* /upload/.*\.php$ {



    rewrite (.+) http://www.lic.com permanent;



}



 



location / {



    root   html;



    index  index.html index.htm;



}



}

systemctl restart nginx

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

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

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

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



server {



	listen       80;



	server_name  www.lic.com;		#域名修改	



	charset utf-8;



	access_log  /var/log/nginx/www.lic.com-access.log  main;



	



    location ~* ^/abc/123.html {



        rewrite (.+) http://www.lic.com permanent;



    }



 



	location / {



        root   html;



        index  index.html index.htm;



    }



}

systemctl restart nginx