Nginx-rewrite模塊概述
前言
現(xiàn)在 Nginx 已經(jīng)成為很多公司作為前端反向代理 (proxy pass) 服務(wù)器的首選,在實(shí)際工作中往往會(huì)遇到很多跳轉(zhuǎn)(重寫URL)的需求。比如,更換域名后需要保持舊的域名能跳轉(zhuǎn)到新的域名上、某網(wǎng)頁發(fā)生改變需要跳轉(zhuǎn)到新的頁面、網(wǎng)站防盜鏈等等需求。如果在后端使用的Apache服務(wù)器,雖然也能做跳轉(zhuǎn),規(guī)則庫也很強(qiáng)大,但是用 Nginx 跳轉(zhuǎn)效率會(huì)更高。
一、Nginx-rewrite模塊概述
從功能上看 rewrite 和 location 似乎有點(diǎn)像,都能實(shí)現(xiàn)跳轉(zhuǎn),主要區(qū)別在于 rewrite 是在同一域名內(nèi)更改獲取資源的路徑,而 location 是對(duì)一類路徑做控制訪問或反向代理,還可以proxy_pass 到其他機(jī)器。
- rewrite:對(duì)訪問的域名或者域名內(nèi)的URL路徑地址重寫
- location:對(duì)訪問的路徑做訪問控制或者代理轉(zhuǎn)發(fā)
1、rewrite場(chǎng)景
- 調(diào)整用戶瀏覽的URL,看起來更規(guī)范,合乎開發(fā)及產(chǎn)品人員的請(qǐng)求。
- 為了讓搜索引擎搜錄網(wǎng)站內(nèi)容及用戶體驗(yàn)更好,企業(yè)會(huì)將動(dòng)態(tài)URL地址偽裝成靜態(tài)地址提供服務(wù)。
- 網(wǎng)址換新域名后,讓舊域名訪問跳轉(zhuǎn)到新域名訪問。例如訪問京東的360buy.com會(huì)跳轉(zhuǎn)到j(luò)d.com。
- 服務(wù)端某些業(yè)務(wù)的調(diào)整,比如根據(jù)特殊變量、目錄、客戶端的信息進(jìn)行URL調(diào)整等
2、rewrite實(shí)現(xiàn)
- Nginx是通過ngx_http_rewrite_module模塊支持URL重寫、支持if條件判斷,但不支持else。
- 該模塊需要PCRE支持,應(yīng)在編譯Nginx時(shí)指定PCRE支持,默認(rèn)已經(jīng)安裝。根據(jù)相關(guān)變量重定向和選擇不同的配置,從一個(gè)location跳轉(zhuǎn)到另一個(gè)location,不過這樣的循環(huán)最多可以執(zhí)行10次,超過Nginx將返回500錯(cuò)誤。
- PCRE支持:perl兼容正則表達(dá)式的語法規(guī)則匹配
- 同時(shí),重寫模塊包括set指令,來創(chuàng)建新的變量并設(shè)其值,這在有些情境下非常有用的,如記錄條件標(biāo)識(shí)、傳遞參數(shù)到其他location、記錄做了什么等等。
- rewrite功能就是,使用Nginx提供的全局變量或自己設(shè)置的變量,結(jié)合正則表達(dá)式和標(biāo)志位實(shí)現(xiàn)URL的重寫及重定向。比如:更換域名后需要保持舊的域名能跳轉(zhuǎn)到新的域名上、某網(wǎng)頁發(fā)生改變需要跳轉(zhuǎn)到新的頁面、網(wǎng)站防盜鏈等等需求。
3、rewrite執(zhí)行順序
- 執(zhí)行 server 塊里面的 rewrite 指令。
- 執(zhí)行 location 匹配。
- 執(zhí)行選定的 location 中的 rewrite 指令。
4、語法格式
rewrite <regex> <replacement> [flag];
- regex :表示正則匹配規(guī)則。
- replacement :表示跳轉(zhuǎn)后的內(nèi)容。
- flag :表示 rewrite 支持的 flag 標(biāo)記。
flag標(biāo)記說明:
- last :本條規(guī)則匹配完成后,不終止重寫后的url匹配,一般用在 server 和 if 中。
- break :本條規(guī)則匹配完成即終止,終止重寫后的url匹配,一般使用在 location 中。
- redirect :返回302臨時(shí)重定向,瀏覽器地址會(huì)顯示跳轉(zhuǎn)后的URL地址。
- permanent :返回301永久重定向,瀏覽器地址欄會(huì)顯示跳轉(zhuǎn)后的URL地址。
二、rewrite示例
1、基于域名的跳轉(zhuǎn)
現(xià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.80.10 www.kgc.com www.benet.com" >> /etc/hosts systemctl restart nginx
瀏覽器輸入模擬訪問 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、基于客戶端IP訪問跳轉(zhuǎn)
今天公司業(yè)務(wù)新版本上線,要求所有 IP 訪問任何內(nèi)容都顯示一個(gè)固定維護(hù)頁面,只有公司 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; #日志修改 #設(shè)置是否合法的IP標(biāo)記 set $rewrite true; #設(shè)置變量$rewrite,變量值為boole值true #判斷是否為合法IP if ($remote_addr = "192.168.80.10"){ #當(dāng)客戶端IP為192.168.80.10時(shí),將變量值設(shè)為false,不進(jìn)行重寫 set $rewrite false; } #除了合法IP,其它都是非法IP,進(jìn)行重寫跳轉(zhuǎn)維護(hù)頁面 if ($rewrite = true){ #當(dāng)變量值為true時(shí),進(jìn)行重寫 rewrite (.+) /weihu.html; #將域名后邊的路徑重寫成/weihu.html后轉(zhuǎn)發(fā),例如www.kgc.com/weihu.html } location = /weihu.html { root /var/www/html; #網(wǎng)頁返回/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.80.10 能正常訪問,其它地址都是維護(hù)頁面
如果rewrite (.+) /weihu.html; 換成rewrite (.+) /weihu.html permanent; 的話,若不是 192.168.80.10 的主機(jī)訪問會(huì)使瀏覽器修改請(qǐng)求訪問的 URL 成 http://www.kgc.com/weihu.html 再請(qǐng)求訪問,這樣就會(huì)進(jìn)入一直在 rewrite 的死循環(huán),訪問請(qǐng)求會(huì)一直被重寫成 http://www.kgc.com/weihu.html 再請(qǐng)求訪問
3、基于舊域名跳轉(zhuǎn)到新域名后面加目錄
現(xiàn)在訪問的是 http://bbs.kgc.com/post/,現(xiàn)在需要將這個(gè)域名下面的訪問都跳轉(zhuǎn)到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 跳轉(zhuǎn)到 http://www.kgc.com/bbs/post/1.html
4、基于參數(shù)匹配的跳轉(zhuǎn)
現(xiàn)在訪問http://www.kgc.com/100-(100|200)-100.html 跳轉(zhuǎn)到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:包含請(qǐng)求參數(shù)的原始URI,不包含主機(jī)名,如:http://www.kgc.com/abc/bbs/index.html?a=1&b=2 中的 /abc/bbs/index.php?a=1&b=2
- $uri:這個(gè)變量指當(dāng)前的請(qǐng)求URI,不包括任何參數(shù),如:/abc/bbs/index.html
- d o c u m e n t u r i :與 document_uri:與document
- u
- ri:與uri相同,這個(gè)變量指當(dāng)前的請(qǐng)求URI,不包括任何傳遞參數(shù),如:/abc/bbs/index.html
systemctl restart nginx
使用瀏覽器訪問 http://www.kgc.com/100-200-100.html 或 http://www.kgc.com/100-100-100.html 跳轉(zhuǎn)到http://www.kgc.com頁面。
5、基于目錄下所有 php 結(jié)尾的文件跳轉(zhuǎn)
要求訪問 http://www.kgc.com/upload/123.php 跳轉(zhuǎ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; location ~* /upload/.*\.php$ { rewrite (.+) http://www.kgc.com permanent; } location / { root html; index index.html index.htm; } } systemctl restart nginx
6、基于最普通一條 url 請(qǐng)求的跳轉(zhuǎn)
要求訪問一個(gè)具體的頁面如 http://www.kgc.com/abc/123.html 跳轉(zhuǎ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; 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 跳轉(zhuǎn)到http://www.kgc.com頁面。
到此這篇關(guān)于Nginx-rewrite模塊概述的文章就介紹到這了,更多相關(guān)Nginx-rewrite模塊內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Windows安裝nginx1.10.1反向代理訪問IIS網(wǎng)站
這篇文章主要為大家詳細(xì)介紹了Windows安裝nginx1.10.1反向代理訪問IIS網(wǎng)站的相關(guān)資料,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2016-11-11Nginx優(yōu)化配置和內(nèi)核優(yōu)化 實(shí)現(xiàn)突破十萬并發(fā)
Nginx是一個(gè)高性能的 HTTP 和 反向代理 服務(wù)器,也是一個(gè) IMAP/POP3/SMTP 代理服務(wù)器。本文介紹一些Nginx優(yōu)化代碼參數(shù)等2013-06-06Nginx日志中request_time和upstream_response_time區(qū)別
Nginx日志中的request_time和upstream_response_time是關(guān)鍵的性能指標(biāo),本文就來介紹一下Nginx日志中request_time和upstream_response_time區(qū)別,具有一定的參考價(jià)值,感興趣的可以了解一下2024-11-11nginx?ingress代理websocket流量的配置方法
ingress?nginx默認(rèn)支持websocket協(xié)議,使用長(zhǎng)連接協(xié)議時(shí)需要注意連接超時(shí)的設(shè)置,文中有提到讀取和發(fā)送超時(shí)的注解參數(shù),通過本文閱讀可以快速掌握,對(duì)nginx?ingress代理websocket相關(guān)知識(shí)感興趣的朋友一起看看吧2022-03-03Nginx gateway集群和動(dòng)態(tài)網(wǎng)關(guān)的實(shí)現(xiàn)思路
這篇文章主要介紹了Nginx gateway集群和動(dòng)態(tài)網(wǎng)關(guān),動(dòng)態(tài)網(wǎng)關(guān)即任何配置都實(shí)現(xiàn)不用重啟網(wǎng)關(guān)服務(wù)器都可以及時(shí)刷新,對(duì)Nginx gateway集群相關(guān)知識(shí)感興趣的朋友一起看看吧2022-10-10Nginx配置location匹配順序詳細(xì)總結(jié)
這篇文章主要介紹了Nginx配置location匹配順序詳解,Nginx是十分輕量級(jí)的HTTP服務(wù)器,Nginx憑借其穩(wěn)定性、低資源消耗、簡(jiǎn)單配置和豐富的功能,從十多年前名不見經(jīng)傳的Web服務(wù)器軟件,發(fā)展到如今能夠跟Apache匹敵的地位,需要的朋友可以參考下2023-08-08