前言

現在 Nginx 已經成為很多公司作為前端反向代理 (proxy pass) 服務器的首選，在實際工作中往往會遇到很多跳轉（重寫URL）的需求。比如，更換域名后需要保持舊的域名能跳轉到新的域名上、某網頁發(fā)生改變需要跳轉到新的頁面、網站防盜鏈等等需求。如果在后端使用的Apache服務器，雖然也能做跳轉，規(guī)則庫也很強大，但是用 Nginx 跳轉效率會更高。

一、Nginx-rewrite模塊概述

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

• rewrite：對訪問的域名或者域名內的URL路徑地址重寫
• location：對訪問的路徑做訪問控制或者代理轉發(fā)

1、rewrite場景

• 調整用戶瀏覽的URL，看起來更規(guī)范，合乎開發(fā)及產品人員的請求。
• 為了讓搜索引擎搜錄網站內容及用戶體驗更好，企業(yè)會將動態(tài)URL地址偽裝成靜態(tài)地址提供服務。
• 網址換新域名后，讓舊域名訪問跳轉到新域名訪問。例如訪問京東的360buy.com會跳轉到jd.com。
• 服務端某些業(yè)務的調整，比如根據特殊變量、目錄、客戶端的信息進行URL調整等

2、rewrite實現

• Nginx是通過ngx_http_rewrite_module模塊支持URL重寫、支持if條件判斷，但不支持else。
• 該模塊需要PCRE支持，應在編譯Nginx時指定PCRE支持，默認已經安裝。根據相關變量重定向和選擇不同的配置，從一個location跳轉到另一個location，不過這樣的循環(huán)最多可以執(zhí)行10次，超過Nginx將返回500錯誤。
• PCRE支持：perl兼容正則表達式的語法規(guī)則匹配
• 同時，重寫模塊包括set指令，來創(chuàng)建新的變量并設其值，這在有些情境下非常有用的，如記錄條件標識、傳遞參數到其他location、記錄做了什么等等。
• rewrite功能就是，使用Nginx提供的全局變量或自己設置的變量，結合正則表達式和標志位實現URL的重寫及重定向。比如：更換域名后需要保持舊的域名能跳轉到新的域名上、某網頁發(fā)生改變需要跳轉到新的頁面、網站防盜鏈等等需求。

3、rewrite執(zhí)行順序

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

4、語法格式

rewrite <regex> <replacement> [flag];

• regex ：表示正則匹配規(guī)則。
• replacement ：表示跳轉后的內容。
• flag ：表示 rewrite 支持的 flag 標記。

flag標記說明：

• last ：本條規(guī)則匹配完成后，不終止重寫后的url匹配，一般用在 server 和 if 中。
• break ：本條規(guī)則匹配完成即終止，終止重寫后的url匹配，一般使用在 location 中。
• redirect ：返回302臨時重定向，瀏覽器地址會顯示跳轉后的URL地址。
• permanent ：返回301永久重定向，瀏覽器地址欄會顯示跳轉后的URL地址。

二、rewrite示例

1、基于域名的跳轉

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

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全局變量，代表請求主機頭字段或主機名
			rewrite ^/(.*)$ http://www.benet.com/$1 permanent;	#$1為正則匹配的內容，即“域名/”之后的字符串
        }
        root   html;
        index  index.html index.htm;
    }
}
echo "192.168.80.10 www.kgc.com www.benet.com" >> /etc/hosts
systemctl restart nginx

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

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

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

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;		#日志修改
	#設置是否合法的IP標記
    set $rewrite true;							#設置變量$rewrite，變量值為boole值true
    #判斷是否為合法IP
	if ($remote_addr = "192.168.80.10"){		#當客戶端IP為192.168.80.10時，將變量值設為false，不進行重寫
        set $rewrite false;
    }
	#除了合法IP，其它都是非法IP，進行重寫跳轉維護頁面
    if ($rewrite = true){						#當變量值為true時，進行重寫
        rewrite (.+) /weihu.html;				#將域名后邊的路徑重寫成/weihu.html后轉發(fā)，例如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>We are maintaining now!</h1>" > /var/www/html/weihu.html
systemctl restart nginx

只有 IP 為 192.168.80.10 能正常訪問，其它地址都是維護頁面
如果rewrite (.+) /weihu.html; 換成rewrite (.+) /weihu.html permanent; 的話，若不是 192.168.80.10 的主機訪問會使瀏覽器修改請求訪問的 URL 成 http://www.kgc.com/weihu.html 再請求訪問，這樣就會進入一直在 rewrite 的死循環(huán)，訪問請求會一直被重寫成 http://www.kgc.com/weihu.html 再請求訪問

3、基于舊域名跳轉到新域名后面加目錄

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

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

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

4、基于參數匹配的跳轉

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

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;
	if ($request_uri ~ ^/100-(100|200)-(\d+).html$) {
        rewrite (.+) http://www.kgc.com permanent;
    }
	location / {
        root   html;
        index  index.html index.htm;
    }
}

• $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
• d o c u m e n t u r i ：與 document_uri：與document 
• u
•  ri：與uri相同，這個變量指當前的請求URI，不包括任何傳遞參數，如:/abc/bbs/index.html

systemctl restart nginx

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

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

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

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 ~* /upload/.*\.php$ {
        rewrite (.+) http://www.kgc.com permanent;
    }
	location / {
        root   html;
        index  index.html index.htm;
    }
}
systemctl restart nginx

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

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

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 ~* ^/abc/123.html {
        rewrite (.+) http://www.kgc.com permanent;
    }
	location / {
        root   html;
        index  index.html index.htm;
    }
}
systemctl restart nginx

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

到此這篇關于Nginx-rewrite模塊概述的文章就介紹到這了,更多相關Nginx-rewrite模塊內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！