Nginx之location匹配和Rewrite重寫(xiě)跳轉(zhuǎn)方式

更新時(shí)間：2024年06月21日 09:06:42 作者：牛什么馬什么

這篇文章主要介紹了Nginx之location匹配和Rewrite重寫(xiě)跳轉(zhuǎn)方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

一、常用的Nginx 正則表達(dá)式

^ ：匹配輸入字符串的起始位置
$ ：匹配輸入字符串的結(jié)束位置
* ：匹配前面的字符零次或多次。如“ol*”能匹配“o”及“ol”、“oll”
+ ：匹配前面的字符一次或多次。如“ol+”能匹配“ol”及“oll”、“olll”，但不能匹配“o”
? ：匹配前面的字符零次或一次，例如“do(es)?”能匹配“do”或者“does”，”?”等效于”{0,1}”
. ：匹配除“\n”之外的任何單個(gè)字符，若要匹配包括“\n”在內(nèi)的任意字符，請(qǐng)使用諸如“[.\n]”之類(lèi)的模式
\ ：將后面接著的字符標(biāo)記為一個(gè)特殊字符或一個(gè)原義字符或一個(gè)向后引用。如“\n”匹配一個(gè)換行符，而“\$”則匹配“$”
\d ：匹配純數(shù)字
{n} ：重復(fù) n 次
{n,} ：重復(fù) n 次或更多次
{n,m} ：重復(fù) n 到 m 次
[] ：定義匹配的字符范圍
[c] ：匹配單個(gè)字符 c
[a-z] ：匹配 a-z 小寫(xiě)字母的任意一個(gè)
[a-zA-Z0-9] ：匹配所有大小寫(xiě)字母或數(shù)字
() ：表達(dá)式的開(kāi)始和結(jié)束位置
| ：或運(yùn)算符

二、location

1、location 大致可以分為三類(lèi)

精準(zhǔn)匹配：location = / {...}
一般匹配：location / {...}
正則匹配：location ~ / {...}

2、location 常用的匹配規(guī)則

= ：進(jìn)行普通字符精確匹配，也就是完全匹配。
^~ ：表示普通字符匹配。使用前綴匹配。如果匹配成功，則不再匹配其它 location。
~ ：區(qū)分大小寫(xiě)的匹配。
~* ：不區(qū)分大小寫(xiě)的匹配。
!~ ：區(qū)分大小寫(xiě)的匹配取非。
!~* ：不區(qū)分大小寫(xiě)的匹配取非。

3、location的優(yōu)先級(jí)

首先精確匹配 =
其次前綴匹配 ^~
其次是按文件中順序的正則匹配 ~或~*
然后匹配不帶任何修飾的前綴匹配
最后是交給 / 通用匹配

4、location 示例說(shuō)明

（1）location = / {}

=為精確匹配 / ，主機(jī)名后面不能帶任何字符串，比如訪問(wèn) / 和 /data，則 / 匹配，/data 不匹配
再比如 location = /abc，則只匹配/abc ，/abc/或 /abcd不匹配。若 location /abc，則即匹配/abc 、/abcd/ 同時(shí)也匹配 /abc/。

（2）location / {}

因?yàn)樗械牡刂范家?/ 開(kāi)頭，所以這條規(guī)則將匹配到所有請(qǐng)求比如訪問(wèn) / 和 /data, 則 / 匹配， /data 也匹配，
但若后面是正則表達(dá)式會(huì)和最長(zhǎng)字符串優(yōu)先匹配（最長(zhǎng)匹配）

（3）location /documents/ {}

匹配任何以 /documents/ 開(kāi)頭的地址，匹配符合以后，還要繼續(xù)往下搜索其它 location
只有其它 location后面的正則表達(dá)式?jīng)]有匹配到時(shí)，才會(huì)采用這一條

（4）location /documents/abc {}

匹配任何以 /documents/abc 開(kāi)頭的地址，匹配符合以后，還要繼續(xù)往下搜索其它 location
只有其它 location后面的正則表達(dá)式?jīng)]有匹配到時(shí)，才會(huì)采用這一條

（5）location ^~ /images/ {}

匹配任何以 /images/ 開(kāi)頭的地址，匹配符合以后，停止往下搜索正則，采用這一條

（6）location ~* .(gif|jpg|jpeg)$ {}

匹配所有以 gif、jpg或jpeg 結(jié)尾的請(qǐng)求
然而，所有請(qǐng)求 /images/ 下的圖片會(huì)被 location ^~ /images/ 處理，因?yàn)?^~ 的優(yōu)先級(jí)更高，所以到達(dá)不了這一條正則

