Edge Security Acceleration：重新整理和預熱資源

資源重新整理

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

控制台預設重新整理方式說明：在DCDN控制台執行目錄重新整理或正則重新整理時，預設採用標記重新整理方式。標記重新整理僅標記緩衝到期，當邊緣節點回源時，會攜帶If-Modified-Since或If-None-Match要求標頭。若來源站點返回304 Not Modified，邊緣節點將保留舊快取複本。這種方式可節省回源流量，但在某些情境下（如來源站點同名更新、違規內容清理、配置變更後）可能導致使用者仍訪問到舊內容。若需徹底清除緩衝，建議使用API調用重新整理緩衝介面，並將Force參數設定為true進行強制重新整理。

適用情境

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

• 違規資源清理：來源站點存在不合規內容時，刪除來源站點資源後，由於邊緣節點仍可能存在緩衝，資源仍可能被訪問到。此時可通過URL重新整理功能更新緩衝資源，確保違規內容及時清除。

資源預熱

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

預熱機制說明：預熱操作預設將資源緩衝至L2回源節點（二級緩衝層），而非直接分發至所有L1邊緣節點。當使用者首次訪問某資源時，L1邊緣節點會從L2回源節點或來源站點拉取內容並緩衝。因此，預熱操作主要解決的是降低來源站點壓力的問題，L1邊緣節點的全面緩衝覆蓋依賴於使用者的實際訪問分布。只有當使用者實際訪問某L1節點後，該節點完成本機快取，後續同地區使用者才能直接從L1命中緩衝獲得加速。

適用情境

• 首次接入DCDN：首次接入DCDN後，可將熱點靜態資源提前預熱至邊緣節點。使用者訪問時可直接由邊緣節點響應，避免初次訪問速度慢的問題，提升使用者體驗。

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

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

緩衝層級與效果

預熱操作主要將資源緩衝至 L2 匯聚節點，而非所有 L1 邊緣節點。使用者首次訪問時，L1 邊緣節點會從 L2 節點或來源站點拉取資源。因此，預熱的主要目的是降低來源站點壓力，而非保證所有 L1 邊緣節點立即命中緩衝。

• 效果評估：預熱有助於提升快取命中率，但對於小檔案或非熱點檔案，建議合理評估預熱成本。預熱會產生回源流量，大致等於單個檔案大小乘以 L2 節點數量。

適用情境

注意事項

• 緩衝重新整理注意事項：

  • 大批量提交重新整理任務會清空較多緩衝，導致回源頻寬和請求突增，這會增加來源站點壓力，建議在網站流量的低峰時期操作。

  • 重新整理任務從提交到生效，大約需要5~6分鐘，如果檔案或者目錄配置的緩衝到期時間少於5分鐘，您無需執行重新整理操作，等待檔案或者目錄緩衝逾時更新即可。

  • URL重新整理、目錄重新整理和正則重新整理都已支援共用快取。在網域名稱配置了共用快取的情況下，使用主網域名稱或者任意一個關聯網域名稱來提交重新整理任務，都可以刷掉緩衝。

• 緩衝預熱注意事項：

  • 提交預熱任務並成功執行後，DCDN節點會立即回來源站點載入所需資源，因此大批量提交預熱任務會產生較多的並發回源任務，導致回源頻寬和請求突增，建議在網站流量的低峰時期操作。

  • 預熱請求預設攜帶的header是Accept-Encoding:gzip，如果您需要預熱請求攜帶其他header，或者實現多副本預熱，那麼可以使用OpenAPI介面預熱URL，並通過設定請求參數WithHeader來實現自訂預熱header。

  • 預熱時，如果來源站點返回307等重新導向相關的狀態代碼，預熱任務並不會跟隨重新導向地址繼續完成預熱，最終會導致預熱失敗。如果來源站點返回的是301或者302狀態代碼，並且DCDN上已經開啟了配置回源301/302跟隨，這種情況下正常預熱不受影響。

