全部產品
Search
文件中心

ApsaraVideo VOD:重新整理預熱

更新時間:Feb 11, 2026

當來源站點內容更新或需要清理違規資源時,需要強制CDN節點重新整理緩衝以確保使用者訪問最新內容。在活動發布或新內容上線前,提前預熱資源到CDN節點,可以顯著提升使用者首次訪問速度並降低來源站點壓力。本文檔將指導如何正確使用ApsaraVideo for VOD的緩衝重新整理與資源預熱功能。

功能介紹

資源重新整理

重新整理操作的本質是向CDN邊緣節點下發緩衝失效指令,而非直接刪除檔案。邊緣節點收到指令後,會將匹配的緩衝資源標記為“失效”或“到期”。當使用者再次請求該資源時,邊緣節點發現緩衝已失效,便會回源擷取最新資源,並在返回給使用者的同時重新緩衝。

適用情境

  1. 資源更新和發布:來源站點的舊資源更新或升級後,為避免使用者仍訪問到舊的緩衝資源,可通過提交對應資源的URL或目錄進行重新整理,確保使用者訪問到最新的資源並緩衝至CDN邊緣節點。

  2. 違規資源清理:如果您的來源站點存在不合規內容(如使用限制中提及的內容),刪除來源站點資源後,由於CDN邊緣節點仍可能存在緩衝,資源仍可能被訪問到。此時可通過URL重新整理功能更新緩衝資源,確保違規內容及時清除。

資源預熱

預熱操作是由CDN邊緣節點根據您提交的URL列表,主動向來源站點發起請求,將資源緩衝到CDN邊緣節點上,而非由來源站點主動推送。預熱可提升新資源或活動頁面的首次訪問速度,同時減少活動上線時的回源壓力,保護來源站點。

適用情境

  1. 首次接入阿里雲CDN:當您首次接入CDN後,可選擇將熱點靜態資源提前預熱至CDN邊緣節點。使用者訪問時可直接由CDN邊緣節點響應,避免初次訪問速度慢的問題,提升使用者體驗。

  2. 營運活動:在營運大型活動時,提前將活動頁涉及的靜態資源預熱至CDN邊緣節點。活動開始後,使用者訪問的所有靜態資源均已緩衝至CDN邊緣節點,由邊緣節點直接響應,確保活動頁面快速載入。

  3. 安裝包或其他大檔案發布:新版本安裝包或升級包發布前,提前將資源預熱至CDN邊緣節點。產品正式上線後,使用者的下載請求將直接由CDN邊緣節點響應,提升下載速度,降低來源站點壓力。

前提條件

  • 操作時機:重新整理預熱任務會產生回源流量,建議在業務流量低峰期執行大規模的重新整理或預熱任務。

  • URL 格式:提交的 URL 中若包含非 ASCII 字元(如中文、空格),必須先進行UTF-8百分比符號編碼(Percent-encoding)。

  • 共用快取:若網域名稱配置了共用快取,使用主網域名稱或任一關聯網域名稱提交重新整理任務,均可使所有關聯網域名稱的緩衝失效。

操作步驟

重新整理資源

  1. 登入ApsaraVideo for VOD控制台

  2. 在左側導覽列選擇配置管理 > 分发加速配置 > 刷新预热,進入到重新整理預熱頁面。

  3. 刷新缓存頁簽,選擇操作類型為刷新

  4. 根據需求,選擇重新整理方式並提交任務。

    重新整理方式

    操作說明

    URL

    目的:重新整理一個或多個具體檔案的緩衝。

    操作:URL輸入框中,輸入完整的URL(包含 http:// 或 https://),每行一個。例如:https://www.example.com/static/image.jpg

    目录

    目的:重新整理CDN目錄下所有檔案和子目錄的緩衝。

    操作:輸入完整的目錄 URL,且必須以 / 結尾。例如:https://www.example.com/static/

    說明:此方式為變更重新整理。若需強制重新整理整個目錄,請使用重新整理緩衝並設定 Force=true

  5. 單擊提交,系統將開始執行重新整理任務。

    說明
    • 重新整理任務一旦提交成功,將無法中止。

    • 重新整理任務通常需要 5-6 分鐘在全網生效。如果緩衝到期時間本身就小於此值,則無需手動重新整理。

預熱資源

  1. 登入ApsaraVideo for VOD控制台

  2. 在左側導覽列選擇配置管理 > 分发加速配置 > 刷新预热,進入到重新整理預熱頁面。

  3. 刷新缓存頁簽,選擇操作類型為预热

  4. URL輸入框中,輸入需要預熱的完整檔案URL,每行一個。不支援預熱目錄。例如:https://www.example.com/install/package.zip

  5. 單擊提交,系統將開始執行預熱任務。

    說明
    • 預熱任務一旦提交成功,將無法中止。

    • 預熱任務的完成時間取決於檔案大小、數量和來源站點效能,通常需要 5-30 分鐘。

驗證結果

  • 手動查詢

    操作記錄頁簽中查看資源重新整理或預熱的詳細記錄和進度。進度為100%,表示任務執行完成。重新整理或預熱的數量過多,會影響任務的完成進度,請您耐心等待。

  • 介面查詢

    調用查詢視頻重新整理或預熱任務資訊介面,查詢重新整理或預熱任務是否完成。

  • 命令列驗證

    執行命令curl -I <資源連結>,系統顯示結果如下:

    image

    存在X-Cache的情況:

    • X-CacheHIT,說明此次請求命中緩衝,預熱成功。

    • X-CacheMISS,說明此次請求未命中緩衝,預熱任務未完成或預熱失敗,請重新預熱。

    不存在X-Cache的情況:

    如果不存在X-Cache,說明該資源未接入CDN,請參照接入網域名稱配置該URL的網域名稱,再進行資源的預熱。

使用限制

操作類型

方式

配額限制

重新整理

URL重新整理

每個帳號每日最多2000條,每次最多1000條。

目錄重新整理

每個帳號每日最多100條,每次最多100條。

預熱

URL預熱

每個帳號每日最多500條,每次最多100條。

計費說明

重新整理和預熱功能本身不收取任何操作費用

但是,這兩種操作都會觸發CDN邊緣節點回源拉取資源,由此產生的回源流量和回源請求次數將會產生費用。計費標準遵循您所使用的來源站點類型:

重要

大規模的重新整理或預熱操作,尤其是在短時間內,可能會導致回源成本增加。請在操作前評估潛在的成本影響。

相關API

常見問題