限制請求速率

限制請求速率動作基於漏桶演算法控制請求處理速度。低於調節閾值的請求正常處理;速率進入調節區間後,請求會被延遲;達到拒絕閾值後,系統執行指定的拒絕動作。 平滑突發流量,避免短時間內的大量請求壓垮上游服務。 限制爬蟲、介面輪詢、批次查詢等持續高頻訪問。 按客戶端、URI 或業務標識分別保護高成本介面。

限制請求速率動作基於漏桶演算法控制請求處理速度。低於調節閾值的請求正常處理;速率進入調節區間後,請求會被延遲;達到拒絕閾值後,系統執行指定的拒絕動作。

適用場景

  • 平滑突發流量,避免短時間內的大量請求壓垮上游服務。
  • 限制爬蟲、介面輪詢、批次查詢等持續高頻訪問。
  • 按客戶端、URI 或業務標識分別保護高成本介面。

如果需要限制固定時間視窗內的請求總數,而不需要對中間流量進行延遲,請使用限制請求數。

工作原理

OpenResty Edge 根據一個或多個關鍵字對請求分組,並分別計算每個分組的請求速率。漏桶演算法將進入調節區間的突發請求延遲處理,使輸出速率更加平穩;超過拒絕閾值的請求則執行拒絕動作。

配置方法

在目標應用的頁面規則中選擇 CC 攻擊防禦動作 > 限制請求速率。

選擇限制請求速率動作

限制請求速率配置

引數說明

  1. 關鍵字:用於對請求分組並分別計算速率。預設使用客戶端 IP 地址,也可以組合 URI、URI 引數等關鍵字。選擇 URI 引數或 Cookie 時,還需要指定相應的引數或 Cookie 名稱。詳見關鍵字。
  2. 調節於:請求速率低於該值時不受限制;達到該值但尚未達到拒絕閾值時,請求將被延遲處理。
  3. 拒絕於:請求速率達到該值後,系統執行拒絕動作。
  4. 拒絕動作:達到拒絕條件後執行的操作。詳見拒絕動作。

調節閾值和拒絕閾值可以按每秒請求數或每分鐘請求數設定。兩個閾值設定為相同值時,不保留調節區間,達到該速率後將直接執行拒絕動作。

關鍵字

限制請求速率的關鍵字選項

可選的關鍵字包括:

  • 客戶端 IP 地址:例如 1.1.1.1。
  • URI:例如 /openresty。
  • URI 查詢引數:例如 /openresty?arg1=val1 中的 arg1。
  • 請求 Cookie:例如 Cookie: c1=v1 中的 c1。
  • X-Forwarded-For 中的第一個 IP 地址:例如 X-Forwarded-For: 1.1.1.1, 1.1.1.2 中的 1.1.1.1。
  • X-Forwarded-For 中的最後一個 IP 地址:例如 X-Forwarded-For: 1.1.1.1, 1.1.1.2 中的 1.1.1.2。
  • 指定的 HTTP 請求頭:例如 Host。
  • 加密 Cookie:根據 OpenResty Edge 生成的加密 Cookie 區分客戶端。請求沒有攜帶加密 Cookie 時,系統需要回退到其他關鍵字,因此加密 Cookie 必須與其他關鍵字組合使用。

使用 X-Forwarded-For 前,應確保該請求頭由可信代理維護,不能由客戶端任意偽造。

按匹配網段限流

客戶端隱私服務提供商 和 客戶端匹配網段(CIDR) 關鍵字在 OpenResty Edge 26.12.1-1 中首次引入。 將管理端和閘道器升級至 26.12.1-1 或更新版本後,可在關鍵字下拉式清單中選擇 客戶端匹配網段(CIDR),以主 IP 資料庫匹配的網段作為限流鍵。同一網段中的地址共用額度。 若同時加入 客戶端 IP 地址,組合後的鍵仍會區分每個地址。

也可選擇 客戶端隱私服務提供商 按服務名稱分組;匹配記錄沒有名稱時會落入同一個空字串分組。 按網段分組前,可用 client-network 的非空條件限定規則,使規則只處理已取得匹配網段的請求。 /32 或 /128 仍代表單個地址;資料庫更新可能改變分組。

欄位含義和升級要求見 IP 地理資訊資料庫。

拒絕動作

達到拒絕條件後,系統可以執行以下預設動作。預設動作為 返回錯誤頁。

