QQiabot 全部文档
全部文档 / 常见问题

自有域名接入 CDN 教程

您的自有域名该如何接入 CDN？

一、前情提要

**名词说明：**本文中的“客户域名”或“客户绑定域名”，均指您需要绑定到本平台的自有域名，例如 chat.yourdomain.com，不是平台提供的中间域名。

客户域名原本通过 CNAME 直接接入平台：

客户绑定域名 → 平台中间域名 → 平台服务

增加 CDN 后，访问链路变为：

客户绑定域名 → CDN CNAME → CDN 节点 → 平台中间域名 → 平台服务

因此需要同时完成两项配置：

  1. 在 CDN 中，将平台中间域名配置为源站；
  2. 在 DNS 中，将客户绑定域名 CNAME 到 CDN 分配的地址。

CDN 可以改善访问线路和稳定性，但不能保证解决所有地区、运营商或域名层面的访问限制。

二、准备信息

以下域名仅为示例，实际配置时请替换为真实地址：

信息 示例
客户绑定域名 chat.customer.com
平台中间域名 customer-123.origin.example.com
CDN 分配的 CNAME chat.customer.com.cdn-provider.net

三、配置 CDN

在 CDN 控制台添加客户绑定域名，并按下表配置回源：

配置项 填写内容 示例
加速域名 客户绑定域名 chat.customer.com
源站类型 域名源站 域名
源站地址 平台中间域名 customer-123.origin.example.com
回源 Host 客户绑定域名 chat.customer.com
回源协议 跟随协议 跟随协议

不同 CDN 厂商可能将“回源 Host”称为“源站 Host”“Host Header”或“回源请求头 Host”。

注意：

  • 源站必须填写平台中间域名，不能填写客户绑定域名或 CDN CNAME，否则可能形成回源循环；
  • 回源 Host 必须填写客户绑定域名，用于让平台识别对应的客户站点；
  • 域名字段不要带 http://、https://、端口或路径；
  • “跟随协议”表示用户通过 HTTPS 访问时，CDN 也通过 HTTPS 回源；HTTP 同理。

四、配置 HTTPS 和 WebSocket

如果使用 HTTPS，需要在 CDN 侧配置覆盖客户绑定域名的有效证书。

如果系统包含实时聊天或消息推送功能，还需要：

  • 开启 WebSocket；
  • 避免缓存登录、接口和 WebSocket 请求；
  • 不建议直接开启激进的全站缓存。

如果 CDN 还有“回源 SNI”或“源站证书校验域名”等选项，出现 SSL 握手或源站证书错误时，请将配置截图提交平台技术确认。

五、修改 DNS CNAME

CDN 配置完成后，CDN 厂商会分配一个 CNAME 地址。登录域名 DNS 控制台，将客户绑定域名指向该地址。

以 chat.customer.com 为例：

DNS 配置项 填写内容
主机记录 chat
记录类型 CNAME
记录值 CDN 分配的 CNAME 地址
TTL 默认值

最终关系应为：

chat.customer.com
  → CNAME → chat.customer.com.cdn-provider.net
  → CDN 回源 → customer-123.origin.example.com

注意：

  • DNS 中填写的是 CDN 分配的 CNAME，不是平台中间域名；
  • 同一主机名不能同时保留冲突的 A、AAAA 或其他 CNAME 记录；
  • DNS 修改后需要等待 TTL 和各地缓存生效；
  • 根域名可能不支持标准 CNAME，建议优先使用子域名，或确认 DNS 厂商是否支持 ALIAS、ANAME 或 CNAME Flattening。

六、验证配置

  1. 使用 DNSChecker CNAME Lookup 查询完整绑定域名，不要带协议和路径；
  2. 确认域名已指向 CDN 分配的 CNAME；
  3. 访问 https://客户绑定域名，确认页面和证书正常；
  4. 测试登录、接口及实时消息功能；
  5. 建议分别使用 Wi-Fi 和移动网络测试。

部分 CDN/DNS 厂商会扁平化 CNAME，查询结果可能只显示 A/AAAA 地址，此时还需结合 CDN 控制台状态判断。

七、快速排错

现象 优先检查
NXDOMAIN 或无解析记录 DNS 主机记录、记录值及生效状态
CNAME 仍是平台中间域名 DNS 尚未切换到 CDN CNAME
404、403 或默认页面 回源 Host 是否为客户绑定域名
502、504 源站地址、回源协议、端口、SNI 及源站连通性
HTTPS 证书错误 CDN 前端证书及回源 TLS/SNI 配置
页面反复跳转 HTTP/HTTPS 回源与强制跳转规则
页面正常但登录或消息异常 WebSocket、接口缓存及 CDN 安全规则

如仍无法访问，请向平台客服提供：绑定域名、平台中间域名、CDN CNAME、CDN 厂商名称、源站/Host/协议配置截图、DNS 截图、完整报错、出错时间、地区和运营商。

八、最终配置示例

【DNS】
chat.customer.com
  → CNAME → chat.customer.com.cdn-provider.net

【CDN】
加速域名：chat.customer.com
源站地址：customer-123.origin.example.com
回源 Host：chat.customer.com
回源协议：跟随协议
HTTPS 证书：覆盖 chat.customer.com
WebSocket：开启