2. 程式人生 > >前端開發掌握nginx常用功能之rewrite

前端開發掌握nginx常用功能之rewrite

阿新 • • 發佈：2019-02-08
cal index.php baidu www 當前 not acc 進行 由於

上一篇博文對nginx最常用功能的server及location的匹配規則進行了講解，這也是nginx實現控制訪問和反向代理的基礎。掌握請求的匹配規則算是對nginx有了入門，但是這些往往還是不能滿足實際的需求場景，例如請求url重寫、重定向等等，這都需要對請求的path進行修改操作的，匹配規則是不能獨自完成實際需求的，這就需要掌握nginx的另一個常用功能rewrite，下面就來說說這個常用功能。

Rewrite規則

rewrite功能就是，使用nginx提供的全局變量或自己設置的變量，結合正則表達式和標誌位實現url重寫以及重定向。
rewrite只能放在server{}, location{}

, if{} 中，並且只能對域名後邊傳遞的參數外的字符串起作用，例如 http://baidu.com/a/we/index.php?id=1&u=str 只對/a/we/index.php重寫。語法：

rewrite regex replacement [flag];

如果相對域名或參數字符串起作用，可以使用全局變量匹配，也可以使用proxy_pass反向代理。

表面上看rewrite和location功能有點像，都能實現跳轉，主要區別在於rewrite是在同一域名內更改獲取資源的路徑，而location是對一類路徑做控制訪問或反向代理，可以proxy_pass到其他機器。很多情況下rewrite也會寫在location裏，它們的執行順序是：

  • 執行server塊的rewrite指令
  • 執行location匹配
  • 執行選定的location中的rewrite指令

如果其中某步URI被重寫，則重新循環執行1-3，直到找到真實存在的文件；循環超過10次，則返回500 Internal Server Error錯誤。

2.1 flag標誌位

  • last : 停止執行當前ngx_http_rewrite_module的指令集，但是會繼續走一遍請求匹配對應server或者location；
  • break : 停止執行當前ngx_http_rewrite_module的指令集，請求就此完成。
  • redirect : 返回302臨時重定向，地址欄會顯示跳轉後的地址
  • permanent : 返回301永久重定向，地址欄會顯示跳轉後的地址

因為301和302不能簡單的只返回狀態碼，還必須有重定向的URL，這就是return指令無法返回301,302的原因了。

對於上面的flag，有幾點需要強調一下：

  • last與break對url的重寫不會改變地址欄的地址

也就是說，nginx雖然對請求url進行了重寫，但是地址欄不會有任何明顯的改變，仍然顯示nginx重寫前的地址；這與redirect和permanent不同。

  • last與break的處理策略不同

二者都會終止當前ngx_http_rewrite_module的指令集的執行，但是 last 立即發起新一輪的 請求匹配 而 break 則不會。

  • redirect和permanent會終止後續nginx指令的執行

nginx在rewrite遇到flag是二者時，後續的指令是不會執行的。

server {
    listen 8080;
    location = /test {
        break;
        return 200 $request_uri;
        proxy_pass http://127.0.0.1:8080/other;
    }
    location / {
        return 200 $request_uri;
    }
}

上面例子中，我們訪問 curl 127.0.0.1:8080/test，會發現，return 200 $request_uri語句沒有執行，而proxy_pass指令被執行了。這是因為：

return指令屬於ngx_http_proxy_module模塊，它會被break終止掉；而rewrite模塊它是ngx_http_proxy_module的指令，不會被break給中斷掉。

2.2 if指令與全局變量

if判斷指令
語法為if(condition){...} ，對給定的條件condition進行判斷。如果為真，大括號內的rewrite指令將被執行，if條件(conditon)可以是如下任何內容：

  • 當表達式只是一個變量時，如果值為空或任何以0開頭的字符串都會當做false
  • 直接比較變量和內容時，使用=或!=
  • ~正則表達式匹配，~*不區分大小寫的匹配，!~區分大小寫的不匹配

-f和!-f用來判斷是否存在文件
-d和!-d用來判斷是否存在目錄
-e和!-e用來判斷是否存在文件或目錄
-x和!-x用來判斷文件是否可執行

例如：

if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
} //如果UA包含"MSIE"，rewrite請求到/msid/目錄下

if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
    set $id $1;
 } //如果cookie匹配正則，設置變量$id等於正則引用部分

if ($request_method = POST) {
    return 405;
} //如果提交方法為POST，則返回狀態405（Method not allowed）。return不能返回301,302

if ($slow) {
    limit_rate 10k;
} //限速，$slow可以通過 set 指令設置

if (!-f $request_filename){
    break;
    proxy_pass  http://127.0.0.1;
} //如果請求的文件名不存在，則反向代理到localhost 。這裏的break也是停止rewrite檢查

