Nginx之rewrite實(shí)現(xiàn)URL重寫方式
1.開篇
rewrite是nginx服務(wù)器提供的一個(gè)重要功能，用于實(shí)現(xiàn)URL的重寫。
例如我們?cè)L問https://aa.qq.com，打開的是https://age.qq.com/，這就是使用URL重寫的特性來實(shí)現(xiàn)的。
ngx_http_rewrite_module為實(shí)現(xiàn)URL重寫提供了指令支持。
官方文檔地址：https://nginx.org/en/docs/http/ngx_http_rewrite_module.html
接下來我們來看看rewrite的相關(guān)指令。
2.rewrite相關(guān)指令
2.1 set指令
作用域：server, location, if
語法：set $variable value;
該指令可以設(shè)置一個(gè)變量。
$variable：為變量的名稱，可以看到變量的名稱以$符號(hào)開頭，且不要與nginx預(yù)設(shè)的全局變量名相同。value：為變量的值，可以是字符串、其他變量或者兩者的組合。
既然自定義的變量名不能與nginx的全局變量名相同，那就有必要了解使用rewrite功能時(shí)常用的nginx全局變量。
rewrite常用全局變量
| 全局變量 | 說明 |
|---|---|
| $args | 用于獲取請(qǐng)求中的參數(shù)。例如：http://192.168.110.92/test?name=tom&age=18，$args的值就為name=tom&age=18 |
| $host | 用于獲取請(qǐng)求中的主機(jī)部分的值。例如：http://192.168.110.92/test?name=tom&age=18，$host的值為192.168.110.92。 |
| $http_user_agent | 用于獲取請(qǐng)求中的User-Agent字段值 |
| $remote_addr | 用于獲取客戶端的IP地址 |
| $remote_port | 用于獲取客戶端與服務(wù)器建立連接的端口號(hào) |
| $request_method | 用于獲取客戶端的請(qǐng)求方式，例如GET、POST等 |
| $request_uri | 用于獲取當(dāng)前請(qǐng)求的URI。例如：http://192.168.110.92/test?name=tom&age=18，$request_uri的值就為/test?name=tom&age=18 |
| $query_string | 與$args作用相同 |
| $scheme | 用于獲取客戶端請(qǐng)求使用的協(xié)議，例如http、https等 |
| $server_addr | 用于獲取服務(wù)端的IP地址 |
| $server_name | 用于獲取虛擬主機(jī)的名稱 |
| $server_port | 用于獲取虛擬主機(jī)的監(jiān)聽的端口 |
| $document_uri | 用于獲取請(qǐng)求中的當(dāng)前URI。例如：http://192.168.110.92/test?name=tom&age=18，$document_uri的值為/test |
| $uri | 與$document_uri作用相同 |
| $http_user_agent | 用于獲取請(qǐng)求頭中User-Agent字段的值 |
| $request_filename | 當(dāng)前請(qǐng)求的文件路徑 |
下面我們?cè)O(shè)置自定義變量，順便體驗(yàn)使用一下這些全局變量。
location /test {
default_type text/html;
set $username zhangsan;
return 200 <html>><p>username:$username</p><p>request_uri:$request_uri</p><p>document_uri:$document_uri</p><p>uri:$uri</p><p>query_string:$query_string</p><p>args:$args</p></html>;
}發(fā)起請(qǐng)求：http://192.168.110.98/test?name=tom
2.2 if指令
作用域：server, location
語法：if (condition) { … }
如果條件表達(dá)式為true，則執(zhí)行該模塊大括號(hào)中的指令。
Tips：if和(之間有一個(gè)空格。
條件表達(dá)式有幾種形式：
1）變量名，如果變量的值為空字符串或"0"，則為false，其他條件為true。
if ($variable){
}2）使用"=“和”!="比較變量和字符串是否相等，滿足條件則為true，否則為false。
if ($request_method = POST){
}3）使用正則表達(dá)式與變量的值進(jìn)行匹配。變量與正則表達(dá)式之間使用~、~*、!~、!~*，如果正則表達(dá)式包含}或;，則整個(gè)表達(dá)式應(yīng)該用單引號(hào)或雙引號(hào)括起來。
~：表示匹配正則表達(dá)式，區(qū)分大小寫~*：表示匹配正則表達(dá)式，不區(qū)分大小寫!~：表示匹配正則表達(dá)式，區(qū)分大小寫，并對(duì)匹配后的結(jié)果取反!~*：表示匹配正則表達(dá)式，不區(qū)分大小寫，并對(duì)匹配后的結(jié)果取反
if ($http_user_agent ~ Mozilla/5.0){
}4）判斷文件是否存在：-f和!-f
if (-f $request_filename){
}
if (!-f $request_filename){
}示例：
location /test {
default_type text/html;
if (!-f $request_filename){
return 200 "<h1>file not exist</h1>";
}
root html;
}我們已經(jīng)在html目錄下準(zhǔn)備了一個(gè)test.html。
訪問http://192.168.110.98/test.html，可以正常顯示。
訪問http://192.168.110.98/test，因?yàn)槲募淮嬖冢詧?zhí)行if條件塊的指令。
5）判斷目錄是否存在：-d和!-d
6）判斷文件、目錄或符號(hào)鏈接是否存在：-e和!-e
7）判斷文件是否可以執(zhí)行：-x和!-x
2.3 break指令
作用域：server, location, if;
語法：break;
在同一作用域中，中斷該指令之后的其他指令，位于其前面的指令配置生效，位于其后面的指令配置則無效。
示例：如果URL中存在參數(shù)，則執(zhí)行if邏輯。
location /testBreak {
default_type text/plain;
set $username lisi;
if ($args){
set $username wangwu;
break;
set $username zhaoliu;
}
add_header username $username;
return 200 $username;
}訪問http://192.168.110.98/testBreak，指令都正常執(zhí)行。
訪問http://192.168.110.98/testBreak?name=zhangsan，說明執(zhí)行了if邏輯。
按break;語句的定義來說，在其執(zhí)行后，其作用域外后面的指令應(yīng)該正常執(zhí)行才對(duì)，但是這里直接返回了404。這個(gè)時(shí)候，就需要我們查看error.log。
可以發(fā)現(xiàn)，錯(cuò)誤提示為文件未找到，根據(jù)錯(cuò)誤提示，我們需要在html目錄下創(chuàng)建一個(gè)testBreak目錄，然后在testBreak目錄下創(chuàng)建一個(gè)index.html文件
cd /usr/local/nginx
mkdir testBreak
vim index.html
<html>
<body>this is testBreak</body>
</html>再次訪問http://192.168.110.98/testBreak?name=zhangsan，可以看到break語句執(zhí)行后，其作用域外后面的指令正常執(zhí)行。
2.4 return指令
作用域：
server,location,if
語法：
return code [text];return code URL;return URL;
該指令可以停止處理并指定的響應(yīng)碼返回給前端。既可以返回文本，也可以重定向URL。
示例：
location /testReturn {
default_type text/plain;
return 200 "test return";
}location /testReturn {
return 302 https://www.baidu.com;
}location /testReturn {
return https://www.baidu.com;
}2.5 rewrite指令
在了解set、if、break、return指令后，重頭戲rewrite指令登場(chǎng)。
作用域：server, location, if;
語法：rewrite regex replacement [flag];
regex：用來匹配URI的正則表達(dá)式。replacement：正則匹配成功后，用來替換URI的字符串。如果該字符串以http://、https://或$scheme開頭，則處理將停止，并重定向URI到客戶端。flag：是一個(gè)可選參數(shù)，其有4個(gè)候選值。
| flag值 | 說明 |
|---|---|
| last | 停止處理rewrite指令，并使用重寫的URI去與各個(gè)location進(jìn)行匹配 |
| break | 停止處理rewrite指令，與break;效果一致 |
| redirect | 如果replacement字符串不是以http://、https://或$scheme開頭，則重定向到重寫的URI，響應(yīng)碼為302 |
| permanent | 重定向到重寫的URI，響應(yīng)碼為301 |
rewrite指令通過正則表達(dá)式匹配URI，并修改URI?？赏瑫r(shí)存在多個(gè)rewrite指令，按照順序依次對(duì)URI進(jìn)行匹配和處理。
示例：
location /rewrite {
rewrite ^/rewrite/aaa\w+$ https://www.baidu.com;
rewrite ^/rewrite/(bbb)\w+$ /$1 last;
rewrite ^/rewrite/(ccc)\w+$ /$1 break;
rewrite ^/rewrite/(ddd)\w+$ /$1 redirect;
rewrite ^/rewrite/(eee)\w+$ /$1 permanent;
}
location /bbb {
default_type text/plain;
return 200 "this is bbb";
}
location /ccc {
default_type text/plain;
return 200 "this is ccc";
}
location /ddd {
default_type text/plain;
return 200 "this is ddd";
}
location /eee {
default_type text/plain;
return 200 "this is eee";
}2.6 rewrite_log指令
作用域：http, server, location, if
語法：rewrite_log on | off;
默認(rèn)值：rewrite_log off;
該指令可以配置是否將ngx_http_rewrite_module指令的處理結(jié)果以notice級(jí)別的日志寫入到error_log中。
示例：
location /rewrite {
# 開啟rewrite_log
rewrite_log on;
# 配置error_log
error_log logs/error.log notice;
rewrite ^/rewrite/aaa\w+$ https://www.baidu.com;
rewrite ^/rewrite/(bbb)\w+$ /$1 last;
rewrite ^/rewrite/(ccc)\w+$ /$1 break;
rewrite ^/rewrite/(ddd)\w+$ /$1 redirect;
rewrite ^/rewrite/(eee)\w+$ /$1 permanent;
}這樣我們就可以在error.log中看到notice級(jí)別的日志。
3.使用場(chǎng)景
在熟悉了ngx_http_rewrite_module的相關(guān)指令后，我們來看看rewrite的相關(guān)使用場(chǎng)景。
3.1 域名重定向
**場(chǎng)景：**公司官網(wǎng)上線的時(shí)候地址為www.aaa.com，隨著公司的不斷發(fā)展，需要將官網(wǎng)地址升級(jí)為www.bbb.com，但是需要在訪問www.aaa.com能夠自動(dòng)跳轉(zhuǎn)到www.bbb.com。
Tips：www.aaa.com和www.bbb.com需要指向同一IP。
**解決方案：**使用rewrite指令重寫URI。
server {
listen 80;
server_name www.aaa.com;
rewrite ^(.*) https://www.bbb.com$1;
}3.2 優(yōu)雅處理防盜鏈
前面我們?cè)凇綨ginx靜態(tài)資源防盜鏈】一文中已經(jīng)簡單的實(shí)現(xiàn)了靜態(tài)資源的防盜鏈，但是展示在頁面的是一個(gè)裂開的小圖片，不夠美觀。
我們可以如下配置：
location ~^/.*\.(jpg|jpg|gif|jfif) {
valid_referers www.example.com;
if ($invalid_referer){
rewrite ^/ http://192.168.110.98/images/forbidden.jpg;
}
root html;
}如果出現(xiàn)盜鏈的情況，將會(huì)出現(xiàn)類似于如下效果：
總結(jié)
以上就是Nginx之rewrite實(shí)現(xiàn)URL重寫，Nginx是多模塊化的，還有很多高級(jí)功能，我們后面繼續(xù)探索。
這些僅為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。
相關(guān)文章
這篇文章主要介紹了如何本地安裝nginx及部署項(xiàng)目問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-12-12
nginx搭建IPv6 -＞IPv4反向代理服務(wù)器的實(shí)現(xiàn)
本文主要介紹了nginx搭建IPv6 -＞IPv4反向代理服務(wù)器的實(shí)現(xiàn),文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2025-05-05
Nginx配置https原理及實(shí)現(xiàn)過程詳解
這篇文章主要介紹了Nginx配置https原理及實(shí)現(xiàn)過程詳解,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-09-09
這篇文章主要給大家介紹了關(guān)于Nginx輕松搞定跨域問題的相關(guān)資料,大家在使用nginx進(jìn)行服務(wù)器管理，經(jīng)常會(huì)遇到跨域問題,文中將解決方法介紹的非常詳細(xì),需要的朋友可以參考下2023-08-08
這篇文章主要介紹了nginx禁止訪問.git文件的設(shè)置教程,.git文件會(huì)包含一份文件列表,如果你的網(wǎng)站是基于git協(xié)作開發(fā)的,則必須要注意這個(gè)問題,需要的朋友可以參考下2014-08-08
Nginx實(shí)現(xiàn)動(dòng)靜分離的示例代碼
這篇文章主要介紹了Nginx實(shí)現(xiàn)動(dòng)靜分離的示例代碼，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-01-01
Nginx限制某個(gè)IP同一時(shí)間段的訪問次數(shù)和請(qǐng)求數(shù)示例代碼
nginx可以通過ngx_http_limit_conn_module和ngx_http_limit_req_module配置來限制ip在同一時(shí)間段的訪問次數(shù).具體示例代碼大家參考下本文2017-08-08
本文主要介紹了Nginx可視化配置工具NginxWebUI的使用，可以使用?WebUI?配置?Nginx?的各項(xiàng)功能，包括端口轉(zhuǎn)發(fā)，反向代理，ssl?證書配置，負(fù)載均衡等，感興趣的可以了解一下2022-01-01
Nginx列出目錄和文件并用密碼控制訪問權(quán)限配置方法
這篇文章主要介紹了Nginx列出目錄和文件并用密碼控制訪問權(quán)限配置方法,本文給出了詳細(xì)的安裝配置步驟,需要的朋友可以參考下2015-07-07
nginx 作為反向代理實(shí)現(xiàn)負(fù)載均衡的例子
以下我們就來舉例說明如何使用 nginx 實(shí)現(xiàn)負(fù)載均衡。因?yàn)閚ginx在處理并發(fā)方面的優(yōu)勢(shì)，現(xiàn)在這個(gè)應(yīng)用非常常見。2010-12-12