配置CNAME常见问题 - CDN

添加 CDN 加速域名后，CDN 会分配一个 CNAME 地址。将加速域名的解析记录指向该 CNAME 地址后，CDN 加速服务即可生效。本文介绍配置CNAME过程中的常见问题。

如何测试 CNAME 解析是否生效？

在CDN控制台完成CNAME配置后，使用 nslookup 或 dig 等查询工具验证。不推荐使用 ping 命令，其返回的解析信息可能不准确。

Windows

nslookup -type=CNAME <加速域名>

如果返回的结果和CDN提供的CNAME值相等，则证明CNAME解析生效。

Linux/Mac OS

在Linux或Mac OS系统的终端（Terminal）中，使用 dig 命令验证：

仅查询CNAME目标地址（推荐）：
```
dig +short <加速域名> CNAME
```
如果返回的结果和CDN提供的CNAME值相等，则证明CNAME解析生效。结果示例如下：
```
dig +short cdn.example.com CNAME
cdn.example.com.w.alikunlun.com.
```
查询域名详细信息：
```
dig <加速域名> CNAME
```
如果ANSWER SECTION的CNAME值和CDN提供的CNAME值相等，则证明CNAME解析生效。

查询结果显示 `NXDOMAIN` 或找不到记录怎么办？

按以下步骤排查：

检查域名拼写：确认查询命令中输入的域名无误。
检查DNS配置：登录DNS解析控制台，检查CNAME记录是否存在、主机记录是否正确。主机记录应填写加速域名的前缀部分，而非完整域名。例如，加速域名为 cdn.example.com 时，主机记录应填写 cdn，而非 cdn.example.com。
等待DNS生效：DNS记录修改后，全局生效需要时间，可等待后重试。
说明
DNS记录的全球生效时间取决于其TTL。例如，如果旧记录的TTL是10分钟，那么新记录的生效时间至少为10分钟。在修改CNAME前，建议将原记录的TTL设置为较短时间（如60秒）。

查询到了A记录，但没有CNAME记录，或配置 CNAME 时提示与 A 记录冲突怎么办？

同一主机记录不能同时存在 A 记录和 CNAME 记录。冲突提示说明该主机记录下已存在 A 记录或其他类型记录，解决方法如下：

登录 DNS 解析控制台，找到冲突的 A 记录（或 MX、TXT 等记录）。
删除或暂停该冲突记录。
重新添加 CNAME 记录，将记录值指向 CDN 分配的 CNAME 地址。

说明

删除 A 记录后，原解析流量将中断。建议先用子域名测试验证 CDN 加速正常后再切换主域名。
建议在业务低峰期操作。
如果域名已开启全局流量管理（GTM）的健康检查，GTM 可能自动创建解析记录导致冲突，需先在 GTM 中处理后再添加 CNAME。

CDN 域名配置完成后，控制台状态仍显示"待配置"或"验证不通过"怎么办？

配置完成后，通常需要 5~30 分钟生效，实际以配置域名解析时选择的TTL为准。全网解析生效后，CDN控制台状态将显示正常。请等待后刷新控制台页面查看状态。

如果等待后域名状态未更新，请按以下步骤排查：

检查主机记录是否正确：须与加速域名前缀一致，例如 a.example.com 对应 a，example.com 对应 @。常见错误是填写了 www 但加速域名并非 www.example.com。
检查 CNAME 记录值是否匹配：须与 CDN 控制台显示的 CNAME 地址完全一致，建议直接从控制台复制。
使用 nslookup 或dig命令验证：确认返回的 CNAME 指向 CDN 分配的地址。
检查是否有冲突记录：确认已删除同一主机记录下的 A 记录或其他冲突记录。

控制台显示 CNAME 未配置但实际已解析

在以下场景中，CDN 控制台可能显示CNAME状态为未配置，但实际加速功能已正常运行，不影响实际使用：

加速区域不含中国内地：如果在添加加速域名时将加速区域设置为全球（不包含中国内地）（对应 API 参数 Scope 取值为 overseas），在中国内地网络环境下检测 CNAME 时会提示未配置。这是正常现象，不影响目标加速区域的正常使用。可以通过以下方式验证境外加速是否生效：
1. 使用 nslookup或dig 命令或在 CDN 控制台确认域名已解析到 CDN 分配的 CNAME 地址。
2. 在非中国内地网络环境下访问加速资源，通过浏览器开发者工具查看响应头，若 X-Cache 字段值为 HIT，则表示 CDN 缓存命中，加速已生效。
配置了分线路 DNS 解析：如果在 DNS 服务商处配置了按解析线路区分的记录（例如中国内地线路解析到 CDN 的 CNAME 地址、非中国内地线路解析到源站 IP），CDN 控制台可能因检测到部分线路未解析到 CDN 而显示"CNAME 未配置"。只要目标区域的用户能正常访问加速资源，即可忽略该提示。
DNS 解析延迟：新配置或修改 CNAME 记录后，DNS 解析全网生效通常需要几分钟到数小时（取决于 TTL 设置）。在此期间控制台可能显示未配置，请稍后再检查。

一个域名是否可以配置多个 CNAME 记录指向不同的 CDN 地址？

不支持。同一主机记录只能配置一个 CNAME 记录值，配置多个可能导致访问报错（如返回 403 错误）。

解决方法：确保同一主机记录下只保留一条 CNAME 记录，记录值指向当前使用的 CDN 加速域名对应的 CNAME 地址。如有多余记录请删除。

泛域名 CNAME 解析对子域名的影响？

配置泛域名（如 *.example.com）的 CNAME 解析后，所有未单独配置解析的子域名（如 a.example.com、b.example.com）将自动继承泛域名解析。如果某些子域名不需要 CDN 加速，需为其单独配置 A 记录或其他类型记录。具体子域名的解析记录优先级高于泛域名，不会被覆盖。

说明

解析优先级规则可能因 DNS 服务商而异。