White Label DNS 故障排除

大多数 White Label Lite DNS 问题都源于以下四种情况之一：记录缺失、记录值与“品牌设置”表格不同、启用了代理，或者证书步骤需要处理。

请从域名“品牌设置”选项卡中的品牌 DNS表格开始。该表格是主机名和目标值的准确依据。不要从旧文章、其他账户或 DNS 检查工具复制 CNAME 目标。

快速处理

1. 打开“品牌设置”，复制受影响地址的主机、类型和值。
2. 在托管有效 DNS 区域的 DNS 提供商处创建或更正该记录。
3. 如果提供商提供代理开关，请让记录保持为仅 DNS。
4. 返回“品牌设置”并选择验证 DNS。只有状态为有效时才分享该地址。

不使用终端检查 DNS

排查其他问题之前，请将 DNS 提供商处的记录与“品牌设置”中的对应行比较：

• 主机或名称
• 类型，品牌仪表板或网页邮箱主机应为 CNAME
• 值或目标
• 代理设置，对于 Cloudflare 上的品牌主机必须关闭

保存记录后，在“品牌设置”中使用验证 DNS。该操作会将新检查加入队列，页面随后显示检查结果状态。

如需独立检查，可使用公共 DNS 查询服务，或让 DNS 提供商以 CNAME 类型查询完整主机名。返回结果必须与“品牌设置”中当前的“值”字段完全一致。公共检查工具可以确认它看到的内容，但不能取代平台的有效状态。

完成此设置不需要终端。如果使用终端，请查询完整主机名，并将返回的 CNAME 与“品牌设置”所示值比较。

状态显示“DNS 待验证”

DNS 待验证表示平台尚未找到该主机的预期记录。更正记录后选择验证 DNS，并在状态更新后返回“品牌设置”选项卡。请按顺序检查以下项目：

编辑了错误的 DNS 提供商。 确认哪个提供商对您域名的 DNS 具有权威性。您可能正在编辑注册商面板，而有效 DNS 区域实际托管在其他位置。

CNAME 目标不是当前值。 从“品牌设置”表格复制“值”或“目标”。只有确认同一主机名的旧冲突记录未被其他服务使用后，才能将其删除。

记录类型错误。 仪表板或网页邮箱主机需要“品牌设置”中显示的 CNAME 记录。同一主机名上的 A 或 AAAA 记录可能导致无法获得预期结果。

主机名输入格式错误。 有些提供商只要求前缀，例如 dashboard，其他提供商则要求完整主机名。请遵循提供商字段提示，并将生成的记录与“品牌设置”中的主机比较。

如果记录一致，请保留它并再次使用验证 DNS。反复修改正确记录可能会延长所有 DNS 解析器看到相同结果所需的时间。

Cloudflare 橙色云会阻止 SSL 配置

如果使用 Cloudflare 作为 DNS 提供商，每条记录旁会显示云朵图标。橙色云表示 Cloudflare 正在代理请求。品牌仪表板或网页邮箱的 CNAME 必须设置为仅 DNS，平台才能验证并签发证书。

解决方法： 点击受影响品牌主机 CNAME 旁的云朵，直到它变为灰色，然后保存记录。返回“品牌设置”并选择验证 DNS。

该要求针对品牌主机记录，不会自动应用于域名的所有其他记录。如果其他提供商有代理或 CDN 开关，请为该 CNAME 将其关闭，除非“品牌设置”表格另有说明。

状态显示“无法签发 SSL”并提到 CAA

CAA 记录用于指定哪些组织可以为域名签发证书。只有当“品牌设置”状态或支持团队明确指出 CAA 是阻碍因素时，才应更改它。

保持 CNAME 不变，并检查域名是否已有 CAA 记录。DNS 提供商可以显示该记录，也可以使用独立 DNS 查询检查根域名。

如果记录需要允许平台使用的证书签发机构，请添加支持团队提供或当前产品指南中所示的准确 CAA 值。不要只为通过此步骤而删除无关的 CAA 条目。多条 CAA 记录可以共存。

当前证书流程通常需要以下值：

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

如果没有 CAA 记录，不要仅为预防而添加一条。更改 CAA 后，请返回“品牌设置”并选择验证 DNS。

状态显示“无法签发 SSL”但没有原因

CNAME 可能已经正确。不要反复删除并重新创建。请执行以下操作：

1. 确认记录仍与“品牌设置”中的主机和目标一致，而且未经过代理。
2. 选择一次验证 DNS。
3. 如果状态仍未改变，请联系支持团队，提供主机名、所示状态和 DNS 记录截图。

如果 CNAME 本身正确，编辑它无法解决证书问题。支持团队可以检查平台端结果，无需您透露 DNS 提供商凭据。

域名原本有效，但状态发生变化

主机进入有效状态后即可提供服务。如果状态后来变化：

• 重新变为“DNS 待验证”： 将当前 CNAME 与“品牌设置”表格比较。记录可能被更改、删除或开始使用代理。
• “无法签发 SSL”： 保留匹配的 CNAME，选择验证 DNS，如果状态一直不变，请联系支持团队。
• 关闭： 检查该域名是否关闭了品牌设置，或 White Label 订阅是否处于非活动状态。如果两者都无法解释，请联系支持团队。

常见情况

“我更改了 CNAME，但状态仍在等待。” 确认您编辑的是权威 DNS 提供商，且新 CNAME 与“品牌设置”完全一致。然后使用验证 DNS。检查进行时，请避免来回切换值。

“我删除了旧提供商处的旧 CNAME，但系统找不到新记录。” 如果更换了 DNS 提供商，请确保注册商将域名委派给新提供商的名称服务器。否则，请让托管权威 DNS 区域的提供商确认记录。

“我的主网站使用代理。品牌主机也能使用吗？” 品牌 CNAME 必须保持为仅 DNS。只要“品牌设置”中的特定主机不经过代理，域名其他部分可以使用自己的代理设置。

“可以使用通配符 CNAME 吗？” 请配置“品牌设置”中显示的具体主机名。这样平台才能获得明确的地址来验证和测试。不要用通配符记录替换表格中列出的主机。

“我想使用其他子域名。” 在域名的品牌设置选项卡中更改标签，每次保存一个主机。从表格复制新 CNAME，只在新主机变为有效后进行测试，并在完成客户迁移前保留旧客户地址。

“某个网络看不到新记录。” 从其他网络测试，或让受影响的客户稍后重试。如果“品牌设置”表格显示有效且主机在其他位置正常工作，剩余延迟很可能来自该网络的 DNS 缓存。

后续步骤

• 设置 White Label Lite：如果设置尚未完成，请参阅原始步骤
• White Label Lite 定价常见问题：与账单相关的问题
• 取消 White Label Lite：取消后域名会发生什么
• 推荐的 DNS 记录：TrekMail 所用 DNS 记录的完整说明

如果问题仍未解决，请提交支持工单，并提供主机名、“品牌设置”中的准确状态、DNS 提供商以及记录截图。不要发送 DNS 提供商的密码或 API 令牌。