限制請求速率的拒絕動作

  • 關閉請求連線:立即終止與客戶端的連線,不再響應請求。
  • 返回錯誤頁:返回錯誤頁面,預設狀態碼為 503。
  • 完成 hCaptcha 驗證:要求客戶端通過 hCaptcha 挑戰。
  • 完成 OpenResty Edge Captcha 驗證:使用 OpenResty Edge 的驗證碼系統驗證使用者。
  • 重定向驗證:將請求重定向到驗證頁面,驗證通過後才能繼續訪問。
  • JavaScript 挑戰:要求客戶端瀏覽器執行 JavaScript 程式碼,以區分瀏覽器和簡單的自動化程式。
  • 私有訪問 Token:請求客戶端認證,沒有有效 Token 時執行配置的回退動作。 需要配置回退動作、必要的 頁面模板 和 清除時間(預設 60 秒)。詳見 私有訪問 Token。 此動作在 OpenResty Edge 26.9.1-1 中首次引入。
  • 標記為拒絕:僅將請求標記為拒絕,並繼續執行後續規則。此動作於 24.9.1-7 中首次引入。
  • 封禁 IP 地址:在作業系統層面丟棄來源 IP 的所有資料包。此動作於 26.3.1-1 中首次引入。

配置示例

僅限制特定地區的請求

預設情況下,動作會對所有請求按客戶端 IP 地址計算速率。可以通過頁面規則條件縮小生效範圍。例如,將客戶端國家設定為 JP,可以僅對來自日本的請求執行該動作。

按客戶端國家限制請求速率

完成動作和條件設定後,建立規則併發布應用配置。

建立請求速率限制規則

加密 Cookie 應與其他關鍵字組合使用。以下配置同時選擇 客戶端 IP 地址 和 加密 Cookie,並將調節閾值和拒絕閾值設定為每分鐘 1 個請求。

使用加密 Cookie 作為關鍵字

儲存併發布配置:

釋出請求速率限制配置

第一次傳送測試請求時,請求尚未攜帶加密 Cookie,因此響應會通過 Set-Cookie 下發 _oredge_rl:

$ curl localhost -H 'Host: test.com' -I
HTTP/1.1 404 Not Found
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Set-Cookie: _oredge_rl=G63GyXMjH89ClH7dgJgSAo+f7FbPVTD5KAdkLbnkjhw=; Path=/; Secure
Req-ID: 0000008000045ed343300002

攜帶該 Cookie 傳送第一個請求時,加密 Cookie 對應的計數尚未達到限制:

$ curl localhost -H 'Host: test.com' -I \
    -H 'Cookie: _oredge_rl=G63GyXMjH89ClH7dgJgSAo+f7FbPVTD5KAdkLbnkjhw='
HTTP/1.1 404 Not Found
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Req-ID: 0000008000045ed343300003

在同一分鐘內再次攜帶相同 Cookie 傳送請求,將觸發限制並返回 503:

$ curl localhost -H 'Host: test.com' -I \
    -H 'Cookie: _oredge_rl=G63GyXMjH89ClH7dgJgSAo+f7FbPVTD5KAdkLbnkjhw='
HTTP/1.1 503 Service Temporarily Unavailable
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Req-ID: 0000008000045ed343a80004

注意事項

  • 閾值應高於正常業務峰值,並通過監控逐步調整。閾值過低會使正常突發請求進入延遲佇列或被拒絕。
  • 組合關鍵字會改變統計粒度。只按 URI 統計會讓所有客戶端共享同一個速率額度;按“客戶端 IP 地址 + URI”統計則會為每個客戶端訪問每個 URI 分別計速。
  • 只按客戶端 IP 地址計速時,共享 NAT 或代理後的使用者會共用額度。
  • 驗證配置時,應分別測試低於調節閾值、進入調節區間、達到拒絕閾值和速率恢復後的行為。

觀測而不攔截

將 拒絕動作 設為 僅記錄日誌,並填寫 日誌名稱,可以觀察超過閾值的 請求而不拒絕它們。日誌最多每秒寫入一條,適合在正式攔截前驗證關鍵字和閾值。

當請求會在調節區間內延遲時,記錄延遲請求 控制是否為這些請求寫日誌; 預設開啟。關閉它不會取消延遲,只會停止記錄延遲事件。

僅記錄日誌 和 記錄延遲請求 引數在 OpenResty Edge 26.12.1-1 中首次引入。