CNAME配置排障指南

更新时间:
复制 MD 格式

本文介绍 CNAME 配置与解析异常的排查方法。

基础自检:区分解析与访问异常

CNAME(Canonical Name)记录指域名解析中的别名记录,用来把一个域名解析到另一个域名(CNAME域名),再由CNAME域名来解析到需要访问的服务器IP地址。尚未配置 CNAME 时,可在 CDN 控制台获取为加速域名分配的 CNAME 地址,并在 DNS 服务商处配置解析记录。获取地址和配置记录的操作方法以及DNS解析的原理,请参见快速接入阿里云 CDN。

遇到控制台状态异常或访问失败时,先从出现问题的客户端网络查询 DNS 解析结果。独立添加的加速域名应使用其专属 CNAME;仅由泛域名配置覆盖的子域名,使用该泛域名分配的 CNAME。

Windows 查询命令

打开命令提示符,查询加速域名的 CNAME 记录,将命令中的占位符替换为实际域名:

nslookup -type=CNAME <加速域名>

Linux 或 macOS 查询命令

打开终端,使用 dig 查询加速域名,根据是否需要查看 DNS 响应状态选择以下命令:

  • 只查看 CNAME 目标:用于与预期地址比较。若没有输出,可以改用详细查询。

dig +short <加速域名> CNAME
  • 查看 DNS 响应状态和答案:用于区分 NXDOMAIN、无 CNAME 答案和其他 DNS 错误。

dig <加速域名> CNAME

检查响应中的 status 和 ANSWER SECTION。

查询结果判断:

  1. 核对响应状态与记录: 请同时确认 DNS 响应中的 status 状态与 ANSWER SECTION 内容,确保返回了有效的解析记录。

  2. 比对查询结果: 将返回的完整 CNAME 地址与控制台预期地址进行全字匹配(仅包含 kunlun 字样不足以证明配置正确)。

    • 比如预期地址为 cdn.example.com.w.alikunlun.com.,末尾的点号(.)代表全限定域名(FQDN),属于正常格式。

    • 单次 CNAME 匹配仅代表当前 Local DNS 解析正常,由于各地 DNS 缓存及应用层链路不同,还需进一步结合 HTTP/HTTPS 实际请求验证业务可用性( ping 测试仅反映网络层连通性,无法替代 CNAME 校验与业务层拨测)。

根据 DNS 查询和实际请求结果,请按以下场景继续定位并保留异常证据:

CNAME 结果不一致或为空:

CNAME 正确但无法访问:

  • 若无HTTP响应,可能是 TLS 握手或证书校验阶段失败。记录浏览器或 curl 的具体错误,并按HTTPS排障指南排障;

  • 若取得HTTP响应,使用浏览器开发者工具查看实际请求的 HTTP 状态码、响应头和错误信息,并与 CDN 及源站日志对照。必要时按回源排障指南继续定位具体原因(5xx 状态码可能由回源链路或网关超时引起,需结合日志确认是否为源站本身故障)。

仅部分地区或客户端访问异常:

分别记录正常与异常请求的时间、地区、DNS 解析器及解析结果、完整 URL、HTTP 状态码、响应头和错误信息。在对比差异、明确根因(DNS、客户端、CDN 配置或源站)后再执行修复操作;排查期间请保持现有公网 DNS 配置与域名启用状态,以免破坏故障现场或引发二次故障。

解析结果异常

CNAME 查询返回 NXDOMAIN、无结果或非预期目标怎么办?

适用于 CNAME 查询提示域名不存在、未返回目标地址,或返回非预期目标的情况。当出现此类异常时,请直接核对 DNS 配置、权威解析结果与缓存状态(dig +short 的空输出会隐藏状态码细节,排查时请使用完整查询命令)。

