Nginx-rewrite模塊概述
前言
現(xiàn)在 Nginx 已經(jīng)成為很多公司作為前端反向代理 (proxy pass) 服務(wù)器的首選,在實際工作中往往會遇到很多跳轉(zhuǎn)(重寫URL)的需求。比如,更換域名后需要保持舊的域名能跳轉(zhuǎn)到新的域名上、某網(wǎng)頁發(fā)生改變需要跳轉(zhuǎn)到新的頁面、網(wǎng)站防盜鏈等等需求。如果在后端使用的Apache服務(wù)器,雖然也能做跳轉(zhuǎn),規(guī)則庫也很強大,但是用 Nginx 跳轉(zhuǎn)效率會更高。
一、Nginx-rewrite模塊概述
從功能上看 rewrite 和 location 似乎有點像,都能實現(xiàn)跳轉(zhuǎn),主要區(qū)別在于 rewrite 是在同一域名內(nèi)更改獲取資源的路徑,而 location 是對一類路徑做控制訪問或反向代理,還可以proxy_pass 到其他機器。
- rewrite:對訪問的域名或者域名內(nèi)的URL路徑地址重寫
- location:對訪問的路徑做訪問控制或者代理轉(zhuǎn)發(fā)
1、rewrite場景
- 調(diào)整用戶瀏覽的URL,看起來更規(guī)范,合乎開發(fā)及產(chǎn)品人員的請求。
- 為了讓搜索引擎搜錄網(wǎng)站內(nèi)容及用戶體驗更好,企業(yè)會將動態(tài)URL地址偽裝成靜態(tài)地址提供服務(wù)。
- 網(wǎng)址換新域名后,讓舊域名訪問跳轉(zhuǎn)到新域名訪問。例如訪問京東的360buy.com會跳轉(zhuǎn)到j(luò)d.com。
- 服務(wù)端某些業(yè)務(wù)的調(diào)整,比如根據(jù)特殊變量、目錄、客戶端的信息進(jìn)行URL調(diào)整等
2、rewrite實現(xiàn)
- Nginx是通過ngx_http_rewrite_module模塊支持URL重寫、支持if條件判斷,但不支持else。
- 該模塊需要PCRE支持,應(yīng)在編譯Nginx時指定PCRE支持,默認(rèn)已經(jīng)安裝。根據(jù)相關(guān)變量重定向和選擇不同的配置,從一個location跳轉(zhuǎn)到另一個location,不過這樣的循環(huán)最多可以執(zhí)行10次,超過Nginx將返回500錯誤。
- PCRE支持:perl兼容正則表達(dá)式的語法規(guī)則匹配
- 同時,重寫模塊包括set指令,來創(chuàng)建新的變量并設(shè)其值,這在有些情境下非常有用的,如記錄條件標(biāo)識、傳遞參數(shù)到其他location、記錄做了什么等等。
- rewrite功能就是,使用Nginx提供的全局變量或自己設(shè)置的變量,結(jié)合正則表達(dá)式和標(biāo)志位實現(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臨時重定向,瀏覽器地址會顯示跳轉(zhuǎn)后的URL地址。
- permanent :返回301永久重定向,瀏覽器地址欄會顯示跳轉(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全局變量,代表請求主機頭字段或主機名
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(雖然這個請求內(nèi)容是不存在的)
會跳轉(zhuǎn)到www.benet.com/test/1.html,查看元素可以看到返回301,實現(xiàn)了永久重定向跳轉(zhuǎn),而且域名后的參數(shù)也正常跳轉(zhuǎn)。


2、基于客戶端IP訪問跳轉(zhuǎn)
今天公司業(yè)務(wù)新版本上線,要求所有 IP 訪問任何內(nèi)容都顯示一個固定維護頁面,只有公司 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è)為false,不進(jìn)行重寫
set $rewrite false;
}
#除了合法IP,其它都是非法IP,進(jìn)行重寫跳轉(zhuǎn)維護頁面
if ($rewrite = true){ #當(dāng)變量值為true時,進(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 能正常訪問,其它地址都是維護頁面
如果rewrite (.+) /weihu.html; 換成rewrite (.+) /weihu.html permanent; 的話,若不是 192.168.80.10 的主機訪問會使瀏覽器修改請求訪問的 URL 成 http://www.kgc.com/weihu.html 再請求訪問,這樣就會進(jìn)入一直在 rewrite 的死循環(huán),訪問請求會一直被重寫成 http://www.kgc.com/weihu.html 再請求訪問


3、基于舊域名跳轉(zhuǎn)到新域名后面加目錄
現(xiàn)在訪問的是 http://bbs.kgc.com/post/,現(xiàn)在需要將這個域名下面的訪問都跳轉(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:包含請求參數(shù)的原始URI,不包含主機名,如:http://www.kgc.com/abc/bbs/index.html?a=1&b=2 中的 /abc/bbs/index.php?a=1&b=2
- $uri:這個變量指當(dāng)前的請求URI,不包括任何參數(shù),如:/abc/bbs/index.html
- d o c u m e n t u r i :與 document_uri:與document
- u
- ri:與uri相同,這個變量指當(dā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 請求的跳轉(zhuǎn)
要求訪問一個具體的頁面如 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)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Nginx實現(xiàn)不同域名輸出不同的服務(wù)器頭信息方法
這篇文章主要介紹了Nginx實現(xiàn)不同域名輸出不同的服務(wù)器頭信息方法,本文使用了一個ngx_headers_more模塊實現(xiàn)這個特殊需求,需要的朋友可以參考下2015-02-02
Prometheus 和 Grafana 通過nginx-exporter監(jiān)控nginx的
nginx-exporter 是 Prometheus 用來從 Nginx 收集指標(biāo)的組件,這篇文章給大家介紹Prometheus 和 Grafana 通過nginx-exporter監(jiān)控nginx的詳細(xì)步驟,感興趣的朋友跟隨小編一起看看吧2024-08-08
Nginx?map?實現(xiàn)時間格式轉(zhuǎn)換的方法
最近我們需要把?Nginx?的日志接入到自研的日志采集平臺上,但是這個平臺只支持?JSON?格式,所以需要把?Nginx?日志格式改成?JSON?格式,這篇文章主要介紹了Nginx?map?實現(xiàn)時間格式轉(zhuǎn)換,需要的朋友可以參考下2023-09-09
Nginx 1.28.0 源碼編譯安裝與自定義網(wǎng)頁部署詳細(xì)指南
本文介紹了Nginx1.28.0的安裝過程,提供了自定義HTML文件部署步驟、安裝后核心目錄說明、常用管理命令、部署前端項目示例等內(nèi)容,感興趣的朋友跟隨小編一起看看吧2026-05-05
nginx設(shè)置上傳目錄無執(zhí)行權(quán)限的方法
在windows+iis下,可以設(shè)置上傳目錄,類似:upload,uploadfile,attachments,這樣的目錄下面無腳本執(zhí)行權(quán)限,從而防止非法用戶上傳腳本得到webshell2010-11-11

