---
title: 连接自定义域
description: 为已发布的 Runner 商店添加、购买、转移、续期或排查域问题。
---

**入口路径：** 在桌面上显示时，打开工作区 → 选择商店 → **店面** → 已发布站点菜单 → **域设置**。在移动设备上，或当该菜单隐藏时，使用工作区 **设置** → **商店：_商店名称_** → **域**。

![Runner 域名设置界面](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgYGF1bf76kHwFTWJcAfZ3G7eO08Mhysu1iQRg)

## 本指南内容

为已发布的商店打开域设置，选择正确的域工作流，并在继续前了解每个高影响操作的更改。

## 为什么以及何时使用自定义域

自定义域为客户提供已发布商店的品牌地址。在首次成功发布后以及商店在其现有公共 URL 上运行后连接一个。这将域问题与店面、目录和结账问题隔离开来。

## 可用性和先决条件

- **自定义域** 访问取决于计划。
- 商店必须在域控件变为可用之前有成功的发布。
- 您需要访问项目的设置。
- 添加您已拥有的域需要在 DNS 提供商处更改其 DNS 记录的权限。
- 购买或续期域会启动外部付款流程。
- 在同一工作区中的商店之间转移域仅限于工作区所有者和管理员。

## 打开域设置

1. 打开您的项目并选择 **店面**。
2. 选择显示实时域的已发布站点菜单。
3. 选择 **域设置**。

您也可以打开工作区 **设置**，找到标记为 **商店：_商店名称_** 的部分，然后选择 **域**。

## 域控件

| 控件 | 使用原因 | 选择时发生的情况 |
| --- | --- | --- |
| **如何连接自定义域？** | 打开当前连接帮助。 | 帮助页面在新标签页中打开。 |
| **输入您的域名地址** + **继续** | 附加您已拥有的域名。 | Runner 验证并附加该地址，然后检测 DNS 提供商。**域名添加成功** 仅确认附加完成；DNS 和所有权会单独验证。在首次成功发布前无法使用此控件。 |
| **继续前往 Cloudflare** | 让 Runner 为由 Cloudflare 管理且受支持的域名添加所需记录。 | Runner 会打开 Cloudflare 的授权页面。请选择包含该域名的账号，并授权 Runner 访问 DNS。返回后，Runner 会写入所需的精确记录并开始新的连接检查。只有自动设置可用时才会显示此选项。 |
| **使用手动记录** | 从提供的自动流程切换到手动 DNS 设置。 | 选择此选项可显示准确的 **类型 / 主机记录 / 值**。如果自动设置不可用，Runner 会直接显示这些记录。请在 DNS 提供商处添加所有显示的记录，然后返回 Runner。 |
| **我已添加这些记录** | 保存手动记录后立即检查 DNS。 | Runner 会自动检查；选择此按钮会跳过初始等待，并立即检查路由记录和所有权验证。仅在提供商处成功授权不会将域名标记为已连接。 |
| 域字段中的清除图标 | 删除输入的值。 | 输入被清除；没有域被更改。 |
| **购买域** 搜索 + **搜索** | 查找提供购买的域。 | Runner 列出可用结果或解释所请求的域不可用。 |
| **购买** | 开始购买选定的可用域。 | Runner 打开 **联系信息**，显示域和价格。尚未进行购买。 |
| **继续支付** | 继续域购买或续期。 | Runner 重定向到外部结账。如果您完成它，这可能会产生费用。首先查看显示的详细信息。 |
| **转移域** / **选择要转移的域** | 将符合条件的域从同一工作区中的另一个商店移动。 | 选择域会打开确认，命名源和目标商店。确认会启动转移；源商店失去该域。 |
| **您的域** 下的域地址 | 在该地址打开站点。 | 域在新浏览器标签页中打开。 |
| **主机** 或 **值** 旁的复制 | 使用 Runner 推荐的确切 DNS 记录。 | 选定的主机或值被复制以在 DNS 提供商处使用。分别输入显示的 **类型**。 |
| 删除域 | 分离自定义域。 | Runner 打开 **删除域**。选择 **删除** 确认对话框描述为不可逆的更改。 |
| **续期** | 延长显示在即将过期的符合条件的已购买域。 | Runner 打开续期选项和 **继续支付** 前的总计。 |
| 失败转移中的 **重试** | 为同一选定域启动另一个转移尝试。 | Runner 为同一选定域启动新的尝试。 |
| 失败转移中的 **关闭** | 离开失败的转移对话框。 | 对话框关闭而不启动重试。 |
| 在 **转移进行中** 期间关闭或 X | 关闭进度对话框 | 服务器端转移继续；关闭对话框不会取消它。稍后返回检查状态，不要启动另一个转移。 |