if ($args ~ post=140){
    rewrite ^ http://example.com/ permanent;
} //如果query string中包含"post=140"，永久重定向到example.com

location ~* \.(gif|jpg|png|swf|flv)$ {
    valid_referers none blocked www.jefflei.com www.leizhenfang.com;
    if ($invalid_referer) {
        return 404;
    } //防盜鏈
}

全局變量

下面是可以用作if判斷的全局變量:

  • $args ： #這個變量等於請求行中的參數，同$query_string
  • $content_length ： 請求頭中的Content-length字段。
  • $content_type ： 請求頭中的Content-Type字段。
  • $document_root ： 當前請求在root指令中指定的值。
  • $host ： 請求主機頭字段，否則為服務器名稱。
  • $http_user_agent ： 客戶端agent信息
  • $http_cookie ： 客戶端cookie信息
  • $limit_rate ： 這個變量可以限制連接速率。
  • $request_method ： 客戶端請求的動作，通常為GET或POST。
  • $remote_addr ： 客戶端的IP地址。
  • $remote_port ： 客戶端的端口。
  • $remote_user ： 已經經過Auth Basic Module驗證的用戶名。
  • $request_filename ： 當前請求的文件路徑，由root或alias指令與URI請求生成。
  • $scheme ： HTTP方法（如http，https）。
  • $server_protocol ： 請求使用的協議，通常是HTTP/1.0或HTTP/1.1。
  • $server_addr ： 服務器地址，在完成一次系統調用後可以確定這個值。
  • $server_name ： 服務器名稱。
  • $server_port ： 請求到達服務器的端口號。
  • $request_uri ： 包含請求參數的原始URI，不包含主機名，如：”/foo/bar.php?arg=baz”。
  • $uri ： 不帶請求參數的當前URI，$uri不包含主機名，如”/foo/bar.html”。
  • $document_uri ： 與$uri相同。

例如：

例：http://localhost:88/test1/test2/test.php
$host：localhost
$server_port：88
$request_uri：http://localhost:88/test1/test2/test.php
$document_uri：/test1/test2/test.php
$document_root：/var/www/html
$request_filename：/var/www/html/test1/test2/test.php

2.3 常用正則

  • . ： 匹配除換行符以外的任意字符
  • ? ： 重復0次或1次
  • + ： 重復1次或更多次
  • * ： 重復0次或更多次
  • \d ：匹配數字
  • ^ ： 匹配字符串的開始
  • $ ： 匹配字符串的結束
  • {n} ： 重復n次
  • {n,} ： 重復n次或更多次
  • [c] ： 匹配單個字符c
  • [a-z] ： 匹配a-z小寫字母的任意一個

小括號()之間匹配的內容，可以在後面通過$1來引用，$2表示的是前面第二個()裏的內容。正則裏面容易讓人困惑的是\轉義特殊字符。

2.4 rewrite實例

例1：

