技能介绍

为什么需要把域名接入 EdgeOne

当源站直接暴露在公网时，通常要面对三个现实问题：单点源站承受所有请求，跨地域访问延迟难以控制；默认 HTTP 站点无法满足浏览器对 HTTPS 的要求；恶意扫描与 DDoS 流量直接打到源站 IP，缺少边缘防护。EdgeOne 是腾讯云的边缘安全加速平台，通过在边缘节点缓存静态内容、统一签发与托管 HTTPS 证书，并在边缘侧过滤异常流量，缓解上述压力。

这个技能解决的问题很具体：用 tccli 的 teo 服务把已有站点接入 EdgeOne，获得 CDN 加速、免费 HTTPS 与安全防护能力，而不必在控制台手工点击。

技能如何工作

技能围绕一条清晰的工作流展开：

确认站点信息：读取已有站点的 ZoneId 与接入类型。类型有两种：dnsPodAccess 表示 NS 接入，DNS 交给 EdgeOne 托管，需要把域名 NS 指向 EdgeOne 指定地址；cnameAccess 表示 CNAME 接入，DNS 仍在原服务商，只需添加一条指向 EdgeOne 的 CNAME 记录。
创建加速域名：调用 CreateAcceleratedDomain 指定 DomainName、OriginType、Origin 与 OriginPort。回源类型支持 IP、域名与 COS 三种，端口默认 80。
配置 HTTPS：通过站点配置开启免费证书（Let's Encrypt），也可单独执行申请，从而替代手工签发与续期流程。
验证 CNAME 接入：dnsPodAccess 站点由 EdgeOne 管理 DNS，无需手动配置；cnameAccess 站点则需在 DNSPod 添加 CNAME 记录指向 EdgeOne 分配的地址。
回源策略（可选）：按业务需要调整缓存规则与回源行为。

配置修改后通常 1 到 5 分钟生效。

适用边界与注意点

这个技能只负责 CDN 层，不涉及服务器侧部署。它与 service-deploy 的分工是：后者负责 nginx、后端与 DNSPod A 记录直连，本技能负责 EdgeOne 接入、HTTPS、缓存与防护。推荐顺序是先确保源站可访问，再叠加 CDN 层。接入完成后，DNSPod 上的 A 记录可以删除，改为 EdgeOne 托管 DNS。

使用前需要满足三个前提：tccli 已配置腾讯云 API 密钥并可访问 teo 服务；EdgeOne 站点已创建（通过控制台或 CreateZone）；源站在 80 或 443 端口可访问。免费版有流量限制，适合中小站点。NS 接入需要到注册商修改 NS 服务器，切换期间可能出现短暂不可用。调用 tccli teo 时参数使用驼峰命名，例如 --ZoneId 而不是 --zone-id。