（7）location /images/abc {}

最長(zhǎng)字符匹配到 /images/abc，優(yōu)先級(jí)最低，繼續(xù)往下搜索其它 location，會(huì)發(fā)現(xiàn) ^~ 和 ~ 存在

（8）location ~ /images/abc {}

匹配以/images/abc 開(kāi)頭的，優(yōu)先級(jí)次之，只有去掉 location ^~ /images/ 才會(huì)采用這一條

（9）location /images/abc/1.html {}

匹配/images/abc/1.html 文件，如果和正則 ~ /images/abc/1.html 相比，正則優(yōu)先級(jí)更高

優(yōu)先級(jí)總結(jié)：

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

5、實(shí)際網(wǎng)站使用中，至少有三個(gè)匹配規(guī)則定義

第一個(gè)必選規(guī)則直接匹配網(wǎng)站根，通過(guò)域名訪問(wèn)網(wǎng)站首頁(yè)比較頻繁，使用這個(gè)會(huì)加速處理，比如說(shuō)官網(wǎng)。

這里是直接轉(zhuǎn)發(fā)給后端應(yīng)用服務(wù)器了，也可以是一個(gè)靜態(tài)首頁(yè)

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

第二個(gè)必選規(guī)則是處理靜態(tài)文件請(qǐng)求，這是nginx作為http服務(wù)器的強(qiáng)項(xiàng)

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

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

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

第三個(gè)規(guī)則就是通用規(guī)則，比如用來(lái)轉(zhuǎn)發(fā)帶.php、.jsp后綴的動(dòng)態(tài)請(qǐng)求到后端應(yīng)用服務(wù)器

非靜態(tài)文件請(qǐng)求就默認(rèn)是動(dòng)態(tài)請(qǐng)求

location / {
proxy_pass http://tomcat_server;

}

三、rewrite

rewrite功能就是，使用nginx提供的全局變量或自己設(shè)置的變量，結(jié)合正則表達(dá)式和標(biāo)志位實(shí)現(xiàn)url重寫(xiě)以及重定向。

rewrite只能放在server{},location{},if{}中，并且默認(rèn)只能對(duì)域名后邊的除去傳遞的參數(shù)外的字符串起作用，

例如 http://www.kgc.com/a/we/index.php?id=1&u=str 只對(duì)/a/we/index.php重寫(xiě)

rewrite 執(zhí)行順序如下:

(1) 執(zhí)行 server 塊里面的 rewrite 指令。
(2) 執(zhí)行 location 匹配。
(3) 執(zhí)行選定的 location 中的 rewrite 指令。

語(yǔ)法

語(yǔ)法rewrite <regex> <replacement> [flag];

regex ：表示正則匹配規(guī)則。
replacement ：表示跳轉(zhuǎn)后的內(nèi)容。
flag ：表示 rewrite 支持的 flag 標(biāo)記。

flag標(biāo)記說(shuō)明

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

四、rewrite 示例：準(zhǔn)備工作

（1）基于域名的跳轉(zhuǎn)

舊域名www.kgc.com有業(yè)務(wù)需求變更，需要使用新域名www.benet.com代替，但是舊域名不能廢除，需要跳轉(zhuǎn)到新域名上，而且后面的參數(shù)保持不變。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log;		#日志修改
	location / {
	#添加域名重定向
        if ($host = 'www.kgc.com'){						#$host為rewrite全局變量，代表請(qǐng)求主機(jī)頭字段或主機(jī)名
			rewrite ^/(.*)$ http://www.benet.com/$1 permanent;		#$1為正則匹配的內(nèi)容，即域名后邊的字符串
        }
        root   html;
        index  index.html index.htm;
    }
}
 
echo "192.168.110.50 www.kgc.com www.benet.com" >> /etc/hosts
systemctl restart nginx
瀏覽器輸入模擬訪問(wèn) http://www.kgc.com/test/1.html(雖然這個(gè)請(qǐng)求內(nèi)容是不存在的)
會(huì)跳轉(zhuǎn)到www.benet.com/test/1.html，查看元素可以看到返回301，實(shí)現(xiàn)了永久重定向跳轉(zhuǎn)，而且域名后的參數(shù)也正常跳轉(zhuǎn)。

（2）基于客戶(hù)端 IP 訪問(wèn)跳轉(zhuǎn)

