Edge Security Acceleration：重寫URL

執行流程

1. 判斷是否命中緩衝：使用者請求到達ESA邊緣節點，ESA根據使用者請求的原始URL尋找緩衝，如果緩衝未命中，ESA執行URL重寫規則，將原始URL修改為目標URL。

2. 未命中緩衝時使用改寫後的URL回源：ESA使用重寫後的URL向來源站點請求資源，來源站點響應並將請求內容緩衝至ESA，ESA根據原始URL作為緩衝鍵進行緩衝。

3. 返回緩衝內容至用戶端：ESA將緩衝內容返回至用戶端。

執行順序

重寫URL在快取命中判斷之後、實際回源請求發起之前執行。其執行順序晚於來源站點選擇規則，但早於回源要求標頭修改規則，確保在確定來源站點目標後對請求路徑進行靈活調整，同時不影響後續頭部處理邏輯。

樣本一：來源站點路徑遷移

• 情境：來源站點將圖片從/images/目錄遷移至/static/img/目錄。

• 匹配條件：starts_with(http.request.uri.path, "/images/")

• 重寫配置：

  • 重寫對象：路徑

  • 操作方式：動態

  • 運算式：regex_replace(http.request.uri.path, "^/images/", "/static/img/")

• 重寫效果：

  • 使用者請求：https://example.com/images/logo.png

  • 回源請求：https://origin.com/static/img/logo.png

樣本二：API版本適配

• 情境：將所有對舊版API/api/v1/的請求，在回源時自動指向新版/api/v2/，並附加一個版本標識參數。

• 匹配條件：starts_with(http.request.uri.path, "/api/v1/")

• 重寫配置：

  • 重寫對象：路徑、查詢字串

  • 操作方式：動態

  • 路徑重寫運算式：regex_replace(http.request.uri.path, "^/api/v1/", "/api/v2/")

  • 查詢字串重寫運算式：concat("api_version=v2&", http.request.uri.query)

• 重寫效果：

  • 使用者請求：https://example.com/api/v1/users?limit=10

  • 回源請求：https://origin.com/api/v2/users?api_version=v2&limit=10

樣本三：參數標準化

• 情境：不同用戶端使用不同的參數名（如userid和uid），統一重寫為標準的user_id。

• 匹配條件：http.request.uri.query contains "userid="

• 重寫配置：

  • 重寫對象：查詢字串

  • 操作方式：動態

  • 運算式：regex_replace(http.request.uri.query, "userid=", "user_id=")

• 重寫效果：

  • 使用者請求：https://example.com/profile?userid=123

  • 回源請求：https://origin.com/profile?user_id=123

樣本四：路徑正常化

• 情境：統一處理URL中因輸入錯誤產生的字元。以刪除URL中的連續斜杠（如 // 或 ///）為例。

• 匹配條件：http.request.uri.path contains "//"

• 重寫配置：

  • 重寫對象：路徑

  • 操作方式：動態

  • 運算式：regex_replace(http.request.uri.path, "/+", "/")

• 重寫效果：

  • 使用者請求：https://example.com/path//to///resource

  • 回源請求：https://origin.com/path/to/resource

樣本五：刪除所有查詢參數

• 情境：對於某些靜態資源，為提高來源站點處理效率，需移除所有查詢參數。以刪除以.css結尾的URI路徑後的所有字元為例。

• 匹配條件：ends_with(http.request.uri.path, ".css")

• 重寫配置：

  • 重寫對象：查詢字串

  • 操作方式：靜態，內容設定為空白

• 重寫效果：

  • 使用者請求：https://example.com/style.css?version=1.2.3

  • 回源請求：https://origin.com/style.css

樣本六：簡化動態路徑

• 情境：縮短包含冗餘數字或代碼的長路徑。以刪除/example/路徑中所有123及其後跟隨的數字序列，保留其餘內容為例。

• 匹配條件：(http.request.uri matches "^/example/(.*)123[0-9]+(.*)$")

• 重寫配置：

  • 重寫對象：路徑

  • 操作方式：動態

  • 運算式：regex_replace(http.request.uri,"^/example/(.*)123[0-9]+(.*)$","/example/$1$2")

  

• 重寫效果：

  • 使用者請求：https://example.com/example/tool12300341features

  • 回源請求：https://example.com/example/toolfeatures

樣本七：提取路徑參數並添加到查詢字串

• 情境：需要提取URL路徑中的動態參數作為某個新增的查詢參數的值，同時將URL路徑中的動態參數重寫為一段固定的字串：

  • 原始URI：/api/v1/動態值/download?version=1&size=2 

  • 重寫後的URI：/api/v1/fixed/download?version=1&size=2&token=動態值

• 匹配條件：所有傳入請求

• 重寫配置：

  • 重寫對象：路徑 + 查詢字串

  • 操作方式：動態

  • 路徑重寫運算式：regex_replace(http.request.uri.path, "^/api/v1/(.*)/download$", "/api/v1/test/download")

  • 查詢字串重寫運算式：concat(http.request.uri.query,"&token=",regex_replace(http.request.uri.path, "^/api/v1/(.*)/download$","$1"))

  

• 重寫效果：

  • 使用者請求：https://example.com/api/v1/ABC123/download?version=1&size=2

  • 回源請求：https://example.com/api/v1/fixed/download?version=1&size=2&token=ABC123

參考文檔

規則相關的功能，在生效優先順序、可重新進入性、生效顆粒度上存在差異，詳細情況請查看規則相關功能的特性說明。

運算式參考