排查方向:

  • 区分 DNS 响应状态:使用基础自检中的详细查询命令(Linux 或 macOS)查看 status。NXDOMAIN 表示权威 DNS 判定该名称不存在(若响应同时包含 CNAME 链,请逐级核对该链路末端指向的目标名称);状态为 NOERROR 但无对应答案时,属于无对应类型数据响应(NODATA),需与域名不存在区分排查;返回 SERVFAIL、REFUSED 或查询超时则代表解析服务异常,应优先排查权威 DNS 服务及本地解析器状态。

  • 核对名称和权威 DNS 配置:确认查询域名没有拼写错误,并在实际托管该域名的 DNS 服务商处核对记录名称、类型、目标地址和解析线路。例如使用阿里云 DNS 为 cdn.example.com 配置记录时,主机记录通常填写 cdn;部分第三方 DNS 服务商可能要求相对名称或完整名称,应按其填写规则确认最终记录名称。

  • 比较权威 DNS 与Local DNS 结果:先向 DNS 服务商确认该名称所属 DNS 区域的权威 DNS 服务器,再直接查询该服务器。将以下占位符替换为对应服务器和实际域名:

    dig @<权威DNS服务器> <加速域名> CNAME +norecurse

    确认响应包含权威标记 aa,并将结果与客户端本地Local DNS 的查询结果比对。若权威 DNS 未返回预期记录,请重新检查控制台配置;若权威 DNS 已返回新记录、但Local DNS 仍返回旧结果,则属于缓存问题(分线路解析场景还需结合目标线路对应的网络环境分别验证)。

  • 排查 NOERROR 但无 CNAME 结果:确认该名称是否原本就只配置了 A 或 AAAA 记录,或 DNS 服务商是否启用了 CNAME 扁平化等对外返回 IP 地址的机制。对于后者,应按记录冲突与扁平化的判断方法核对配置及实际访问。涉及泛域名时,还应检查子域名是否实际使用泛域名 DNS 记录。

同一域名的 CNAME 查询结果指向多个目标怎么办?

单次 DNS 查询返回多条 CNAME 记录,或不同地区、不同解析器(Local DNS)返回的 CNAME 目标不一致。排查时需重点区分同名多值冲突、CNAME 别名链与分线路解析三种情况。

排查方向:

  • 单次响应中,同一域名对应多个 CNAME 目标(同名多值冲突):请核对该域名在对应线路下的 DNS 配置,排查是否存在违规的多值配置或 DNS 服务商响应异常,并保留唯一的正确记录。(若同时伴随业务访问报错,修复 DNS 冲突后仍需结合实际请求进一步确认 HTTP 层状态)。

  • 单次响应中,出现逐级指向的多条 CNAME(CNAME 别名链): 若返回的多条记录属于“A 指向 B,B 再指向 C”的递进关系(例如 a.example.com → b.example.com → 最终目标),则属于正常的别名链(CNAME 链),并非重复配置。请按链路顺序逐级核对各段目标的准确性,并重点确认最终解析出的 IP 地址及实际 HTTP/HTTPS 访问是否正常。

  • 不同地区或解析器返回不同的 CNAME 目标(分线路解析):不同查询位置各自返回唯一但不同的目标,通常是配置了智能/分线路解析(如按运营商或地域调度)或存在局部 DNS 缓存差异,属于正常的调度机制,而非单次响应的多值冲突。请先在权威 DNS 控制台核对各解析线路的预期目标,并比对各地 DNS 缓存状态;切勿在未区分解析线路的情况下盲目删除其他线路的正常记录,以免导致对应区域的业务中断。

记录配置与控制台状态异常

配置 CNAME 时提示记录冲突,或只查到 A、AAAA 记录怎么办?

DNS 服务商提示同一名称存在记录冲突,与查询未返回 CNAME、只返回 IP 地址,两种情况成因不同,需要分别排查。

排查方向:

  • 有明确的配置冲突提示:根据 DNS 服务商提示核对冲突的记录名称、类型和解析线路。标准 CNAME 不能与同名的普通 A、AAAA、MX 或 TXT 记录并存。若原记录业务不可中断(如根域名配置了 MX 邮件记录),建议改用无冲突的子域名接入 CDN。

  • 没有冲突提示,但查询只返回 A 或 AAAA:先在 DNS 服务商处查看实际配置。如果配置为 A 或 AAAA,请核对它是否符合当前接入方案;如果配置为 CNAME,但服务商启用了扁平化(CNAME flattening)等机制,权威 DNS 对外可能直接返回最终解析出的 IP 地址,从而隐藏中间的 CNAME 链路。

  • 验证返回 IP 的归属:从出现问题的客户端网络查询该名称的 IPv4 和 IPv6 解析结果,分别核对返回地址:

    dig <加速域名> A
    dig <加速域名> AAAA

    结合 DNS 控制台配置,确认上述返回的 IP 是否由 CNAME 目标地址解析得到;同时可使用 CDN 控制台的 IP 检测工具,核实返回的 IP 是否属于阿里云 CDN 节点。

  • 确认冲突后再制定切换方案:先核实原记录承载的网站、邮件等业务,保留现有解析,完成 CDN 访问测试并备份记录后,再评估调整方式;也可以选择不承载冲突业务记录的子域名接入。完整接入与 DNS 配置流程,参见快速接入阿里云 CDN。

    重要

    删除或暂停 A、AAAA 记录可能中断既有访问;调整 MX 或 TXT 记录可能影响邮件收发或域名认证。请确认业务依赖和切换方案后,在业务低峰期操作。