## 连接您已拥有的域

1. 确认商店在其当前发布的 URL 上运行。
2. 打开 **域设置**。
3. 输入您控制的完整域名，然后选择 **继续**。
4. **域名添加成功** 表示 Runner 已接受并附加该地址；它不表示 DNS 已配置，也不表示站点已上线。
5. 选择一种设置方式：
   - 如果 Runner 检测到受支持的 Cloudflare 设置，请选择 **继续前往 Cloudflare**，选择包含该域名的 Cloudflare 账号，并授权 Runner 访问 DNS。返回后，Runner 会写入“域名设置”中显示的精确记录。
   - 如果提供了自动流程，但您更希望手动设置，请选择 **使用手动记录**。如果自动设置不可用，记录已直接显示。请在 DNS 提供商处添加所有显示的 **类型 / 主机记录 / 值**。
6. 保存手动记录后，选择 **我已添加这些记录**，以跳过初始等待并立即检查。连接处于待定状态以及您从 Cloudflare 返回时，Runner 也会自动检查。
7. 等待已连接状态。Runner 要求路由记录和域名所有权验证均通过；仅完成 Cloudflare 授权并不能证明已经连接。
8. 从 **您的域** 打开域名，然后在自定义地址再次验证公共店面、产品、购物车和结账。

## 谨慎购买、转移、续期或删除

- **购买：** 搜索，选择 **购买**，查看域和当前价格，输入准确的联系信息，然后仅在您打算购买时继续支付。
- **转移：** 阅读命名的源和目标。确认说源商店失去域，立即撤销不可用。在源商店仍需要地址时不要确认。关闭进度对话框不会取消活动转移。
- **续期：** 在继续支付前查看续期期限和总计。
- **删除：** 确保存在另一个运行的域并在选择 **删除** 前记录当前设置。确认警告删除无法撤销。

## 状态、限制和故障排除

| 您看到的内容 | 含义 | 要做什么 |
| --- | --- | --- |
| **请先发布** | 项目还没有成功的发布。 | 发布并验证现有公共 URL 后再添加自定义域。 |
| **未找到域** | 当前没有附加域。 | 添加拥有的域或搜索要购买的域。 |
| **请输入有效的域** | Runner 拒绝了地址格式。 | 更正地址并重试。 |
| **域已附加到另一个商店** | 此工作区中的另一个商店使用它。 | 所有者或管理员可以选择 **改为转移它？**；其他成员应联系管理员。 |
| **域名添加成功** | Runner 已接受并附加该地址。DNS 配置会单独检查。 | 在认为地址可用之前，请查看域名行的状态。 |
| 未显示 **继续前往 Cloudflare** | 此域名目前无法使用自动设置，或 Cloudflare 连接服务尚未就绪。 | 使用域名行中显示的手动 DNS 记录。不要等待自动选项出现。 |
| 手动 DNS 记录和 **我已添加这些记录** | 自有域名已附加，但路由或所有权验证尚未通过。 | 准确添加所有显示的记录，等待 DNS 传播，然后选择 **我已添加这些记录** 以立即检查。Runner 会继续自动检查。 |
| 从 Cloudflare 返回后的检查中或验证中状态 | Runner 正在读取实际的 DNS 和所有权状态。 | 保持页面打开或稍后返回。如果仍未连接，请使用手动记录并再次检查。 |
| 蓝色勾号，且域名的 DNS 控件消失 | 当前 DNS 配置和所有权验证均已通过。 | 打开域名并验证完整的客户流程；仅有勾号并不能证明店面或结账可用。 |
| 加载图标和 **域名配置中 — 预计几分钟后即可访问** | 通过 Runner 购买的域名仍在设置中。 | 不要对此状态应用自有域名的手动 DNS 说明。请稍后返回；不保证固定的完成时间。 |
| **转移进行中** | 工作区域移动已启动。 | 避免为同一域启动另一个移动。仅关闭对话框；转移在服务器上继续。稍后返回检查结果。 |
| 转移失败 | 移动未完成。 | 阅读错误，然后选择 **重试** 或 **关闭**。在另一个操作前确认哪个商店仍持有域。 |
| 购买或续期失败 | 外部购买未完成。 | 按照 Runner 显示的状态操作，并在尝试另一个付款前确认任何退款状态。 |

## 相关指南

- [发布和重新发布](./publish-and-republish)
- [验证实时商店和结账](./live-store-and-checkout)
- [排查预览和发布问题](./troubleshoot-preview-and-publishing)