核心功能: 本技能提供化工作流场景等能力。

CDN

专业版增强能力

主要能力

• CDN 配置部署与域名接入，支持 CNAME 接入、NS 接入、ANS 接入三种模式
• 缓存策略优化：TTL 规则、缓存键（Cache-Key）配置、查询字符串排序与忽略、Vary 头处理
• 安全加固：WAF 规则、DDoS 防护、防盗链（Referer/Token）、HTTPS 强制与 HSTS、IP 黑白名单
• 性能调优：Brotli/Gzip 压缩、图片优化（WebP/AVIF 自适应）、HTTP/2 与 HTTP/3、边缘函数（Edge Functions）
• 故障排障：缓存命中率分析、回源诊断、HTTP 状态码分析、边缘节点探测、DNS 解析链路追踪
• 多 CDN 智能调度与容灾切换，支持按地域、运营商、权重分配流量

快速入门

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

应用场景

不适用于：需要人工判断的复杂决策场景

操作流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

流程详解：缓存策略配置

以一个典型电商站点为例，完整的缓存策略配置步骤如下：

步骤 1：资源分类与 TTL 规划

步骤 2：缓存键配置

查询字符串处理策略选择依据：

• 忽略全部参数：适用于图片等静态资源，URL a.jpg?ver=1 和 a.jpg?ver=2 共享同一缓存
• 保留全部参数：适用于 API 或动态页面
• 保留指定参数：适用于同时含版本号和追踪参数的场景，如保留 ver 忽略 utm_source
• 参数排序：?b=2&a=1 与 ?a=1&b=2 归一为同一缓存键，避免缓存冗余

步骤 3：验证缓存命中

# 检查响应头中的缓存命中状态
curl -sI "https://example.com/static/app.js" | grep -i "cf-cache-status\|x-cache\|age\|hit"

# Cloudflare 返回示例: cf-cache-status: HIT
# AWS CloudFront 返回示例: X-Cache: Hit from cloudfront
# 阿里云 CDN 返回示例: X-Cache: HIT

缓存策略优选实践

避免缓存穿透

对于不存在的资源（404），建议设置短 TTL（如 10 秒），防止恶意请求绕过缓存直接打到源站：

