重新整理和預熱CDN節點的緩衝資源 - CDN

通過重新整理功能，您可以刪除CDN邊緣節點上已經緩衝的資源，並強制CDN邊緣節點回來源站點擷取最新資源，適用於來源站點資源更新和發布、違規資源清理、網域名稱配置變更等；通過預熱功能，您可以在業務高峰前預先將熱門資源緩衝到CDN邊緣節點，降低來源站點壓力。

功能介紹

資源重新整理

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

適用情境

資源更新和發布：來源站點的舊資源更新或升級後，為避免使用者仍訪問到舊的緩衝資源，可通過提交對應資源的URL或目錄進行重新整理，確保使用者訪問到最新的資源並緩衝至CDN邊緣節點。
違規資源清理：如果您的來源站點存在不合規內容（如使用限制中提及的內容），刪除來源站點資源後，由於CDN邊緣節點仍可能存在緩衝，資源仍可能被訪問到。此時可通過URL重新整理功能更新緩衝資源，確保違規內容及時清除。

資源預熱

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

適用情境

首次接入阿里雲CDN：當您首次接入CDN後，可選擇將熱點靜態資源提前預熱至CDN邊緣節點。使用者訪問時可直接由CDN邊緣節點響應，避免初次訪問速度慢的問題，提升使用者體驗。
營運活動：在營運大型活動時，提前將活動頁涉及的靜態資源預熱至CDN邊緣節點。活動開始後，使用者訪問的所有靜態資源均已緩衝至CDN邊緣節點，由邊緣節點直接響應，確保活動頁面快速載入。
安裝包或其他大檔案發布：新版本安裝包或升級包發布前，提前將資源預熱至CDN邊緣節點。產品正式上線後，使用者的下載請求將直接由CDN邊緣節點響應，提升下載速度，降低來源站點壓力。

前提條件

許可權要求：使用 RAM 使用者操作時，必須先授予 cdn:PushObjectCache（預熱）和 cdn:RefreshObjectCaches（重新整理）許可權。詳情請參見授予RAM使用者重新整理預熱許可權。
URL 格式：提交的 URL 中若包含非 ASCII 字元（如中文、空格），必須先進行UTF-8百分比符號編碼（Percent-encoding）。

注意事項

操作時機：重新整理預熱任務會產生回源流量，建議在業務流量低峰期執行大規模的重新整理或預熱任務。
共用快取：若網域名稱配置了共用快取，使用主網域名稱或任意關聯網域名稱提交重新整理任務，均可使所有關聯網域名稱的緩衝失效。
重寫訪問URL：如果網域名稱配置了重寫訪問URL，CDN節點將會使用重寫以後的URL來產生Cachekey，因此需要提交重寫後的URL來進行重新整理預熱操作。

費用說明

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

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

如果來源站點是阿里雲 OSS，將按 OSS 的計費規則收取流量費用和請求費用。
如果來源站點是 ECS 或其他伺服器，將按其網路頻寬或流量計費。

重要

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

操作指南

重新整理資源

登入CDN控制台。
在左側導覽列，單擊刷新预热。
在重新整理緩存/預熱緩衝頁簽，選擇操作類型為刷新。

根據您的需求，選擇重新整理方式並提交任務。

重新整理方式	操作說明
URL重新整理	目的：精確失效一個或多個具體檔案的緩衝。操作：在重新整理內容輸入框中，輸入完整的 URL（包含 `http://` 或 `https://`），每行一個。例如：`https://www.example.com/static/image.jpg`。
目錄重新整理	目的：失效指定 URL 目錄下所有檔案和子目錄的緩衝。操作：輸入完整的目錄 URL，且必須以 `/` 結尾。例如：`https://www.example.com/static/`。說明：此方式為標記重新整理。若需強制重新整理整個目錄，請使用重新整理緩衝API並設定 `Force=true`。
正則重新整理	目的：按Regex匹配 URL 路徑，批量失效符合規則的資源緩衝。操作：輸入帶有Regex的 URL。例如：`https://www.example.com/static/[0-9][a-z]..jpg`。說明：此方式為標記重新整理。若需強制重新整理整個目錄，請使用重新整理緩衝API並設定 `Force=true`。注意：*盡量使用更精確的匹配規則，避免非預期的、大範圍的緩衝失效。