• 共同注意事項：

  • 如果網域名稱配置了重寫訪問URL，節點將會使用重寫以後的URL來產生CacheKey，因此需要提交重寫後的URL來進行重新整理預熱操作。

  • 使用RAM使用者重新整理和預熱需先獲得授權，請參見授予RAM使用者重新整理預熱許可權完成授權。

  • URL重新整理、緩衝預熱任務一旦下發成功，在任務執行完之前無法停止。

  • 提交緩衝重新整理或預熱任務時，您提交的URI中若包含非ASCII字元（例如：空格、中文、特殊字元）需要您先對URL進行編碼處理，否則內容管理系統將無法識別任務。請確保您提交的URI為編碼後的格式。

  • URL 鑒權情境的重新整理和預熱：提交的重新整理 URL 或預熱 URL 應與實際緩衝鍵一致。對於已配置URL鑒權的網域名稱，應提交不含鑒權參數的原始 URL（加速網域名稱 + 檔案路徑），並保留業務查詢參數。若業務查詢參數（query string）值中包含 /，提交前需將其編碼為 %2F；路徑分隔字元保持不變。

    控制台在提交重新整理或預熱請求前，僅對 URL 進行格式校正，並按使用者輸入提交，不會自動刪除鑒權參數、重新編碼業務查詢參數或正常化 URL。不要直接提交包含鑒權參數的客戶存取 URL，否則可能因與實際緩衝鍵不一致，導致無法命中目標緩衝。

    以下樣本為 F 方式 URL 鑒權。樣本中的 k 和 t 分別表示該網域名稱配置的簽名參數和時間戳記參數名稱。

    1. 客戶存取 URL：

       https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80&k=123456789abcdefg&t=123abc

    2. 去除鑒權參數後的 URL：刪除 k 和 t，保留業務查詢參數。

       https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80

    3. 最終重新整理/預熱 URL：將業務查詢參數 x-oss-process 值中的 / 編碼為 %2F；路徑 /cat.jpg 中的路徑分隔字元保持不變。

       https://image.example.com/cat.jpg?x-oss-process=image%2Fresize,m_fill,w_390,h_520,limit_1%2Fauto-orient,1%2Fsharpen,100%2Fquality,q_80

重新整理資源

1. 登入DCDN控制台。

2. 在左側導覽列，選擇管理工具 > 刷新预热。

3. 在重新整理緩衝頁簽，配置重新整理規則。

   參數	說明
   操作類型	選擇重新整理。
   重新整理類型	支援URL、目录、正則重新整理。
   URL	預設情況下，一個帳號每日最多可以提交10,000條URL重新整理和100條目錄重新整理，目錄重新整理包含子目錄。如果您的阿里雲帳號的日頻寬峰值大於200Mbps，您可以通過配額管理申請提升每日配額，阿里雲將根據您業務的實際需求進行評估和配置。 預設情況下，一個帳號每日最多可以提交20條正則重新整理，如果您的阿里雲帳號的日頻寬峰值大於10 Gbps，您可以通過提交工單來申請提升每日配額。 URL重新整理 輸入的URL必須帶有http://或https://。 重新整理多個URL時，請按照一行一個URL進行輸入。 目錄重新整理 輸入的URL必須以http://或https://開頭，以正斜線（/）結尾。 重新整理根目錄下所有檔案：http://example.com/。 重新整理子目錄/path/test/下的所有檔案：http://example.com/path/test/。 重新整理多個URL時，請按照一行一個URL進行輸入。 每次最多可以提交100條目錄重新整理，單個網域名稱每分鐘最多可以提交100條目錄重新整理。 目錄重新整理預設採用“重新整理變更資源”方式，如果使用者請求的內容匹配到了目錄下的資源，DCDN節點將會回源擷取資源的Last-Modified資訊，若與當前緩衝資源一致，則直接返回已緩衝資源，若不一致，則回源拉取新資源返回給使用者，並重新緩衝該資源。 正則重新整理 詳情請參見正則重新整理說明。

4. 單擊提交。

5. 查看重新整理進度。

   提交重新整理任務後，您可以在操作记录頁簽中查看資源重新整理的詳細記錄和進度。重新整理數量多會影響重新整理進度，請您耐心等待。

預熱資源

1. 登入DCDN控制台。

2. 在左側導覽列，選擇管理工具 > 刷新预热。

3. 在重新整理緩衝頁簽，配置預熱規則。

   參數	說明
   操作類型	選擇预热。
   重新整理類型	僅支援URL預熱。
   URL	輸入的URL必須帶有http://或https://，預熱URL必須是精確的資源檔路徑，不支援輸入以/結尾的目錄。 預熱多個URL時，請按照一行一個URL進行輸入。 URL預熱配額（每日）：一個帳號每日最多可以提交1000條URL預熱，每次最多可以提交100條URL預熱。 如果您帳號的日頻寬峰值大於500Mbps，可參考配額管理申請提升每日配額，阿里雲將根據您業務的實際需求進行評估和配置。 預熱隊列規則：每個帳號的預熱隊列最大為100,000條URL，DCDN根據URL提交的先後順序進行預熱；當預熱隊列中待預熱的URL達到了100,000條時，DCDN將會拒絕接收新的預熱任務。 預熱速度：預熱任務的執行速度與需要預熱資源的檔案平均大小有關，檔案平均大小越小，預熱速度越快。

4. 單擊提交。

5. 查看預熱進度。

   提交預熱任務後，您可以在操作记录頁簽中查看資源預熱的詳細記錄和進度。預熱數量多會影響預熱進度，請您耐心等待。

相關API