# Cloudflare Page Rule 示例
匹配: *example.com/non-existent/*
设置: 缓存级别 -> 缓存所有内容, Edge Cache TTL -> 10s

动态内容缓存

即使 API 响应为 JSON，如果数据更新频率低于请求频率，仍可在边缘缓存：

# Cache-Control 头部配置
Cache-Control: public, max-age=30, s-maxage=300
# s-maxage=300 让 CDN 缓存 5 分钟，max-age=30 让浏览器缓存 30 秒

缓存预热与刷新

• 预热：在发版前主动将新版本静态资源推送到边缘节点，避免首次访问回源延迟
• 刷新：紧急修复后清除旧缓存，注意刷新粒度（按 URL 刷新 vs 按 目录刷新 vs 全量刷新）
• 灰度刷新：先刷新部分节点，观察无异常后再全量刷新

安全加固指南

HTTPS 强制跳转与 HSTS

# Nginx 源站配置
server {
    listen 80;
    return 301 https://$host$request_uri;
}

# HSTS 头部（通过 CDN 全局添加）
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload

防盗链配置

• Referer 防盗链：检查请求头 Referer，允许白名单域名，阻止空 Referer（根据业务需求）
• Token 鉴权：生成带过期时间的签名 URL，适用于付费内容保护

# 签名 URL 格式示例
https://cdn.example.com/video.mp4?auth_key=1700000000-0-0-abc123hash
# auth_key = 过期时间戳-随机数-用户ID-MD5签名

WAF 规则配置要点

主流 CDN 平台配置对照

故障排障速查

场景 1：缓存命中率低（< 80%）

排查步骤：

1. 检查 Cache-Control 头是否包含 no-cache、private、no-store
2. 检查查询字符串参数是否过多导致缓存键碎片化
3. 检查是否存在 Vary: * 或 Vary: User-Agent 导致缓存失效
4. 检查回源频率，确认源站是否返回 Set-Cookie 导致 CDN 不缓存

场景 2：内容更新后仍显示旧版本

# 1. 确认缓存是否已被刷新
com/page.html" | grep -i "age\|x-cache"

# 2. 检查文件名是否带版本号（推荐方案）
# 错误做法: app.js  (更新后需手动刷新缓存)
# 正确做法: app.v2.1.0.js  (文件名变更自动绕过缓存)

# 3. 紧急情况：通过 API 强制刷新
# Cloudflare
curl -X POST "https://api.cloudflare.com/client/v4/zones/{zone_id}/purge_cache" \
  -H "Authorization: Bearer {token}" \
  -d '{"files":["https://example.com/page.html"]}'

场景 3：CDN 节点回源超时

可能原因与处理：

• 源站带宽瓶颈 -> 升级源站带宽或启用 CDN 源站负载均衡
• 源站防火墙拦截 CDN 回源 IP -> 将 CDN 回源 IP 段加入白名单
• 源站响应慢（> 30 秒） -> 检查源站数据库和后端服务性能
• 回源 Host 配置错误 -> 确认回源 Host 与源站虚拟主机配置匹配

请求格式

响应格式

{
  "success": true,
  "data": {
    "domain": "cdn.example.com",
    "status": "configured",
    "cache_hit_rate": "94.2%",
    "edge_nodes": 42,
    "config_summary": {
      "cache_rules": "8 条规则已生效",
      "https": "已启用, HSTS 已配置",
      "compression": "Brotli + Gzip",
      "waf": "已启用, 12 条规则"
    },
    "performance": {
      "avg_ttfb_ms": 45,
      "bandwidth_saved": "78.5%"
    },
    "metadata": {
      "template_used": "cdn-optimizer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

异常管理

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

疑问解答

Q1: 如何开始使用CDN？

A: 首先在 CDN 服务商控制台添加加速域名，配置源站地址（IP 或域名）。然后根据业务类型设置缓存规则（静态资源长缓存、动态内容不缓存）。配置完成后在域名 DNS 解析中添加 CNAME 记录指向 CDN 分配的域名。等待 DNS 生效后（通常 5-30 分钟），通过 curl -sI 检查响应头中的 X-Cache 字段确认缓存是否命中。

Q2: 如何提升缓存命中率？

A: 1) 确保 Cache-Control 头设置合理，避免使用 no-cache/private；2) 对查询字符串进行规范化，忽略无意义参数（如 utm 追踪参数）；3) 对版本化静态资源使用长 TTL；4) 避免不必要的 Vary 头（如 Vary: User-Agent 会导致缓存碎片化）；5) 定期检查缓存命中率报表，优化低命中率的 URL。

Q3: CDN 回源频繁如何排查？

A: 使用 CDN 控制台的回源日志或实时日志分析功能，筛选回源请求。常见原因包括：缓存 TTL 设置过短、源站返回 Set-Cookie 头导致 CDN 不缓存、Cache-Control: private 配置、查询参数变化导致缓存键不匹配。可通过 curl -sI 检查源站返回的响应头确认问题。

错误恢复

创新亮点

效率提升量化分析

差异化对比

核心痛点解决

故障应对方案

安全声明

1. [与「CDN内容分发管理工具」相关的安全注意事项]
   • 确保SSL证书有效且定期更新。
   • 配置WAF规则时，避免误报和漏报。
   • 定期检查IP黑白名单，防止恶意IP访问。
   • 设置合理的缓存策略，避免敏感数据泄露。
   • 监控CDN流量，及时发现异常流量并进行处理。

主要功能

• 自动化执行: 配置优化排障CDN部署,缓存策略+安全加固,加速又稳。Configure, optimize, and troubles
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

FAQ

Q1: CDN内容分发管理工具支持哪些输入格式？

A1: 配置优化排障CDN部署,缓存策略+安全加固,加速又稳。Configure, optimize, and troubleshoot CDN deployments。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

错误处理机制

针对CDN内容分发管理工具使用中可能遇到的常见问题,提供以下排查方案:

CDN内容分发管理工具通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