Edge Security Acceleration：自訂響應碼

功能介紹

針對特定請求，客戶希望返回非來源站點預設的 HTTP 響應。例如，統一攔截提示、維護頁或臨時跳轉碼。依賴回源處理會增加延遲和來源站點壓力。自訂響應碼規則在ESA邊緣節點直接返回指定的 HTTP 響應碼和響應頁面，無需回源即可完成響應處理。

適用情境與功能選擇

自訂響應碼規則適用於直接在邊緣返回固定響應碼與頁面的情境。以下表格協助客戶根據實際需求選擇ESA中適用的功能：

應用情境

• 自訂錯誤提示：將 404、500 等錯誤碼替換為自訂頁面，向使用者展示友好的錯誤資訊。

• 臨時維護攔截：在系統維護期間，對特定路徑返回 503 狀態代碼並展示維護頁面。

• 快速攔截惡意請求：匹配攻擊特徵後返回 403 並展示攔截提示頁。

前提條件

• 已添加網域名稱並接入ESA。

• 使用響應頁面功能前，需先建立自訂頁面。建立後即可在規則中直接引用。

新增自訂響應碼規則

1. 在ESA控制台選擇網站管理，在網站列單擊目標網站。

2. 在左側導覽列，選擇規則 > 轉換規則。

3. 在轉換規則頁面選擇自訂響應碼頁簽，點擊新增規則。

4. 在新增自訂響應碼頁面，填寫以下配置項後單擊確定：

   • 規則名稱：自訂規則名，如my-rule

   • 傳入請求類型：設定要匹配的使用者請求特徵，如主機名稱 等於 www.example.com

     也可以直接編輯運算式，如 (http.host eq "www.example.com")

   • 自訂響應碼：

     • 響應碼：設定返回的 HTTP 狀態代碼，取值範圍為 200~599

     • 響應頁面：從已建立的自訂頁面下拉選擇，預設值為無響應頁面（僅返迴響應碼、不返回頁面內容）

驗證規則生效

1. 使用 curl -I https://<客戶網域名稱>/<匹配路徑> 或瀏覽器訪問匹配該規則的請求。

2. 確認返回的 HTTP 狀態代碼與配置一致；如配置了響應頁面，訪問瀏覽器時應看到對應自訂頁面內容。

樣本中的 <客戶網域名稱> 和 <匹配路徑> 為預留位置，請替換為實際接入ESA的網域名稱和命中規則的請求路徑，去掉角括弧。

管理自訂響應碼規則

在自訂響應碼規則列表中，可以對已有規則進行以下操作：

• 搜尋規則：在列表頂部的搜尋方塊中輸入規則名稱進行過濾尋找。

• 拖拽排序：拖動規則條目調整執行順序，規則按從上到下的順序依次匹配。

• 啟用/禁用：切換規則的啟用狀態。禁用後的規則不再生效，但配置保留。

• 編輯規則：修改規則名稱、匹配條件、響應碼和響應頁面等配置。

• 刪除規則：刪除不再使用的規則。刪除操作不可恢複，請謹慎操作。

注意事項

• 規則匹配按列表從上到下的順序執行，一旦匹配成功即返迴響應，不再繼續匹配後續規則。請合理安排規則的執行順序。

• 響應碼取值範圍為 200~599，覆蓋了所有有效 HTTP 狀態代碼。請根據實際業務情境選擇合適的響應碼。

• 多條自訂響應碼規則按列表順序匹配，命中第一條匹配規則後即返迴響應。可在列表中通過排序位置調整規則優先順序。自訂響應碼規則與重寫規則、安全規則屬不同類型，相互獨立生效。

• 規則修改、新增或刪除後，配置在邊緣節點上即時生效，無需手動重新整理。