Atoms 域名和 SSL 故障排查
通过有针对性的检查,修复自定义域名验证、DNS、路由、重定向和 HTTPS 问题。
当自定义域名始终未就绪、打开了错误的网站、发生错误重定向,或显示 HTTPS/安全错误时,请使用本指南。
从这里开始
设置 → 域名 → 管理 → 域名状态 → 确认失败阶段 → 重新检查
先找到你的问题
在更改 DNS 之前,请先使用症状对照表。从与你所见现象相匹配的部分开始,一次只做一个有针对性的更改,然后重新检查浏览器中的域名状态和主机名。
| 你看到的现象 | 前往 |
|---|---|
| Atoms 无法验证该域名,或某条必需记录似乎缺失 | 验证和 DNS 记录问题 |
| 该域名打开的是旧网站或错误的网站 | 路由、冲突记录、Cloudflare 或项目关联 |
| 更改在某些网络上生效,但在其他网络上不生效 | DNS 传播和本地缓存 |
| HTTPS 失败,或浏览器显示证书警告 | SSL / HTTPS 问题 |
| 该域名打开了错误的 Atoms 项目 | 错误项目行为 |
| 根域名和 www 表现不同 | 根域名 / www 故障排查 |
| 该域名重定向到错误地址或发生循环 | 重定向故障排查 |
| 多个互不相关的 Atoms 域名同时失败 | 停止更改 DNS 并联系 Atoms 支持 |
重要
请始终使用 Atoms 中当前为你正在排查的域名显示的 DNS 值。不要从其他域名、旧截图或旧指南中复制 IP 地址、验证值或 DNS 目标。
在哪里检查域名
快速参考:使用本指南时你可能会看到的术语
你不需要从内部原理上理解 DNS,也可以使用这些故障排查步骤。以下定义仅在你不熟悉某个术语时提供参考。
| 术语 | 含义 |
|---|---|
| DNS | 告诉互联网你的域名应将访问者发送到哪里,以及它使用哪些在线服务的设置。 |
| Authoritative DNS / nameservers | 实际控制你域名线上设置的 DNS 服务。如果你在其他地方更改 DNS,这些更改不会影响该域名。 |
| A / AAAA / CNAME | 告诉浏览器去哪里找到你网站的记录。旧记录或冲突记录可能会把访问者发送到错误的网站。 |
| TXT | 一种基于文本的 DNS 记录,通常用于证明你控制某个域名。Atoms 可能会在域名设置期间要求你添加一条。 |
| DNS propagation / TTL | DNS 更改在各处可见所需的时间。在此期间,部分用户可能仍会看到旧结果。 |
| CAA | 一种可选的 DNS 规则,用于控制哪些公司被允许为你的域名签发 HTTPS 所需的安全证书。 |
| Cloudflare proxy | Cloudflare 的一项设置,会先将网站流量发送到 Cloudflare,再到达你的网站。这可能会影响域名的路由或验证方式。 |
在你更改任何内容之前
• 记录 Atoms 中显示的确切域名状态以及任何错误消息。
• 一次只更改一个 DNS 或路由设置,这样你才能判断是哪项更改影响了结果。
• 在编辑生产环境 DNS 记录之前,先记录之前的值。
• 不要仅仅因为你不认识某些记录就删除它们。MX 记录、与邮件相关的 TXT 记录以及无关的子域名可能支持电子邮件或其他服务。
• 除非你本来就打算并已确认要进行单独的 DNS 迁移,否则不要仅为了修复单个验证问题而更改 nameservers。
• 如果某项故障排查更改破坏了正常工作的网站、电子邮件或其他服务,只恢复最后一个导致回退的问题更改。
验证和 DNS 记录问题
当 Atoms 无法验证域名、某条必需记录显示缺失或不正确,或你已编辑 DNS 但域名状态没有变化时,请使用本部分。
先检查源 DNS
• 在 Atoms 中打开该域名,并将每一条必需记录与同一主机名当前公开发布的内容进行比较。
• 检查该域名的 authoritative nameservers,并确保你是在为这些 nameservers 提供服务的提供商处编辑 DNS。如果 nameservers 指向 Cloudflare,那么仅在注册商 DNS 面板中所做的更改可能并非权威来源。
• 对于每一条必需记录,确认记录类型、主机名/name、目标或值,以及该记录确实存在于权威提供商处。
• 验证值必须与 Atoms 当前显示的值完全一致,并且必须能在公开 DNS 查询中看到。
只修复不匹配项,然后重新检查
• 创建缺失的记录,或仅更正不匹配的字段。
• 如果该记录被添加到了错误的 DNS 提供商处,请改为在权威提供商处添加。
• 不要用来自其他项目、其他域名、旧截图或旧版帮助中心文章中的地址或验证值替换当前的 Atoms 值。
• 更改公开生效后,返回“域名 → 管理”,重新检查域名状态,然后在浏览器中测试该主机名。
保护无关服务
如果某项 DNS 更改破坏了电子邮件或其他第三方服务,只恢复被意外更改的无关 MX、TXT、验证或子域名记录。然后继续一次排查一条记录。
路由、旧内容、冲突记录和 Cloudflare
当主机名打开旧网站、到达错误目标,或同一主机名存在多条路由记录时,请使用本部分。
检查该准确主机名的 A、AAAA 和 CNAME 记录
• 查找来自之前托管提供商的记录、旧的 IPv6 AAAA 目标、同一主机名下的 CNAME 加另一条目标记录,或将流量发送到不同服务的重复记录。
• 仅删除你已确认与当前 Atoms 设置冲突的网站路由记录。不要把删除未知记录当作清理步骤。
• 如果 DNS 已经指向预期目标,但仍显示旧内容,请先测试无痕/隐私窗口、其他浏览器或设备,以及其他网络,然后再更改 DNS。
Cloudflare 代理状态
• TXT 验证记录是仅 DNS 的;它们不是 Web 代理记录。
• 对于 A 或 CNAME 记录,仅当 Atoms 界面或 Atoms 支持明确要求时才更改 Proxy Status。不要把记录在 Proxied 和 DNS only 之间来回切换作为常规故障排查步骤。
• 如果 Atoms 或支持要求你更改代理状态,只更改指定的路由记录,等待新的 DNS 响应变得可见,然后重新测试该域名和 HTTPS。
DNS 传播和本地缓存
如果 authoritative DNS 已经正确,但不同网络或设备仍显示不同结果,那么剩余问题通常是缓存,而不是新的配置错误。
• 将 authoritative DNS 结果与一个或多个公共 DNS 解析器进行比较,如有需要,也可与另一种网络(例如移动数据)进行比较。
• 如果 authoritative DNS 错误,请更正源记录。如果 authoritative DNS 正确,但其他解析器仍返回之前的值,请避免反复编辑该记录。
• DNS 更改最多可能需要 48 小时才能在全球范围内可见,不过通常会更快出现。
• 如果只有某一个浏览器或设备显示错误结果,而其他地方的 DNS 和 Atoms 都正确,请清除或绕过该本地浏览器/网络缓存。不要为了设备特定的缓存问题而更改 DNS。
• 稍后重新检查,并观察公共解析器是否收敛到相同的预期值。
SSL / HTTPS 问题
当 DNS 看起来正确,但 HTTPS 无法签发、浏览器显示证书警告,或 HTTPS 之前可用但现在失败时,请使用本部分。
检查证书周边配置
• 记录浏览器显示的确切错误,以及正在打开的确切主机名。
• 确认 DNS 路由、传播、Cloudflare 代理状态,以及该证书是否看起来属于其他主机名。
• 检查最近是否有任何 DNS、nameservers、Cloudflare 代理设置、CAA 记录或项目/域名关联发生了变化。
• 如果可能存在限制性证书策略,请检查受影响主机名及其父域名上的 CAA 记录。
CAA 注意事项
Atoms 不会公布用户应添加到 CAA 记录中的证书颁发机构。不要猜测 Atoms 的证书颁发机构,也不要随意添加 CAA 值。如果限制性 CAA 策略可能阻止了签发,请先联系 Atoms 支持,再更改 CAA。
修复并验证
• 仅修复已确认的 DNS、代理、CAA、主机名或项目关联问题。
• 不要把绕过浏览器证书警告当作常规解决方案。
• 如果公共 DNS 正确,且没有任何用户可控配置可以解释该故障,请停止更改 DNS,并联系 Atoms 支持处理证书签发或续期问题。
• 除非 Atoms 明确指示,否则不要仅为了强制证书续期而替换原本正确的 DNS。
• 重新检查时,请使用 https:// 打开准确的主机名,并确认预期项目能够加载且没有证书警告。
根域名、www、重定向和错误项目行为
这些问题值得在这里检查,因为即使基础连接已经正常工作,它们看起来也可能像 DNS 或 SSL 故障。
根域名可用但 www 不可用——或反过来
• 请将 example.com 和 www.example.com 视为两个独立的主机名。通过 HTTPS 分别测试两者。
• 检查失败主机名的 DNS 结果和 Atoms 域名状态。
• 不要想当然地认为根域名的值应该直接复制到 www。
如果某个主机名仍需要连接或重新配置,请按照 连接和管理域名 中的设置步骤操作,而不是在这里重复配置流程。
重定向到错误地址或发生循环
• 确认你希望访问者最终到达的地址,并在新的/隐私浏览器会话中测试重定向。
• 检查是否还有其他系统也在执行重定向,例如注册商转发、Cloudflare 重定向规则、其他代理/CDN,或之前的托管平台。
• 仅更改已确认存在冲突的重定向层。避免同时更改多个重定向系统。
• 如果某项更改导致重定向循环或把访问者发送到错误目标,请先恢复之前正常工作的重定向配置,再测试另一层。
如需更改哪个已连接地址为主地址,请使用 连接和管理域名 中的流程。
该域名打开了错误的 Atoms 项目
• 如果 DNS 已经正确到达 Atoms,请将该问题视为项目/域名关联问题,而不是反复更改 DNS。
• 确认当前是哪个项目或工作区显示了该域名关联。
• 关联修正后,重新检查该主机名是否打开了预期项目,以及 HTTPS 是否仍然正常。
如需在项目之间切换、断开、重新连接或移动域名,请遵循 连接和管理域名。如果当前关联属于无法访问或已删除的项目/工作区/账户,请联系 Atoms 支持,而不是继续进行额外的 DNS 更改。
何时应停止更改 DNS 并联系 Atoms 支持
当证据表明问题出在 Atoms 侧的状态、证书或关联时,应升级处理,而不是继续编辑 DNS。
• 已确认 DNS 正确,但 Atoms 域名状态没有恢复。
• 尽管公共 DNS 和用户可控设置都正确,证书签发或续期仍然失败。
• 该域名关联到了无法访问或已删除的项目/工作区/账户,或相关的域名管理操作失败。
• 多个互不相关的 Atoms 域名同时失败,且它们的 DNS 记录最近并未更改。
• 某项故障排查更改影响了另一项服务,而你无法安全地确定正确的回滚方式。
服务状态说明
目前尚未确认存在可用的公开 Atoms 服务状态页面。如果多个互不相关的域名同时失败,请避免修改原本正确的 DNS,并联系 Atoms 支持。
升级处理前请准备以下证据
• 受影响的主机名以及预期的 Atoms 项目/工作区。
• 当前显示的确切域名状态或错误消息。
• 当前 authoritative DNS 结果,以及 Atoms 当前要求的值。
• 浏览器显示的确切 HTTPS/证书错误(如适用)。
• 最后一次所做的更改,以及恢复该更改后是否恢复了之前的行为。
最终重新检查
完成任何修复后,返回“域名 → 管理”并重新检查域名状态。然后在浏览器中确认结果。
• 预期主机名已连接,并到达预期的 Atoms 项目。
• HTTPS 正常工作,且没有证书警告。
• 根域名和 www 的行为符合预期。
• 重定向最终到达预期地址。
• DNS 更改后,电子邮件和其他无关服务仍然正常工作。
完整结果
正确的域名状态 + 正确的网站 + HTTPS + 正确的主机名 + 符合预期的重定向
FAQ
为什么我的自定义域名显示 DNS_PROBE_FINISHED_NXDOMAIN?
如果你的浏览器显示 DNS_PROBE_FINISHED_NXDOMAIN,说明请求尚未到达我们的平台。请检查:
- 你的域名未过期。
- Nameservers 指向正确。
- 所需的 A/CNAME/TXT 记录已按平台要求完成配置。
故障排查所需信息:
- 完整域名
- 注册商 / DNS 提供商
- 当前 DNS 记录的全屏截图
- 最后修改时间
- 分别针对 apex 和 www 的测试结果
在确认记录无误后,我们将验证 DNS 传播和平台绑定情况。
为什么我的根域名和 www 子域名表现不同?
你的根域名和 www 子域名是两个独立的主机名,因此一个可以正常工作,而另一个可能尚未配置。
- 选择哪个主机名应作为主地址,以及另一个是否应重定向到它。
- 在 Atoms 域名设置中,确认两个主机名都已添加,或已配置预期的重定向。
- 在你的 DNS 提供商处,将每个主机名与 Atoms 当前要求的准确记录进行比较。仅在确认某条冲突记录未被其他服务使用后再删除它。
- 等待 DNS 和证书更新,然后在无痕窗口中测试两个 HTTPS URL。
如果它们仍然不同,请联系支持,并提供两个 URL、期望的主主机名、域名设置截图、DNS 截图、每个地址返回的错误以及最后更改时间。
我的 DNS 记录是正确的,但自定义域名仍然无法工作,为什么?
- 不要反复解绑域名或删除记录;这可能会重新触发验证或证书处理。
- 确认 authoritative DNS 提供商,并将线上 A、CNAME 或 TXT 结果与 Atoms 中显示的准确值进行比较。检查是否存在重复或冲突记录。
- 确认该域名仍绑定到正确的项目,并且平台生产 URL 可以正常工作。
- 如果记录最近刚更改,请等待已发布的 TTL 和证书签发完成后再测试。
如果该域名仍显示 404、证书警告或路由断开,请联系支持,并提供完整域名、域名设置页面、DNS 截图、最后更改和重新检查时间、平台生产 URL 以及完整错误信息。
为什么我部署了新版本后,自定义域名仍然显示旧内容?
- 打开 Publish 并确认最新版本已部署,且状态为最新。
- 比较平台生产 URL 与自定义域名。
- 对自定义域名执行强制刷新,并在无痕窗口中测试。
- 如果平台 URL 是最新的,但自定义域名仍显示旧内容,请确认该域名仍指向当前的 Atoms 目标。如果你使用代理或 CDN,请按照该提供商的说明刷新其缓存。
除非 DNS 记录与 Atoms 当前要求不一致,否则不要更改 DNS 记录。如果问题仍然存在,请联系支持,并提供两个 URL、对比截图、当前版本、发布时间、DNS 或代理提供商以及受影响的路径。

TRAE-AI编程


更多建议: