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