Atoms 域名
选择一个域名，将其连接到你的项目，安全地管理 DNS，并验证最终地址可通过 HTTPS 正常访问。
域名是访客用来访问已发布项目的网址。每个已发布的 Atoms 项目都会获得一个由 Atoms 托管的免费地址。具体的公开后缀可能取决于部署方式。如果你的套餐包含自定义域名，你还可以连接自己已拥有的域名，或通过域名管理流程购买一个新域名。
从你的目标开始
在选择路径之前，你不需要先理解 DNS。选择与你想做的事情相匹配的选项，然后按照下面对应的步骤操作。
选择与你目标匹配的路径
| 目标 | 前往位置 |
|---|---|
| 使用免费的 Atoms 地址 | 设置 \> 域名 \> 找到默认的 .atoms.world URL \> 编辑 |
| 连接你已拥有的域名 | 设置 \> 域名 \> 连接现有域名 \> 连接域名 |
| 购买新域名 | 设置 \> 域名 \> 购买新域名 \> 购买新域名 |
| 选择首选公开地址 | 设置 \> 域名 \> 选择域名 \> 设为主域名 |
| 将域名从另一个 Atoms 项目迁移过来 | 设置 \> 域名 \> 连接现有域名 \> 连接域名 \> 已连接域名 \> 切换 \> 继续 |
| 移除已连接的域名 | 设置 \> 域名 \> 选择域名 \> 管理 \> 断开连接 |
开始之前
- 请先发布项目。
- 对于自定义域名，请使用包含自定义域名支持的付费套餐。
- 确保你可以编辑要连接的确切主机名的 DNS 记录。
- 确认该域名当前生效的 DNS 由哪里管理。这可能与注册该域名的公司不是同一个服务。
- 在进行更改前，记录或导出现有的 DNS 配置。
- 在替换其 A 记录或 CNAME 记录之前，检查该主机名是否已经打开了其他网站或服务。
- 保留邮件和无关服务的记录。不要仅为了连接网站而删除 MX、SPF、DKIM、DMARC 或无关的 TXT 记录。
域名和 DNS 基本术语
你只需要了解少量 DNS 概念，就能安全地连接域名。
| 术语 | 含义 |
|---|---|
| 域名 / 主机名 | 人们在浏览器中输入以打开你网站的地址，例如 example.com 或 app.example.com。 |
| 根域 / 顶级主机名 | 你的域名最基础的形式，前面没有添加任何内容。例如，example.com 就是根域名。像 www.example.com 和 app.example.com 这样的地址都是基于它构建的 |
| 子域名 | 在主域名前添加一个词形成的地址。例如，www.example.com、app.example.com 和 shop.example.com 都是 example.com 的子域名。 |
| DNS 提供商 / DNS 托管方 | 你管理域名设置的服务。这可能与你购买域名的公司相同，也可能是不同的服务。 |
| DNS 记录 | 告诉互联网你的域名应如何工作的设置，例如网站应打开到哪里，或 Atoms 如何验证你的域名。 |
| A 记录 | 一种 DNS 设置，用于将你的域名指向托管网站的服务器。 |
| AAAA 记录 | 一种 DNS 设置，用于将域名指向 IPv6 服务器地址。大多数初学者在正常的 Atoms 设置流程中不需要了解这个定义。 |
| TXT | 一种 DNS 设置，可包含验证信息。Atoms 可能会要求你添加一条，以确认你对该域名拥有控制权。 |
| DNS 传播 | DNS 更改在整个互联网中变得可见所需的时间。在此期间，部分用户可能仍会看到旧设置。 |
| HTTPS / TLS | 网站连接的安全版本。当你的域名使用 HTTPS 时，访客与你网站之间传输的信息会被加密。 |
| Primary Domain | 当你的项目连接了多个域名时，你希望访客使用的主要网址。 |
在遇到这些术语时会很有帮助
| Term | What it Means |
|---|---|
| CNAME | 一种 DNS 设置，用于将一个域名地址指向另一个域名地址。 |
| Registrar | 为注册人注册并续费域名的公司/实体。 |
自定义你的免费 Atoms 地址
首次发布项目时，Atoms 会在其 Atoms 托管域名下分配一个稳定的默认子域名。你可以在发布/更新流程中，将该子域名替换为另一个可用名称。
- 打开 设置 \> 域名。
- 找到默认的 .atoms.world URL。
- 选择编辑。
- 输入新名称并选择更新。 如果该名称无法使用，请按照 Atoms 中显示的验证提示进行操作。
- 测试新地址。 打开新的 .atoms.world URL，并确认目标已发布项目可通过 HTTPS 正常加载。
连接你已拥有的域名
当你的域名在其他地方注册，并且你希望某个特定主机名 - 例如 example.com、www.example.com 或 app.example.com - 打开你的 Atoms 项目时，请使用此路径。
选择确切的主机名
在编辑 DNS 之前，先确定访客应使用哪个主机名。根域名及其子域名是不同的主机名。例如，如果你希望 example.com 和 www.example.com 都能使用，则必须分别连接它们。
开始连接
- 打开 设置 \> 域名。
- 在“连接现有域名”下，选择“连接域名”。
- 输入确切的主机名，然后选择“连接域名” 以继续。
- 在可用时使用辅助设置。 Atoms 可能会识别你的 DNS 提供商，并提供自动连接流程。
- 在需要时选择手动设置。 如果自动连接不可用，请继续使用 Atoms 为你的主机名显示的 DNS 记录。
显示手动设置时配置 DNS
Atoms 会显示连接该主机名所需的 DNS 记录。不要假设所有设置都使用相同的记录类型。根据主机名和连接方式，网站路由可能使用 A 记录或 CNAME，验证可能包含 TXT 记录。
使用项目中显示的值
只添加 Atoms 当前为你的主机名显示的记录类型、主机和值。不要从其他项目或示例中复制 IP 地址、CNAME 目标、TXT 主机、验证 Token 或其他 DNS 值。
- 打开当前生效的 DNS 提供商。 登录托管该域名实时 DNS 的服务。
- 备份现有记录。 在进行更改前，记录或导出当前配置。
- 严格按照 Atoms 中显示的内容添加每条所需记录。 这可能包括 A、CNAME、TXT 或设置中显示的其他记录类型。
- 保护无关服务。 不要删除邮件记录或无关的 TXT 记录。只更改你正在连接的主机名所需的记录。
- 保存 DNS 更改。
- 返回 Atoms 并完成连接流程中显示的确认或验证步骤。
等待验证和 HTTPS 生效
保存 DNS 后，在 Atoms 检查连接和验证信息期间，域名可能会显示“Verifying”。DNS 更改最多可能需要 48 小时才能在全球范围内可见，不过通常会更快更新。在传播期间，不同网络可能会暂时显示不同结果。
打开域名状态详情，在 DNS 传播期间保持记录不变，然后选择 Recheck。如果状态为 Failed，请先根据显示的错误和下一步操作进行处理，再次更改 DNS 之前不要贸然修改。
当域名状态变为 Live 后，请通过 HTTPS 打开该确切主机名，并确认其加载的是目标已发布项目。
验证连接
- 确切主机名显示在 设置 \> 域名 中。
- 域名状态为 Live。
- 主机名可通过 HTTPS 打开。
- 加载的是正确的已发布项目。
- 如果项目有多条路由，嵌套路由或刷新后的深层链接也能正常工作。
- 如果项目使用了多个已连接地址，每个地址的行为都符合预期。
根域名、www 和子域名
| 问题 | 处理方式 |
|---|---|
| example.com 和 www.example.com 算同一个主机名吗？ | 不算。它们是不同的主机名。请分别连接并测试你希望访客使用的每一个主机名。 |
| 根域名和 www 都可以连接吗？ | 可以。分别连接每个主机名，然后将首选地址设为 Primary Domain。 |
| 可以使用多个子域名吗？ | 可以。像 app.example.com 和 shop.example.com 这样的主机名都可以分别配置。 |
| 不同子域名可以指向不同项目吗？ | 每个主机名都可以独立配置，因此不同子域名可以连接到不同项目。 |
| 同一个主机名可以同时连接到两个项目吗？ | 一个主机名在同一时间应只连接到一个项目。在迁移到另一个项目之前，请先断开现有绑定。 |
| 如何连接仍与另一个项目或已删除项目关联的域名？ | 在目标项目中，前往 设置 \> 域名 \> 连接现有域名 \> 已连接域名 \> 切换 \> 继续。如果在此流程中该域名不可用，请联系 Atoms 支持。 |
购买新域名
当你想搜索并注册一个新域名，而不是连接自己已拥有的域名时，请使用“购买新域名”。结账通过 IONOS 完成。
- 打开 设置 \> 域名。
- 选择“购买新域名”。
- 搜索域名。 使用搜索结果查看可用性和价格。
- 将域名加入购物车。
- 通过 IONOS 完成结账。 提供结账过程中要求的注册和付款信息。
- 完成注册人验证。 按照注册商发送的验证说明操作，以保持注册处于有效状态。
- 返回 设置 \> 域名。 按照 Atoms 中显示的说明完成项目的域名设置。
选择 Primary Domain
一个项目可以有多个已连接地址，例如一个免费的 .atoms.world 地址和一个或多个自定义域名。Primary Domain 是你希望访客作为首选公开 URL 使用的地址。设置它会选定首选地址；但它本身不会自动将所有已连接主机名重定向过去。
- 打开 设置 \> 域名。
- 找到你想使用的已连接域名。 在将其设为主域名前，请确保它已正常工作。
- 选择 Set as Primary。
- 测试结果。 打开主地址并确认其加载的是目标项目。仅在启用 Redirect 后，才需要单独测试历史链接的重定向；Atoms 最多支持重定向两个链接。
域名卡片会显示每个已连接域名的状态。请将状态作为起点，然后实际测试该主机名本身。
| 状态 | 含义 | 该怎么做 |
|---|---|---|
| Live | 域名已完成连接和验证流程。 | 通过 HTTPS 打开该主机名，并确认加载的是正确的已发布项目。 |
| Verifying | Atoms 正在检查域名连接和验证信息。 | 等待 DNS 传播，并确保 A/TXT 值与 Atoms 中显示的一致。如果没有进展，请使用 域名和 SSL 故障排查 指南。 |
| Disconnected | 该域名当前未连接到项目。 | 如有需要，请重新连接；如果你要将其从另一个 Atoms 项目迁移过来，请使用 Switch 流程。 |
| Failed | 连接或验证流程未成功完成。 | 查看 Atoms 中显示的错误，确认主机名和 DNS 值，然后在修正已识别问题后重试。 |
安全地断开、切换或替换域名
如果某个域名已经在接收流量，请在移除可用连接之前先验证目标地址或替代地址。这样可以避免访客失去可用访问地址。
将域名从另一个 Atoms 项目迁移过来
1. 打开目标项目，然后前往 设置 \> 域名。
2. 在“连接现有域名”下，选择“连接域名”。
3. 选择“已连接域名”。
4. 选择“切换”，然后选择“继续”。
5. 验证结果。 确认目标项目可通过 HTTPS 正常加载，且域名状态变为 Live。如果在此流程中该域名不可用，请联系 Atoms 支持。
断开域名
1. 打开 设置 \> 域名。
2. 选择已连接的域名，然后选择 管理 \> 断开连接。
3. 验证剩余地址。 确保项目仍保留你打算继续使用的可用地址。
断开或删除域名。 如果你只是想将域名与当前项目解绑，请选择 Disconnect。如果你想将其从账户或域名池中移除，请选择 Delete Domain。
删除操作可能会将该域名从其他已连接项目中解绑，这些项目随后会恢复为默认的 Atoms 地址。此操作需要明确确认，并且之后若要重新连接，需要再次添加 DNS 记录。
用另一个域名替换公开域名
1. 先连接替代域名。
2. 等待替代域名状态变为 Live。
3. 为替代域名选择 Set as Primary。
4. 验证替代域名 以及 .atoms.world 备用地址。
5. 通过 管理 \> 断开连接 断开旧域名。
6. 仅在确认替代域名可用后再清理旧 DNS。 如果旧主机名不应再指向 Atoms，请仅在 DNS 提供商处删除或替换旧的 Atoms 专用记录。
不要仅为了更换域名而使用 Unpublish
Unpublish 会让已发布的网站下线。切换或移除域名是单独的域名管理操作。
连接后的上线检查清单
Live 状态确认连接已完成，但在将更改视为完成之前，仍应做一些与域名相关的检查。
• 在私密/无痕窗口中通过 HTTPS 打开确切的生产主机名。
• 确认加载的是目标 Atoms 项目。
• 如果根域名和 www/子域名都应可用， 请分别测试每个主机名。
• 如果已启用 Redirect， 请测试每个选定的历史链接，并确认其会重定向到首选地址。Atoms 最多支持两个重定向链接。
• 至少直接打开一个嵌套路由 并刷新它，以确认主机名路由正确。
• 在切换或断开连接后， 确认旧主机名现在的行为符合预期。
故障排查与支持
如果已连接的域名未变为 Live 或停止工作，请避免一次更改多个设置。
1. 对比 DNS 记录。 检查 Atoms 当前显示的每条记录，并与 DNS 提供商发布的记录进行比对。根据设置情况，这可能包括 A、CNAME、TXT 或连接流程中显示的其他记录类型。
2. 确认确切主机名。 确保你编辑 DNS 的主机名与在 Atoms 中输入的主机名一致。
3. 留出 DNS 传播时间。 DNS 更改最多可能需要 48 小时才能在全球范围内可见。
4. 通过 HTTPS 测试确切主机名。 检查网站是否加载了正确项目，以及安全连接是否可用。
5. 使用 域名和 SSL 故障排查<strong>。</strong> 如果 DNS 记录正确，但验证、HTTPS、路由、重定向或域名管理仍然失败，请按照该专项故障排查指南操作。
6. 如果问题仍然存在，请 获取支持 。 请附上项目 Chat Link 以及能清楚显示问题的截图。你可以使用智能体消息上的 反馈 选项，或聊天支持入口。
保持一个已知可用的地址
不要为了尝试不同设置而删除可用的 DNS 记录，或反复断开并重新连接域名。在确认替代地址可用之前，请保留 .atoms.world 地址或其他可用主机名。