English version

第一次接入 CDN，最容易出问题的通常不是某个开关，而是切换顺序。DNS 改早了，流量可能在证书或回源尚未就绪时进入新链路；旧入口关早了，回滚又会变得困难。

下面按一次真实上线的顺序操作。开始前请保留源站原有入口和 DNS 记录，并优先选择测试域名或低风险业务域名。

不同账户、套餐和服务区域可见的选项可能不同。以 Console 中实际显示的状态和提示为准。

接入流程与变更前准备

接入本身分为六步：

  1. 添加域名和源站；
  2. 完成域名归属验证；
  3. 配置业务域名的 CNAME；
  4. 检查 TLS 与回源连接；
  5. 配置缓存和 WAF；
  6. 用访问日志、状态码和用量确认上线结果。

完成这六步后，再用日志、用量和账单观察一段时间。确认主要地区解析正常、HTTPS 无误且回源稳定后，才考虑下线旧入口。

1. 账户状态与权限检查

打开 IXCDN Console。如果尚未登录，页面会跳转到登录入口。

不要急着添加域名，先确认：

  • 当前账户和语言是否正确；
  • 账户是否有域名管理权限；
  • 用量或余额是否存在限制提示；
  • 安全页面是否建议开启 MFA 或更新密码。

2. 域名与源站配置

进入 域名 页面，找到“接入新域名”。

需要填写：

  • 域名：例如 app.example.com；
  • 源站：源站主机名或 IP:端口；
  • 回源协议：根据源站实际监听选择 HTTP 或 HTTPS；
  • 校验源站证书：HTTPS 源站建议保持开启；
  • 同时接入 www：需要同时服务根域与 www 时使用。

提交后看见域名没有立即变成 Active 是正常的。IXCDN 会先验证归属，避免其他账户接入不属于自己的域名。

3. DNS TXT 所有权验证

打开刚创建的域名详情，Console 会显示需要添加的 DNS TXT 记录。前往当前权威 DNS 服务商，按页面给出的记录名和值创建 TXT 记录。

等待 DNS 生效后回到 Console，点击检查验证。验证结果可能经历：

  • pending：等待验证；
  • verified：归属验证成功；
  • failed：没有查到正确记录，或记录值不匹配。

验证失败时不应反复删除并重建域名。应依次检查 DNS Zone、服务商是否自动补全主机记录，以及 TXT 值中是否存在额外的引号或空格。

4. CNAME 切流与回滚准备

验证成功后，Console 会给出一个以 cdn.agslb.com 结尾的专属 CNAME 别名，例如：

app.example.com.cdn.agslb.com

在业务域名的 DNS 服务商处，将 app.example.com 指向 Console 显示的完整别名。不要自行猜测或缩短目标值。

DNS 修改后，域名状态可能依次显示为 pending_dns、propagating 和 active。传播需要时间，各地结果也可能暂时不同。此时保留源站原有入口，等主要服务地区都解析到新入口后再继续。

5. 终端 TLS 与回源 TLS 校验

进入域名详情的 连接 与 TLS 页面，检查：

  • 源站地址和端口；
  • HTTP/HTTPS 回源协议；
  • HTTPS 源站证书校验；
  • 必要时设置的回源 SNI；
  • 是否将访客 HTTP 请求重定向到 HTTPS；
  • 边缘证书状态和有效期。

IXCDN 租户控制台中的域名接入、源站、CNAME、验证与 WAF 配置视图

如果源站使用自签名证书，关闭证书校验只能作为临时诊断措施。生产环境应部署有效证书；确需私有证书链时，应联系支持团队确认回源方式。

6. 缓存策略基线

进入 缓存 页面。第一次上线建议从保守策略开始：

  • 静态资源开启缓存；
  • HTML 和 API 根据业务实时性决定；
  • 登录、支付、用户中心等个性化路径保持不缓存；
  • 先使用合理的默认 TTL，再根据命中率调整；
  • 发布新版本后按需清理相关缓存。

保存规则后到 用量 页面看命中率和回源流量。命中率低不一定是故障；但如果图片、脚本等静态资源始终回源，就要检查响应头、缓存规则和 URL 参数是否让同一内容无法复用。

7. WAF 检测与阻断模式切换

进入 安全 页面，为新域名选择 WAF 策略。

推荐顺序：

  1. 使用 detect 模式观察正常业务；
  2. 在 WAF 事件中检查命中的路径、IP 和动作；
  3. 处理明显误报；
  4. 确认业务兼容后切换到 block。

最严格的策略不一定最适合当前业务。API 请求体、文件上传和一些特殊参数都可能触发规则，切换到阻断前要先确认误报范围。

8. 日志排障流程

进入 日志 页面，先选择域名和时间范围，再使用顶部条件或列头漏斗筛选：

  • 状态码；
  • 请求路径；
  • 客户端 IP；
  • HTTP 方法；
  • 缓存状态；
  • 边缘节点。

访问日志用来确认具体请求，状态码分布用来判断问题是否集中，WAF 事件则说明安全策略有没有参与处理。

常见排查顺序：

  1. 用状态码锁定 4xx 或 5xx；
  2. 按路径查看是否集中在某个接口；
  3. 检查缓存状态和节点；
  4. 对照 WAF 事件确认是否被安全策略处理；
  5. 如果是 5xx，再检查源站健康和回源连接。

9. 上线后的用量与计费监控

在 用量 页面查看请求数、出流量、缓存命中率和主要域名；在账单页面核对当前计费周期、余额或套餐状态。

上线后的第一周建议每天检查：

  • 出流量是否符合预期；
  • 缓存命中率是否稳定；
  • 4xx/5xx 是否持续增长；
  • 是否出现异常 IP、路径或节点；
  • 用量是否接近预算或服务上限。

上线检查清单

  • 域名归属已验证；
  • 业务域名已指向 Console 给出的完整 CNAME；
  • 域名状态为 Active；
  • HTTP 与 HTTPS 均按预期访问；
  • 源站证书校验正常；
  • 动态和个性化路径未被错误缓存；
  • WAF 已完成 detect 观察；
  • 日志中可看到真实请求、状态码和缓存结果；
  • 用量和账单状态正常；
  • 源站旧入口仅在确认稳定后再下线。

如果还在评估接入范围，可继续阅读 CDN 生产评估的六项技术指标。