Edge Security Acceleration：等候室快速上手

參數

說明

等候室名稱

設定一個容易識別的名稱，例如 promo_activity_room。

主機名稱和路徑

等候室生效的確切 URL。僅適用於指定的子域和路徑。樣本：如果主機名稱為 event.example.com、路徑為 /route，則等候室僅對 event.example.com/route 的請求生效。

自訂Cookie

用於標識和追蹤每個使用者的排隊狀態。Cookie 名稱固定首碼為 __aliwaitingroom_，可自訂尾碼。樣本：__aliwaitingroom_promo_user。

參數

說明

活動使用者總數

用途：設定來源站點同時可容納的最大並發使用者數。

說明：根據來源站點實際並發處理能力設定此值。當活躍使用者數達到此閾值時，新的請求進入排隊。

注意：最小值為 200。如果來源站點實際負載低於 200，將此值設為 200，並使用每分鐘的新用戶數參數更精確地控制准入速率。

每分鐘的新用戶數

用途：設定每分鐘從隊列允許存取到來源站點的最大新使用者數，控制來源站點負載增長速率。

說明：此參數決定隊列處理速度。例如設為 300，則每分鐘最多 300 個使用者從等候頁面進入來源站點。

注意：最小值為 200，且不能超過活動使用者總數。

會話期間

用途：定義使用者離開隊列後會話的有效時間長度。

說明：使用者成功訪問來源站點後，如果臨時離開（例如關閉頁面），在此參數設定的時間內返回無需重新排隊。預設值為 5 分鐘。

禁用會話續訂

用途：確定使用者在與來源站點互動期間會話有效期間是否自動續訂。

注意：此開關的名稱與實際行為相反。

• 關閉（預設）：啟用會話續訂。只要使用者保持活躍（持續發送請求），會話就不會到期，不會被送回隊列。適用於大多數情境。

• 開啟：禁用會話續訂。使用者的會話從首次進入來源站點時開始嚴格計時。到期後即使使用者仍在瀏覽，也必須重新排隊。適用於需要嚴格控制單次訪問時間長度的情境，如限時搶購。

排隊方法

從等候頁面允許存取使用者的策略。

• FIFO：按請求到達順序允許存取使用者，最公平的方式，推薦預設選擇。

• 隨機：從隊列中隨機播放使用者允許存取。適用於抽獎等不要求公平的情境。

• 全部拒絕：所有新使用者進入等候頁面且不予允許存取。適用於活動預熱、系統維護或需要緊急關閉訪問的情境。

• 直通：所有請求繞過隊列直接到達來源站點，等候室實際上被禁用。可用於活動結束後恢複正常訪問或功能測試。

參數

說明

等候室類型

預設等候室：系統提供的標準等待頁面，會自動顯示預計等待時間。您可以選擇預設語言模板（英語、簡體中文、繁體中文）。

自訂等候室：允許您上傳自訂的HTML頁面。若需使用請聯絡您的銷售。

• 您可以編輯模板或直接匯入 .html 檔案（大小不超過 50KB）。

• 您可以在HTML中使用動態變數（如 ${waitTime}）來顯示排隊資訊。

排隊預覽

單擊連結可以預覽等待頁面在不同狀態（如正在排隊、全部排隊）下的顯示效果。

JSON響應

目的：為非瀏覽器用戶端（如App、小程式）提供結構化的排隊狀態資訊。

開啟此開關後，當用戶端要求標頭中包含 Accept: application/json 時，ESA將返回JSON格式的排隊資訊，而不是HTML等待頁面，具體參數請參見JSON響應參數說明：。

互動流程：

1. 首次請求：用戶端攜帶 Accept: application/json 要求標頭訪問目標URL。

2. 擷取並儲存Cookie：ESA的回應標頭中會包含一個 Set-Cookie 欄位。用戶端必須儲存此Cookie，作為後續請求的身份憑證。

3. 輪詢狀態：用戶端需攜帶此Cookie，並根據響應體中 refreshIntervalSeconds 欄位指定的秒數，定時重新請求同一URL以重新整理排隊狀態。

4. 訪問來源站點：當響應體中的 inWaitingRoom 欄位變為 false 時，表示已離開隊列，用戶端即可使用該Cookie正常訪問來源站點資源。

響應樣本：

{
  "WaitingRoom": {
    "inWaitingRoom": true,
    "waitTime": 5,
    "waitTimeKnown": true,
    "waitTimeFormatted": "5 minutes",
    "queueIsFull": false,
    "queueAll": false,
    "lastUpdated": "2024-09-10T12:00:00.000Z",
    "refreshIntervalSeconds": 20
  }
}

隊列狀態代碼

自訂使用者在排隊時收到的HTTP響應狀態代碼。預設為200。您可以根據需要修改為202等其他狀態代碼。