業(yè)務(wù)新版本上線，要求所有 IP 訪問(wèn)任何內(nèi)容都顯示一個(gè)固定維護(hù)頁(yè)面，只有公司 IP ：192.168.110.50訪問(wèn)正常。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log;		#日志修改
 
	#設(shè)置是否合法的IP標(biāo)記
    set $rewrite true;							#設(shè)置變量$rewrite，變量值為boole值true
    #判斷是否為合法IP
	if ($remote_addr = "192.168.110.50"){		#當(dāng)客戶(hù)端IP為192.168.110.50時(shí)，將變量值設(shè)為false，不進(jìn)行重寫(xiě)
        set $rewrite false;
    }
	#除了合法IP，其它都是非法IP，進(jìn)行重寫(xiě)跳轉(zhuǎn)維護(hù)頁(yè)面
    if ($rewrite = true){						#當(dāng)變量值為true時(shí)，進(jìn)行重寫(xiě)
        rewrite (.+) /weihu.html;				#重寫(xiě)在訪問(wèn)IP后邊插入/weihu.html，例如192.168.110.11/weihu.html
    }
    location = /weihu.html {
        root /var/www/html;						#網(wǎng)頁(yè)返回/var/www/html/weihu.html的內(nèi)容
    }
	
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
mkdir -p /var/www/html/
echo "<h1>We are maintaining now!</h1>" > /var/www/html/weihu.html
systemctl restart nginx
只有 IP 為 192.168.110.50能正常訪問(wèn)，其它地址都是維護(hù)頁(yè)面

（3）基于舊域名跳轉(zhuǎn)到新域名后面加目錄

現(xiàn)在訪問(wèn)的是 http://bbs.kgc.com，現(xiàn)在需要將這個(gè)域名下面的訪問(wèn)都跳轉(zhuǎn)到http://www.kgc.com/bbs

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  bbs.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log;
	#添加
	location /post {
        rewrite (.+) http://www.kgc.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 test web1 !!"  >> /usr/local/nginx/html/bbs/test.html
echo "192.168.110.50 bbs.kgc.com"  >> /etc/hosts
systemctl restart nginx
使用瀏覽器訪問(wèn) http://bbs.kgc.com/ post/test.html 跳轉(zhuǎn)到 http://www.kgc.com/bbs/post/test.html

（4）基于參數(shù)匹配的跳轉(zhuǎn)

現(xiàn)在訪問(wèn)http://www.kgc.com/100-(100|200)-100.html 跳轉(zhuǎn)到http://www.kgc.com頁(yè)面

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;
	
	if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
        rewrite (.*) http://www.kgc.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx
使用瀏覽器訪問(wèn) http://www.kgc.com/100-200-100.html 或 http://www.kgc.com/100-100-100.html 跳轉(zhuǎn)到http://www.kgc.com頁(yè)面。

$request_ uri: 包含請(qǐng)求參數(shù)的原始URI，不包含主機(jī)名，如: http://www.kgc.com/ abc/bbs/index.html?au16b2中的/abc/bbs/index.php?a=1&b=2
Suri:這個(gè)變量指當(dāng)前的請(qǐng)求URI,不包括任何參數(shù)，如:/abc/bbs/ index.html
Sdocument_ uri:與$uri相同，這個(gè)變量指當(dāng)前的請(qǐng)求URI,不包括任何傳遞參數(shù)，如: /abc/bbs/ index.html

（5）基于目錄下所有 php 結(jié)尾的文件跳轉(zhuǎn)

要求訪問(wèn) http://www.kgc.com/upload/123.php 跳轉(zhuǎn)到首頁(yè)。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;
	
	location ~* /upload/(.*)\.php$ {
        rewrite (.+) http://www.kgc.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx
瀏覽器訪問(wèn) http://www.kgc.com/upload/123.php 跳轉(zhuǎn)到http://www.kgc.com頁(yè)面。

（6）基于最普通一條 url 請(qǐng)求的跳轉(zhuǎn)

要求訪問(wèn)一個(gè)具體的頁(yè)面如 http://www.kgc.com/abc/123.html 跳轉(zhuǎn)到首頁(yè)

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;
	
    location ~* ^/abc/123.html {
        rewrite (.+) http://www.kgc.com permanent;
    }
 
	location / {
        root   html;
        index  index.html index.htm;
    }
}
 
 
systemctl restart nginx
瀏覽器訪問(wèn) http://www.kgc.com/abc/123.html 跳轉(zhuǎn)到http://www.kgc.com頁(yè)面。