一、核心概念：預(yù)熱 vs 刷新（先分清，再操作）

二、配額限制：避免任務(wù)提交失�。ū乜矗�

• 控制臺：CDN → 緩存刷新 → 預(yù)熱記錄 → 配額信息
• API：調(diào)用DescribePushQuota接口查詢剩余配額

三、操作規(guī)范：確保預(yù)熱任務(wù)成功的基礎(chǔ)

1. URL 格式要求（必須嚴(yán)格遵守）

• 必須包含完整協(xié)議頭（http://或https://），不支持*.test.com等通配符 Tencent Cloud
• URL 中不能有空格，需用%20編碼
• 不支持目錄預(yù)熱，只能提交具體文件 URL
• 支持帶參數(shù) URL（如logo.png?v=20260213），視為獨立文件

2. 加速區(qū)域選擇

• 境內(nèi)：僅預(yù)熱中國大陸節(jié)點
• 境外：僅預(yù)熱海外節(jié)點
• 全球：同時預(yù)熱境內(nèi)外節(jié)點（配額雙倍消耗）Tencent Cloud
• 根據(jù)用戶分布選擇，避免浪費(fèi)配額

3. 提交方式（3 種）

1. 控制臺手動提交：CDN → 緩存刷新 → 預(yù)熱 URL，輸入 URL 列表
2. 文件批量提交：上傳 UTF-8 編碼的 txt 文件，每行 1 個 URL
3. API/CLI 自動提交：適合自動化流程 騰訊云

tccli cdn PushUrlsCache --Urls "https://cdn.example.com/new-logo.png" --Area "mainland"

三、源站準(zhǔn)備：確保預(yù)熱能成功拉取資源

1. 源站可訪問性（關(guān)鍵前提）

• 確保源站服務(wù)器正常運(yùn)行，網(wǎng)絡(luò)暢通
• 放行 CDN 回源 IP：在源站防火墻 / 安全組中添加騰訊云 CDN 回源 IP 段
• 避免源站設(shè)置 URL 防盜鏈未放行 CDN 節(jié)點

2. 緩存策略配置（決定預(yù)熱效果）

• 源站響應(yīng)頭需包含合理Cache-Control/Expires，避免 CDN 節(jié)點不緩存
• 禁止設(shè)置no-cache/no-store，否則 CDN 不會緩存該資源
• 建議設(shè)置TTL≥30 分鐘，確保預(yù)熱資源能在節(jié)點長期緩存

3. 大文件處理（視頻 / 安裝包等）

• 預(yù)熱大文件（如 GB 級視頻）時，源站需支持 Range 請求，避免超時失敗 騰訊云
• 大文件預(yù)熱耗時較長（可能超 30 分鐘），需預(yù)留充足時間
• 可通過 API 查詢預(yù)熱進(jìn)度，避免重復(fù)提交

四、任務(wù)管理：預(yù)熱后的驗證與監(jiān)控

1. 預(yù)熱生效時間（耐心等待）

• 境內(nèi)節(jié)點：通常5-15 分鐘內(nèi)生效
• 境外節(jié)點：因網(wǎng)絡(luò)距離，可能需要15-30 分鐘 Tencent Cloud
• 視頻等大文件：生效時間可能更長，取決于文件大小和網(wǎng)絡(luò)狀況

2. 預(yù)熱結(jié)果驗證（3 種方法）

1. 控制臺查看：CDN → 緩存刷新 → 預(yù)熱記錄，確認(rèn)狀態(tài)為成功
2. 瀏覽器驗證：F12→Network，訪問資源查看響應(yīng)頭X-Cache: HIT（預(yù)熱成功）
3. API 查詢：調(diào)用DescribePushTasks接口獲取詳細(xì)結(jié)果

3. 異常處理（預(yù)熱失敗怎么辦）

五、最佳實踐：提升預(yù)熱效率，降低成本

1. 預(yù)熱時機(jī)選擇（避開高峰）

• 非業(yè)務(wù)高峰期提交預(yù)熱任務(wù)（如凌晨），避免源站帶寬被占滿
• 大促 / 活動前2-4 小時開始預(yù)熱，預(yù)留足夠生效時間
• 避免同時提交大量預(yù)熱任務(wù)，分批次進(jìn)行，控制并發(fā) 騰訊云

2. 資源選擇策略（精準(zhǔn)預(yù)熱）

• 優(yōu)先預(yù)熱熱點資源（如首頁、活動頁、熱門商品圖）
• 避免預(yù)熱低頻訪問資源，浪費(fèi)配額和源站帶寬
• 靜態(tài)資源（JS/CSS/ 圖片）適合預(yù)熱，動態(tài)內(nèi)容不建議預(yù)熱 騰訊云

3. 自動化預(yù)熱（提升效率）

• 結(jié)合CI/CD 流程，發(fā)布后自動觸發(fā)預(yù)熱 API
• 配合騰訊云 COS+SCF，實現(xiàn)文件上傳后自動預(yù)熱
• 建立預(yù)熱任務(wù)日志，便于追蹤和問題排查

4. 成本優(yōu)化（避免不必要支出）

• 預(yù)熱會產(chǎn)生回源流量費(fèi)用，控制預(yù)熱范圍，避免全量預(yù)熱
• 利用版本號命名（如logo-v2.png），減少刷新 + 預(yù)熱操作
• 定期清理無效預(yù)熱任務(wù)，釋放配額 Tencent Cloud

六、常見誤區(qū)與避坑指南（重點提醒）

1. 誤區(qū)：預(yù)熱后立即生效，用戶能馬上訪問到新內(nèi)容

• 實際：預(yù)熱需時間同步到所有節(jié)點，且舊緩存未清除時用戶仍可能訪問到舊內(nèi)容
• 正確做法：先刷新舊資源，再預(yù)熱新資源，預(yù)留足夠生效時間 騰訊云

2. 誤區(qū)：預(yù)熱支持目錄，提交目錄路徑即可

• 實際：騰訊云 CDN不支持目錄預(yù)熱，只能提交具體文件 URL
• 正確做法：批量生成文件 URL 列表，分批提交預(yù)熱

3. 誤區(qū)：預(yù)熱次數(shù)越多，效果越好

• 實際：頻繁預(yù)熱會增加源站壓力和回源流量成本，且超配額會失敗
• 正確做法：僅在必要時（如版本發(fā)布、大促前）進(jìn)行預(yù)熱

4. 誤區(qū)：全球預(yù)熱和境內(nèi)預(yù)熱效果一樣

• 實際：全球預(yù)熱消耗雙倍配額，且境外節(jié)點生效慢
• 正確做法：根據(jù)用戶分布選擇區(qū)域，優(yōu)先覆蓋主要用戶區(qū)域 Tencent Cloud

七、快速操作清單（預(yù)熱前必查）

1. ✅ 確認(rèn)文件已更新并上傳到源站
2. ✅ 先提交舊資源的刷新任務(wù)（URL / 目錄）
3. ✅ 準(zhǔn)備新資源的 URL 列表（完整協(xié)議，無空格）
4. ✅ 檢查源站可訪問性（放行 CDN 回源 IP，無防盜鏈限制）
5. ✅ 確認(rèn)預(yù)熱配額充足（查詢每日剩余配額）
6. ✅ 選擇正確加速區(qū)域（境內(nèi) / 境外 / 全球）
7. ✅ 分批提交預(yù)熱任務(wù)（每次≤20 條）
8. ✅ 等待 5-30 分鐘，驗證預(yù)熱結(jié)果（X-Cache: HIT）