| name | byted-volc-cdn-manage |
| description | 通过火山引擎 CLI 管理 CDN 域名。支持新增域名和刷新预热, 使用时会先检查并安装 CLI（如需要）。 |
| license | MIT |
| compatibility | Requires Volcengine CLI >= 1.0.39, access to Volcengine API |
| metadata | {"version":"2.0","author":"ByteDance"} |
火山引擎 CLI CDN 管理助手
本 Skill 帮助您通过火山引擎 CLI 管理 CDN 加速域名，包括新增域名、刷新和预热。
📋 功能说明
本 Skill 提供以下功能：
1. 新增域名
- 交互式配置
- 支持多种业务类型（web/download/video）
- 自动应用推荐配置
- 支持中国内地和全球加速
2. 刷新预热
- 刷新任务：清除 CDN 节点上的缓存内容（支持文件刷新和目录刷新）
- 预热任务：主动将源站内容预热到 CDN 节点
📋 智能流程（新增域名）
本 Skill 会自动执行以下流程：
第一阶段：环境检查
- 检查 CLI 是否已安装
- 如果未安装：引导您安装并配置火山引擎 CLI
- 如果已安装：检查 CLI 版本（需 >= 1.0.39）
第二阶段：需求收集
- 检查必填项：加速域名、区域、源站信息、业务类型
- 使用默认值：
- 区域默认：
chinese_mainland（中国内地）
- 项目默认：
default
- 推荐配置：根据业务类型自动应用推荐配置规则：
- web（网页加速）：缓存规则、智能压缩、页面优化
- download（下载加速）：缓存规则、分片回源、缓存键、302跟随
- video（视频点播）：缓存规则、分片回源、缓存键、302跟随、视频拖拽
- 询问用户：必填项找不到默认值时，引导用户输入
第三阶段：添加域名
- 收集完整信息后，执行
ve cdn AddCdnDomain 命令
- 展示执行结果和后续步骤
📋 刷新预热流程
提交预热任务：
- 选择预热操作
- 输入要预热的 URL 列表
- 确认并提交任务
提交刷新任务：
- 选择刷新操作
- 选择刷新类型（文件/目录）
- 输入要刷新的 URL 列表
- 确认并提交任务
🚀 快速开始
前置条件
- 火山引擎 CLI 版本 >= 1.0.39（此版本及以上才支持 CDN 服务）
- 已配置好 AK/SK 和 Region
验证环境
ve version
ve configure list
添加域名
方式一：使用交互式脚本（推荐）
bash scripts/add-cdn-domain.sh
方式二：使用快速脚本（命令行参数）
bash scripts/add-domain-quick.sh www.example.com 1.1.1.1 "" "" 100 "" "" web chinese_mainland
bash scripts/add-domain-quick.sh www.example.com 1.1.1.1 "" "" 100 "" "" web global
bash scripts/add-domain-quick.sh video.example.com 1.1.1.1 "" "" 100 "" "" video
方式三：直接使用命令（基础版）
BODY='{
"Domain": "www.example.com",
"Origin": [
{
"OriginAction": {
"OriginLines": [
{
"Address": "1.1.1.1",
"InstanceType": "ip",
"OriginType": "primary"
}
]
}
}
],
"Project": "default",
"ServiceRegion": "chinese_mainland",
"ServiceType": "download"
}'
ve cdn AddCdnDomain --body "$BODY"
方式四：使用推荐配置命令（推荐版）
网页加速示例：
BODY='{
"Domain": "www.example.com",
"Origin": [
{
"OriginAction": {
"OriginLines": [
{
"Address": "1.1.1.1",
"InstanceType": "ip",
"OriginType": "primary"
}
]
}
}
],
"Project": "default",
"ServiceRegion": "chinese_mainland",
"ServiceType": "web",
"Cache": [
{
"CacheAction": {
"Action": "cache",
"IgnoreCase": false,
"Ttl": 0,
"DefaultPolicy": "no_cache"
},
"Condition": {
"ConditionRule": [
{
"Object": "filetype",
"Operator": "match",
"Type": "url",
"Value": "php;jsp;asp;aspx"
}
]
}
},
{
"CacheAction": {
"Action": "cache",
"IgnoreCase": false,
"Ttl": 2592000,
"DefaultPolicy": "default"
},
"Condition": {
"ConditionRule": [
{
"Object": "path",
"Operator": "match",
"Type": "url",
"Value": "/*"
}
]
}
}
],
"Compression": {
"Switch": true,
"CompressionRules": [
{
"CompressionAction": {
"CompressionType": ["gzip"],
"CompressionFormat": "default",
"CompressionTarget": "*",
"MinFileSizeKB": 0
}
}
]
},
"PageOptimization": {
"PageOptimizationAction": "on"
}
}'
ve cdn AddCdnDomain --body "$BODY"
更多业务类型的推荐配置请参考 参数说明。
📚 详细文档
✅ 成功响应示例
{
"ResponseMetadata": {
"Action": "AddCdnDomain",
"Region": "cn-guangzhou",
"RequestId": "20260415170258108D89026C070556E439",
"Service": "cdn",
"Version": "2021-03-01"
},
"Result": {
"ResourceIds": [
"www.example.com"
]
}
}
🔄 刷新和预热
提交预热任务
方式一：使用交互式脚本（推荐）
bash scripts/cdn-refresh-preload.sh
方式二：使用快速脚本
bash scripts/submit-preload.sh https://www.example.com/1.jpg https://www.example.com/2.jpg
方式三：直接使用命令
BODY='{
"UrlList": [
"https://www.example.com/1.jpg",
"https://www.example.com/2.jpg"
]
}'
ve cdn SubmitPreloadTask --body "$BODY"
提交刷新任务
方式一：使用交互式脚本（推荐）
bash scripts/cdn-refresh-preload.sh
方式二：使用快速脚本
bash scripts/submit-refresh.sh https://www.example.com/1.jpg https://www.example.com/2.jpg
bash scripts/submit-refresh.sh --type directory https://www.example.com/path/
方式三：直接使用命令
刷新文件：
BODY='{
"Type": "file",
"UrlList": [
"https://www.example.com/1.jpg",
"https://www.example.com/2.jpg"
]
}'
ve cdn SubmitRefreshTask --body "$BODY"
刷新目录：
BODY='{
"Type": "directory",
"UrlList": [
"https://www.example.com/path/"
]
}'
ve cdn SubmitRefreshTask --body "$BODY"
📝 添加域名后的步骤
-
等待生效：创建成功后，域名状态会从「配置中」变为「正常运行」（通常需要 1-5 分钟）
-
获取 CNAME：
ve cdn DescribeCdnConfig --Domain "www.example.com"
-
配置 DNS：在您的 DNS 服务商处将域名解析指向 CNAME
-
验证访问：等待 DNS 生效后，测试访问
🔗 相关文档
