清除腾讯云 CDN 缓存核心是通过刷新操作让边缘节点标记旧资源失效，下次访问回源拉取最新内容。以下是从基础到高级的完整操作流程，确保你一次操作成功。
一、先分清：刷新 vs 预热（别用错）
| 操作类型 |
作用 |
适用场景 |
腾讯云特点 |
| URL 刷新 |
删除指定 URL 的 CDN 缓存，下次访问回源 |
单文件更新（如 logo.png） |
每日限额10000 条，每次最多1000 条 腾讯云 |
| 目录刷新 |
清除整个目录缓存，支持两种模式 |
多文件批量更新 |
每日限额100 条，每次最多500 条 腾讯云 |
| 预热 |
主动将新资源缓存到 CDN 节点 |
大促 / 新版本发布前 |
不清除旧缓存，仅提前加载新资源 |
目录刷新两种模式（腾讯云特有）：
- 刷新变更资源：访问时对比 Last-Modified，仅更新变更文件（推荐）腾讯云
- 刷新全部资源：强制清除目录下所有缓存，直接回源拉取（慎用）腾讯云
二、基础操作：控制台清除（最常用）
步骤 1：进入刷新页面
- 登录腾讯云控制台 → 搜索并进入内容分发网络 CDN
- 左侧导航栏选择缓存刷新（旧版叫 “刷新与预热”）
步骤 2：选择刷新类型并提交
1️⃣ URL 刷新（单文件 / 多文件）
- 选择URL 刷新标签
- 输入完整 URL（如
https://cdn.example.com/img/logo.png），支持批量输入（每行一个）
- 选择加速区域（境内 / 境外 / 全球）
- 点击提交 → 确认操作腾讯云
2️⃣ 目录刷新（多文件）
- 选择目录刷新标签
- 输入目录路径（如
https://cdn.example.com/img/，必须以/结尾）
- 选择刷新模式（变更资源 / 全部资源）
- 选择加速区域 → 提交腾讯云
3️⃣ 一键刷新域名全部缓存（慎用）
- 进入域名管理 → 找到目标域名
- 点击右侧更多 → 选择刷新全部缓存
- 确认提交（会清空该域名所有 CDN 缓存，影响命中率）腾讯云
步骤 3：查看刷新状态
提交后在刷新记录标签页查看：
- 状态为成功表示已生效（境内约5 分钟，境外约15 分钟）腾讯云
- 失败需检查 URL 格式（必须带 http/https）或配额是否用尽
三、批量操作：高效处理多文件
1. 批量 URL 刷新（最多 1000 条 / 次）
- 在 URL 刷新框中每行输入一个 URL，直接批量提交
- 或点击上传文件，提交 txt 文件（每行一个 URL，编码 UTF-8）
2. 批量目录刷新（最多 500 条 / 次）
- 目录刷新框支持批量输入目录路径（每行一个）
- 同样支持上传 txt 文件批量提交腾讯云
3. 去参数刷新（解决？v=1 等参数问题）
腾讯云默认支持自动忽略 URL 参数刷新（如logo.png?v=1和logo.png?v=2视为同一文件），无需额外设置
四、高级操作：API / 命令行清除（自动化）
1. API 调用（适合开发 / 自动化流程）
URL 刷新 API（RefreshCdnUrl）
# 腾讯云CLI示例（需先安装配置tccli）
tccli cdn RefreshCdnUrl --Urls "https://cdn.example.com/img/logo.png" --Area "mainland"
```{insert\_element\_9\_}
#### 目录刷新API（PurgePathCache）
```bash
tccli cdn PurgePathCache --Paths "https://cdn.example.com/img/" --FlushType "flush" --Area "mainland"
```{insert\_element\_10\_}
### 2. 命令行工具（qcloudcli/tccli）
**安装配置**：
1. 安装腾讯云CLI：`pip install tccli`
2. 配置密钥：`tccli configure`（输入SecretId/SecretKey）
---
## 五、清除后必做：验证是否生效（3种方法）
### 方法1：浏览器验证（最直观）
1. 按**F12**打开开发者工具 → **Network**面板
2. 勾选**Disable cache**（禁用浏览器缓存）
3. 访问目标URL，查看响应头：
- 第一次：`X-Cache: MISS`（已回源拉取新内容）
- 第二次：`X-Cache: HIT`（新缓存已生成）{insert\_element\_11\_}
4. 或用**无痕模式**测试，避免本地缓存干扰
### 方法2：控制台验证
- 进入**缓存刷新** → **刷新记录**，确认任务状态为**成功**
- 查看执行时间和区域，确保覆盖目标用户区域
### 方法3：文件内容对比
- 对比CDN返回内容与源站文件MD5值，确认一致
---
## 六、腾讯云CDN清除缓存常见坑（必看）
### 坑1：刷新后还是旧内容（最常见）
- 原因：只清了CDN，没清**浏览器缓存**
- 解决：按`Ctrl+Shift+R`（Windows）/`Cmd+Shift+R`（Mac）强制刷新，或用无痕模式
### 坑2：刷新失败/配额不足
- 原因：超出每日刷新限额
- 解决：优先用**URL刷新**，必要时提交工单提升配额（企业用户可申请更高额度）
### 坑3：境外节点刷新慢
- 原因：海外节点同步延迟
- 解决：预留**15-30分钟**生效时间，或分区域单独刷新
### 坑4：带参数URL清不掉
- 原因：URL参数被视为不同资源（如`logo.png?v=1`和`logo.png?v=2`）
- 解决：腾讯云支持**自动去参数刷新**，或统一资源命名（如`logo-v2.png`）
### 坑5：刷新后源站压力暴增
- 原因：大批量刷新导致CDN集中回源
- 解决：先**预热**新资源，再刷新旧缓存；分批次操作，避开访问高峰
---
## 七、最佳实践（效率+成本双优）
1. **优先URL刷新，少用目录刷新**：减少回源压力，提高命中率
2. **文件更新用版本号**：如`logo.png`→`logo-v2.png`，无需清除缓存，立即生效
3. **建立刷新流程**：内容更新 → 提交刷新 → 验证生效 → 通知测试
4. **自动化刷新**：结合CI/CD流程，用API自动触发刷新（如发布后自动刷新相关资源）
---
## 八、快速参考：常用操作速查表
| 操作场景 | 推荐方式 | 限额/注意事项 |
|---------|---------|--------------|
| 单文件更新 | URL刷新 | 每日10000条，每次1000条 {insert\_element\_12\_} |
| 多文件更新 | 目录刷新（变更资源） | 每日100条，每次500条 {insert\_element\_13\_} |
| 版本发布 | 预热新资源 → 刷新旧资源 | 预热无强制限额 |
| 紧急修复 | 一键刷新域名全部缓存 | 慎用！影响所有用户 |
|
咨询服务热线：400-099-8848