單擊提交，系統將開始執行重新整理任務。
說明
- 重新整理任務一旦提交成功，將無法中止。
- 重新整理任務通常需要 5-6 分鐘在全網生效。如果您的緩衝到期時間本身就小於此值，則無需手動重新整理。
- 如果您在OSS控制台開啟了CDN緩衝自動重新整理，則無法通過CDN控制台查看OSS的緩衝自動重新整理任務。

預熱資源

登入CDN控制台。
在左側導覽列，單擊刷新预热。
在重新整理緩存/預熱緩衝頁簽，選擇操作類型為预热。
在預熱內容輸入框中，輸入需要預熱的完整檔案 URL，每行一個。不支援預熱目錄。例如：https://www.example.com/install/package.zip。
單擊提交，系統將開始執行預熱任務。
說明
- 刷預熱任務一旦提交成功，將無法中止。
- 預熱任務的完成時間取決於檔案大小、數量和來源站點效能，通常需要 5-30 分鐘。

自動化重新整理或預熱

如果您有以下情況，建議您使用自動化指令碼重新整理和預熱：

無開發人員，需手動提交重新整理預熱任務，營運成本高。
重新整理或預熱URL過多，分批提交導致重新整理或預熱效率低。
需要人工或程式判斷重新整理預熱任務是否正常進行，費時費力。

驗證結果

手動查詢
在操作記錄頁簽中查看資源重新整理或預熱的詳細記錄和進度。進度為100%，表示任務執行完成。重新整理或預熱的數量過多，會影響任務的完成進度，請您耐心等待。
介面查詢
調用DescribeRefreshTaskById介面，查詢重新整理或預熱任務是否完成。
命令列驗證
執行命令curl -I <資源連結>，系統顯示結果如下：
存在X-Cache的情況：
- X-Cache是HIT，說明此次請求命中緩衝，預熱成功。
- X-Cache是MISS，說明此次請求未命中緩衝，預熱任務未完成或預熱失敗，請重新預熱。
不存在X-Cache的情況：
如果不存在X-Cache，說明該資源未接入CDN，請參照快速接入阿里雲CDN，先將該URL的網域名稱接入阿里雲CDN，再進行資源的預熱。

使用限制

操作類型	方式	配額限制	管理額度
重新整理	URL重新整理	每個帳號每日最多10000條	配額管理
	目錄重新整理	每次最多提交100條；每個網域名稱每分鐘最多100條
	正則重新整理	每個帳號每日最多20條
預熱	URL預熱	每次最多提交100條；每個帳號每日最多1000條

拓展閱讀：CDN的緩衝重新整理機制

CDN 針對目錄重新整理和正則重新整理提供兩種緩衝重新整理機制：標記重新整理和強制重新整理，適用於不同情境，協助您靈活高效的管理緩衝內容。

標記重新整理（CDN預設策略）

適用情境：常規內容更新，如發布新版靜態檔案。
機制：這是目錄重新整理和正則重新整理在控制台上的預設行為。CDN 邊緣節點在回源時，會攜帶 If-Modified-Since 或 If-None-Match 要求標頭。來源站點會根據這些頭資訊判斷資源是否已更新。
效果：如果來源站點資源未變更，來源站點將返回 304 Not Modified 狀態代碼，CDN 邊緣節點會繼續使用舊的快取複本，不會消耗回源流量。這是一種節省成本和來源站點資源的最佳化方式。

強制重新整理

適用情境：緊急清理違規或錯誤資源、修複錯誤的 Cache-Control 回應標頭配置後，需要強制全網更新的情境。
機制：通過重新整理緩衝API提交重新整理任務時，將參數 Force 設定為 true 來觸發。此模式下，CDN 邊緣節點會無條件地將緩衝資源標記為失效。
效果：下次訪問該資源時，CDN 邊緣節點將必須回源擷取新版本，即使來源站點上的檔案並未改變。

CDN：重新整理和預熱資源