http {
    # 定義image日誌格式
    log_format imagelog ‘[$time_local] ‘ $image_file ‘ ‘ $image_type ‘ ‘ $body_bytes_sent ‘ ‘ $status;
    # 開啟重寫日誌
    rewrite_log on;

    server {
        root /home/www;

        location / {
                # 重寫規則信息
                error_log logs/rewrite.log notice;
                # 註意這裏要用‘’單引號引起來，避免{}
                rewrite ‘^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$‘ /data?file=$3.$4;
                # 註意不能在上面這條規則後面加上“last”參數，否則下面的set指令不會執行
                set $image_file $3;
                set $image_type $4;
        }

        location /data {
                # 指定針對圖片的日誌格式，來分析圖片類型和大小
                access_log logs/images.log mian;
                root /data/images;
                # 應用前面定義的變量。判斷首先文件在不在，不在再判斷目錄在不在，如果還不在就跳轉到最後一個url裏
                try_files /$arg_file /image404.html;
        }
        location = /image404.html {
                # 圖片不存在返回特定的信息
                return 404 "image not found\n";
        }
}

對形如/images/ef/uh7b3/test.png的請求，重寫到/data?file=test.png，於是匹配到location /data，先看/data/images/test.png文件存不存在，如果存在則正常響應，如果不存在則重寫tryfiles到新的image404 location，直接返回404狀態碼。

例2：

rewrite ^/images/(.*)_(\d+)x(\d+)\.(png|jpg|gif)$ /resizer/$1.$4?width=$2&height=$3? last;

對形如/images/bla_500x400.jpg的文件請求，重寫到/resizer/bla.jpg?width=500&height=400地址，並會繼續嘗試匹配location。

例3：
見 ssl部分頁面加密 。

2.5 rewrite需要註意的問題

上面說過，rewrite的指令規則為：rewrite regex replacement [flag];

rewrite指令用指定的regex來匹配請求的uri，若匹配成功則用replacement來重寫請求uri。這裏需要註意的replacement字符串的內容：

1、 若replacement以http://、https://或者$scheme開頭，則告訴nginx這是重定向操作(flag默認為redirect)，nginx則停止處理後續內容，並直接重定向返回給客戶端。

location / {
    # 當匹配 正則表達式 /test/(.*)時 請求將被臨時重定向到 http://www.baidu.com/$1
    # flag默認為redirect
    rewrite /test/(.*) https://www.baidu.com/$1;
    return 200 ’ok‘; # 此處沒有機會執行
}

2、replacement非以上三種情況開頭，則就是簡單的url重寫

location / {
    # 當匹配 正則表達式 /test/(.*)時 請求將被臨時重定向到 www.baidu.com/$1
    # flag無值則rewrite會順序執行
    rewrite /test/(.*) www.baidu.com/$1;
    return 200 ’ok‘; # 此處因為rewrite順序執行而得到執行機會
}

對於上面兩種情況，還需要特別留意一個redirect端口的問題，先上一個例子：

## server.com機器上nginx的配置如下：
server {
    listen 8000;
    location /test1/ {
    rewrite /test1/index.html http://server1.com/demo/test1 redirect;
    }
    location /test2/ {
    rewrite /test2/index.html /demo/test2 redirect;
        proxy_pass http://192.168.1.3:8000;
    }
}

當訪問http://server.com/test1/index.html時，會命中/test1的location規則，訪問server1.com對應內容一直失敗，發現重定向後響應頭的Location字段值為http://server1.com:8000/demo/test1，帶有8000端口，我們並沒有配置，表現的比較詭異？

訪問http://server.com/test2/index.html時，命中/test2的location規則，同樣訪問失敗，但是訪問的重定向後響應頭Location字段值為http://server.com:8000/demo/test2，其帶有server.com的server_name和8000的端口，更加詭異？

看到上面的現象，疑惑重重；其實這跟nginx的server_name_in_redirect和port_in_redirect指令有關:

在絕對路徑中，server_name_in_redirect 和port_in_redirect 指令表示是否將server塊中的 server_name 和 listen 的端口作為redirect用, 重定向的完整url地址根據$scheme跟server_name_in_redirect和port_in_redirect來確定的。

在絕對路徑中，server_name_in_redirect默認是禁用的，而port_in_redirect是默認啟用的。對於帶有$scheme重定向的絕對路徑，nginx會從replacement中獲取指定的server_name和port來進行重定向：

第一種，若replacement帶請求協議http(s)，而其中沒有指定port的話，nginx會默認取當前server的listen端口作為重定向的端口。這是上面訪問http://server.com/test1/index.html時重定向到http://server.com:8000/demo/test2時會攜帶8000的原因。

第二種，若replacement不帶請求協議http(s)，而是相對本地服務器的絕對地址的話，如上面訪問http://server.com/test2/index.html的情況，此時server_name_in_redirect由於禁用它會去請求的host來作為server_name，取當前server的listen端口作為重定向的端口，最終重定向到http://server.com:8000/demo/test2。

或許你會問，訪問http://server.com/test2/index.html為什麽不會重定向到http://192.168.1.3:8000/demo/test2上？這是因為rewrite的redirect flag會終止後續指令的執行，所以其後的proxy_pass指令不會執行。

參考

  • http://www.nginx.cn/216.html
  • http://www.ttlsa.com/nginx/nginx-rewriting-rules-guide/
  • https://segmentfault.com/a/1190000008102599

前端開發掌握nginx常用功能之rewrite

相關推薦

前端開發掌握nginx常用功能之rewrite

cal index.php baidu www 當前 not acc 進行 由於 上一篇博文對nginx最常用功能的server及location的匹配規則進行了講解，這也是nginx實現控制訪問和反向代理的基礎。掌握請求的匹配規則算是對nginx有了入門，但是這些往往還是

Android App開發常用功能之使用者頭像選擇

前言 現在的APP基本都有個人資料的填寫，基本的都有頭像的選擇，支援拍照和從本地相簿選擇，剪下圓形頭像的功能，現在用個小demo實現以下。 下面看一下效果圖 上程式碼： 主介面程式碼 package com.example.androidpersonal_icon; i

Nginx常用功能配置及優化

nginx web服務器 優化----------------------------------------------------------------------------------------規範優化Nginx配置文件：--------------------------------------

前端開發的一些常用資源

1、顏色拾取器：FastStone Capture 2、打包好的圖表（echartsjs）：http://www.echartsjs.com/examples/ 3、座標拾取器（騰訊地圖）：https://lbs.qq.com/tool/getpoint/ 4、thinkPHP 5.0(

nginx常用功能全揭祕(內附福利~~)

本文旨在用最通俗的語言講述最枯燥的基本知識 nginx作為一個高效能的web伺服器，想必大家垂涎已久，蠢蠢欲動，想學習一番了吧，語法不多說，網上一大堆。下面博主就nginx的非常常用的幾個功能做一些講述和分析，學會了這幾個功能，平常的開發和部署就不是什麼問題了。因此希

python——常用功能之文字處理

前言 在生活、工作中，python一直都是一個好幫手。在python的眾多功能中，我覺得文字處理是最常用的。下面是平常使用中的一些總結。環境是python 3.3 0. 基礎 在python中，使用str物件來儲存字串。str物件的建立很簡單，使用單引號或雙引號或3個單引號即

移動web前端開發，頁面區域性滑動之iscroll框架

先看個簡單的，移動裝置上，橫向滑動內容塊的例子： <head> <style> body,ul,li { padding:10px; margin:0; } body { font-size:12px; -webkit-user-sel

分享一些前端開發中最常用的JS程式碼片段~ 乾貨~

HTML5 DOM 選擇器 // querySelector() 返回匹配到的第一個元素 var item = document.querySelector('.item'); console.log(item); // querySelectorAll()

前端開發專案中 常用到的 方法（整理）

前端開發專案中 常用到的 方法 1. 獲取URL引數 function getUrlParam(name) { var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)");

5.8 Nginx 常用功能的配置

技術 src nginx 配置 分享圖片 功能 inf ima gin 5.8 Nginx 常用功能的配置

前端開發 sublime text 常用外掛和配置

前端開發sublimeconfig mac配置 此檔案目錄中檔案主要是關於sublime的外掛配置，快捷鍵配置，主題和字型配置。 外掛列表 所有外掛都可以使用Package Control安裝，具體的安裝方法可以自行谷歌安裝，不在本文的介紹範圍之

五年幹貨分享！前端開發中最常用的JS代碼片段

click 以及 方法 格式化 mouse web cti inpu repl 很多網友私信我，說學到js就開始卡殼了，甚至初略的看了一下js，就跳過開始學習框架之類的。這裏要提醒你，js是前端的重中之重，如果你忽視了，後果不堪設想！ 學好，並熟練的運用這門編程語言真的很難

Nginx 之四： Nginx服務器的rewrite、全局變量、重定向和防盜鏈相關功能

war int 服務器驗證 %u 寫日誌 防盜鏈 循環 版本 算法 一：Nginx 後端服務器組的配置： 1、upstream： 用於設置後端服務器組的主要指令，upstream類似於之前的server塊或http塊，用法如下： upstreame Myserve

（持續更新）瀏覽器兼容性總結—之前端開發常用屬性及api

ott 內置 事件 move min-width line 顏色漸變效果 瀏覽器兼容性 :hover max-width，min-width ie7以上支持 rgba 只支持ie9及以上瀏覽器，ie8要用濾鏡處理 border-radius 也只支持ie9以上 不需

前端開發之常用插件

兼容 time epic 封裝 targe ots 顯示時間 下拉框 blank 　　在日常開發的時候,尤其在使用一些常用功能的時候,例如:時間選擇,文件上傳,下拉框等功能.自己寫當然也是可以,但是有好用的插件為什麽不使用呢?還要自己封裝解決各種兼容性問題... 　　在此

前端開發框架總結之利用Jtopo實現網路拓撲功能（四）

                     前端開發框架總結之利用Jtopo實現網路拓撲功能（四） 上文我們講了拓撲容器相關的互動設計和實現思路以及一些關鍵技術細節。至此，我們已經覆蓋了結

前端開發框架總結之利用Jtopo實現網路拓撲功能（三）

                     前端開發框架總結之利用Jtopo實現網路拓撲功能（三） 上文我們講了一些拓撲連線、拓撲文字節點相關的互動設計和實現思路以及一些關鍵技術細節。本文

前端開發框架總結之利用Jtopo實現網路拓撲功能（二）

                    前端開發框架總結之利用Jtopo實現網路拓撲功能（二） 上文我們講了一些拓撲結點生成的實際場景設計和實現思路以及一些關鍵技術細節。本文我們繼續我們的拓撲管理

前端開發框架總結之利用Jtopo實現網路拓撲功能（一）

                      前端開發框架總結之利用Jtopo實現網路拓撲功能（一） 前言：     前段時間由於專案需要實現一個網路裝置拓撲管理的

部落格專案之前端開發—註冊功能實現

1、前端註冊功能實現 　　在service/user.js中增加reg註冊函式 　　　　 1 import axios from "axios" 2 import { observable } from "mobx"; 3 import store from 'store' 4