控制台 CNAME 状态与解析不一致怎么办?

症状:已修改 DNS 记录,但控制台 CNAME 状态仍显示待配置、未配置或验证不通过。

排查方向:

先区分域名状态和 CNAME 状态:在 CDN 控制台的域名管理页面上,域名状态显示配置中代表配置正在下发(若已停止加速,请先查看停用原因);CNAME 状态显示待配置仅代表控制台探测机制尚未确认公网解析生效。

排查方向:

  • 查询结果与预期地址不一致或无结果:按基础自检判断 DNS 响应,完整 CNAME 地址及末尾全限定域名点号(.),再核对权威 DNS 中的主机记录、记录值与解析线路配置是否正确。

  • 权威 DNS 已更新,Local DNS 仍返回旧记录:检查旧记录剩余 TTL 或负缓存影响,再查询验证。若命令行实际解析已符合预期,但控制台状态略有延迟,稍后刷新控制台页面即可。

  • 配置了分线路 DNS 解析:请分别从目标用户的实际网络环境发起查询,记录所使用的 Local DNS、解析出的目标地址及业务请求结果。判断某一线路是否可用,需同时满足“该线路返回预期 CNAME 记录”与“实际 HTTP/HTTPS 业务请求正常”两个条件(单次检测结果或控制台加速区域设置不能代表全网所有线路用户的实际访问状态)。

DNS 解析结果已符合预期但业务请求仍异常时,继续按基础自检检查实际请求及日志;若结果持续不一致,保留检测时间、解析器、DNS 答案和请求证据,以便进一步定位。

子域名解析与访问异常

www 子域名访问异常或配置不生效怎么办?

症状:子域名 www.example.com 无法访问,或已将 www 独立添加为加速域名,但其配置不生效。

根因:www.example.com 与根域名 example.com 是互相独立的请求域名,即使根域名访问正常,仍需单独核查 www 子域名的 DNS 解析与 CDN 配置。

排查方向:

  • 检查 CDN 配置是否覆盖 www:确认 CDN 中已添加 www.example.com,或已添加能够覆盖它的泛域名 *.example.com。未独立添加 www、仅由有效泛域名配置覆盖时,www 可以使用该泛域名分配的 CNAME,无需单独添加为精确加速域名;仅添加根域名 example.com 则不会自动覆盖 www。

  • 核对 www 的实际 DNS 答案:按基础自检查询 www,将结果与预期的完整 CNAME 地址比较。www 已独立添加为加速域名时,应使用其专属 CNAME;未独立添加、仅由有效泛域名配置覆盖时,使用该泛域名 CNAME。结果为空时先检查响应状态和 DNS 服务商是否启用了扁平化机制。

  • 检查 www 的实际请求:解析符合预期但仍无法访问或配置未按预期生效时,记录 www 请求的完整 URL、HTTP 状态码、响应头及日志;根域名可正常访问时,再与根域名的请求结果比较。继续按基础自检定位客户端、CDN 配置或回源问题。排查期间请保持现有公网 DNS 解析,以便保留故障现场(可通过绑定本地 Hosts 方式直接测试源站)。

DNS 仍指向泛域名 CNAME 时,精确域名配置不生效怎么办?

适用于 CDN 中同时添加了精确域名 www.example.com 和泛域名 *.example.com,但 www 的 DNS 解析仍指向泛域名 CNAME 的情况。未独立添加 www、仅使用泛域名加速时,www 使用该泛域名 CNAME 属于正常配置。

