自定义域名可以为你的 Coderblock 应用提供一个易于识别的正式访问地址，无需使用系统自动为项目分配的 Coderblock URL。

你可以：

• 连接已有域名，按照引导流程配置 DNS 记录；
• 直接在 Coderblock 中购买新域名，由平台自动管理 DNS 和 SSL。

本教程将介绍这两种方式，并说明如何在发布后确认一切运行正常。

连接域名前的准备工作

配置域名前，请先确保应用已经可以发布。

打开位于 <app>.coderblock.dev 的实时开发预览，测试应用的主要使用流程，包括：

• 移动设备上的导航和页面布局；
• 注册和登录功能（如果应用使用账户系统）；
• 表单以及与数据库相关的功能；
• Stripe 结账流程（如果已启用支付）；
• 管理后台和其他受保护的页面。

如果发现需要调整的地方，只需用自然语言告诉 Coderblock 智能助手即可。 例如：

让导航栏适配不同屏幕尺寸，并确保注册表单能够显示清晰的验证错误信息。

几秒钟后，应用就会在实时预览中完成更新。 自定义域名不会取代开发环境 URL，它只是为已发布的生产版本增加一个新的访问地址。

接下来，选择要使用的配置方式：

1. 连接已有域名：你需要通过管理该域名的注册商或 DNS 服务商修改相应的 DNS 记录。
2. **在 Coderblock 中购买域名：**你将在平台内完成结账，Coderblock 会自动配置 DNS 和 SSL。

---

方案 A：连接已有域名

如果你已经从其他服务商购买了域名，并且有权修改其 DNS 设置，请选择此方案。

第 1 步：打开域名设置

打开 Coderblock 项目，然后前往 设置 → 域名。 选择连接现有域名的选项。 输入要用于应用的域名，并在继续之前仔细确认拼写是否正确。

---

第 2 步：查看 DNS 记录

Coderblock 会显示将域名连接到当前项目所需的 DNS 记录。 请保持此页面打开，以便将其中显示的名称、类型和值复制到 DNS 服务商的控制面板中。 务必使用为你的项目显示的确切记录。 不要使用其他教程中的值，也不要套用其他服务的配置，因为目标地址取决于你正在连接的具体应用。

---

第 3 步：打开 DNS 服务商的控制面板

打开一个新的浏览器标签页，登录负责管理该域名 DNS 的服务。 它可能是你购买域名时使用的注册商，也可能是独立的 DNS 服务商。 找到 DNS 管理区域。不同服务可能会使用以下名称：

• DNS
• DNS 记录
• 区域编辑器
• 管理 DNS

---

第 4 步：添加 Coderblock 提供的记录

创建或更新 DNS 记录，使其与 Coderblock 中显示的值完全一致。 仔细复制每个字段，然后保存更改。 删除现有记录前，请务必确认其用途。域名可能还使用其他记录来处理电子邮件或应用以外的服务。 只修改与待连接地址发生冲突的记录，其他无关记录应保持不变。 如果服务商会自动在主机字段后添加域名，请按照该服务商的格式要求填写。 最终保存的记录必须代表与 Coderblock 所示完全相同的主机和目标地址。

---

第 5 步：返回 Coderblock

返回 设置 → 域名，继续完成连接流程。 请注意，DNS 更新不一定会同时在所有地区生效。因此，保存记录后，域名可能不会立即显示为可用。 如果验证失败，请逐一将各字段与 Coderblock 显示的值重新进行对比。 重点检查：

• 是否存在拼写错误；
• 是否有重复记录；
• 是否有旧记录仍将同一主机指向其他目标地址。

发布并测试生产环境中的应用

完成连接后，单击 发布，部署生产版本。 Coderblock 会将应用发布到 <app>.coderblock.app 或已连接的自定义域名，并自动启用 SSL。

在新的浏览器标签页中打开自定义域名，并确认：

• 页面通过 https:// 加载；
• 浏览器显示的是正确域名；
• 点击导航链接后，地址仍保留在生产环境域名下；
• 身份验证和受保护页面正常工作；
• 表单能够正确读取数据并将其写入 Postgres 数据库；
• 支付流程使用预期的 Stripe 模式；
• 图片和文件能够从存储空间正常加载。

如果应用将面向公众使用，请分别在桌面设备和移动设备上进行测试。 连接域名并不意味着开发工作就此结束：你仍然可以通过聊天继续修改应用，在实时预览中检查更新，并在准备就绪后重新发布到生产环境。

方案 B：直接在 Coderblock 中购买域名

如果你还没有合适的域名，可以直接通过平台购买。 打开 设置 → 域名，选择购买新域名的选项。 选择你想要的域名，然后在 Coderblock 内完成结账。

在这种情况下，DNS 和 SSL 都会自动配置，你无需复制任何记录，也不必手动修改外部服务的 DNS 控制面板。 购买和配置完成后，发布应用，并执行上一节所述的相同检查。

请重点确认：

• HTTPS 地址；
• 登录和注册；
• 表单；
• 文件和图片；
• 所有支付流程。

域名无法加载时怎么办

如果已连接的域名未按预期工作，请按照以下清单进行排查：

1. **检查域名。**确认 Coderblock 中输入的域名与已修改 DNS 的域名完全一致。
2. **重新检查 DNS 记录。**即使只有一个字符错误，也可能导致域名无法正确连接。
3. **查找冲突。**旧记录可能仍在将同一主机指向其他服务。
4. **等待 DNS 更新。**DNS 更改可能需要一段时间才能完成全球传播。
5. **确认应用已经发布。**开发预览和生产版本是两个独立的环境。
6. **尝试完整的 HTTPS 地址。**直接输入以 https:// 开头的完整 URL。
7. **使用无痕窗口测试。**这样可以排除浏览器缓存、重定向或已保存旧版本造成的问题。

请特别注意：配置正在更新时，不要频繁修改 DNS 记录。 如果记录值已经与 Coderblock 提供的内容一致，不必要的修改反而可能让问题变得更加复杂。

最终检查清单

满足以下条件时，说明域名已正确配置：

• 域名显示在项目的 设置 → 域名 中；
• DNS 记录与 Coderblock 提供的配置一致，或者域名是在平台内购买并已自动完成配置；
• 应用已经发布；
• 可以通过 HTTPS 打开自定义域名；
• 应用的主要使用流程在生产环境中运行正常。

你的域名已准备就绪

现在，你的 Coderblock 应用已经拥有专属的生产环境地址，可以分享给客户、用户和其他相关人员。 接下来，你可以继续按正常流程开发应用：聊天 → 修改 → 预览 → 发布，并始终使用自定义域名作为线上版本的访问入口。