CDN 为每个加速域名分配对应的 CNAME 地址。将 www.example.com 独立添加为加速域名后,CDN 会为它分配专属 CNAME,该地址与泛域名 *.example.com 的 CNAME 不同。

同时添加精确域名和泛域名时,请求实际生效的配置由 DNS 解析指向的 CNAME 决定:解析到 www 专属 CNAME 的请求按 www 的精确域名配置处理;解析到泛域名 CNAME 的请求按泛域名配置处理。

因此,www 仍解析到泛域名 CNAME 时,请求携带的调度标识属于泛域名,CDN 会按泛域名配置处理该请求。在 www 精确域名上单独设置的源站、缓存规则、HTTPS 证书和访问控制等配置均不会对该请求生效。

www 已独立添加为加速域名、但仍解析到泛域名 CNAME 时,控制台校验会发现 www 未解析到其专属 CNAME,因此该域名的 CNAME 状态可能显示为未配置或待配置。

按定位结果处理

  • 若 www 没有被 CDN 配置覆盖,添加 www 加速域名或对应层级的泛域名,并使用该配置分配的 CNAME。接入操作参见快速接入阿里云 CDN。

  • 若 CDN 配置覆盖正确但 DNS 答案不符合预期,在 DNS 服务商处调整对应名称和线路的记录;涉及已有业务记录时,先按记录冲突处理方法评估影响。若 DNS 答案符合预期,应处理实际请求对应的问题。

  • 若 www 已独立添加、但仍解析到泛域名 CNAME,要使 www 的精确域名配置生效,应先评估切换对现有业务的影响并备份 DNS 记录,再将 www 对应线路的 CNAME 目标改为 CDN 为 www 分配的专属地址。修改后比较权威 DNS 与Local DNS 答案,并验证实际请求是否按 www 的源站、缓存、HTTPS 证书和访问控制配置处理。

配置泛域名 CNAME 后,部分子域名仍解析到旧地址或无 CNAME 解析结果怎么办?

适用于已配置泛域名 DNS 记录,但 a.example.com、b.example.com 等具体子域名没有返回预期 CNAME 的情况。DNS 通配符决定解析答案如何生成,CDN 加速域名配置决定请求域名是否被覆盖,两者需要分别检查。

排查方向:

  • 检查具体名称是否使用了泛域名 DNS 记录:查询实际访问的子域名,并在 DNS 服务商处核对同名的精确 DNS 记录。已经存在的名称不会因为没有 CNAME 记录就自动使用泛域名记录,同名的 A、AAAA、TXT 等记录都需要检查。若发现同名记录,请先核实其承载的业务,切勿未经评估直接删除,以免中断既有服务。

  • 检查 DNS 匹配范围、线路和缓存:不能简单地认为所有未单独配置的子域名都会继承泛域名 DNS 记录;已有的更近层级 DNS 名称也会影响通配符匹配。按 DNS 服务商规则核对该名称是否匹配当前通配符,再按DNS 响应与缓存排查方法比较权威 DNS 和目标线路的解析结果。

  • 检查 CDN 是否覆盖实际请求域名:

    检查 CDN 控制台是否已添加并覆盖该域名:
    在 DNS 服务商处配置 *.example.com 仅完成了域名寻址,还需确保 CDN 控制台也已添加对应的泛域名或精确域名:

    • 普通同级子域名(如 www.example.com): 若已被 CDN 控制台的 *.example.com 覆盖,直接使用泛域名 CNAME 即可;若已独立添加为精确域名,则需使用其专属 CNAME(按精确域名配置不生效的排查方法处理)。

    • 多层级的深层子域名(如 sub.a.example.com): 即使部分 DNS 服务商的通配符能为多级子域名返回解析结果,CDN 的泛域名配置(如 *.example.com)也仅支持匹配同一层级的子域名。若需加速更深层级的子域名,请参见快速接入阿里云 CDN在控制台单独添加对应层级的加速域名。

说明

精确 DNS 记录是否阻止通配符生成答案,属于 DNS 解析匹配;CDN 是否配置了对应加速域名,属于请求域名覆盖,两者相互独立。解析已符合预期但访问仍异常时,按基础自检检查实际的HTTP/HTTPS请求链路。