📝 文字 ● 初级更新于 2026-05-31

如何将自定义域名连接到我的 LingCode Cloud 应用？

TL;DR：通过 Mac IDE 中的 Cloud（工具栏按钮）将应用部署到 LingCode Cloud。在成功面板中展开 Custom domain，输入 app.yoursite.com，然后点击 Attach。接着在您的域名注册商处添加一条记录——子域名使用 CNAME 指向 apps.lingcode.dev，根域名使用 A 记录指向 138.197.107.228。首次访问时 HTTPS 将自动签发。IDE 会显示 Pending DNS → Verified ✓ 表示配置已生效。

您已将应用部署到 LingCode Cloud，它现在运行在 lingcode.dev/apps/<id>/ 这个 URL 上。（还没部署？先看部署应用到 LingCode Cloud——一键 Cloud 按钮——再回来这里。）用默认 URL 测试没问题，但真正的产品需要 yourbrand.com 这样的域名。好消息是：为 Cloud 应用配置自定义域名只需两分钟，而且您完全不用管 TLS 证书——只要 DNS 指向 LingCode，边缘节点就会自动为您签发和续期 HTTPS。

"自定义域名"就是一扇友好的大门。您的应用已经运行在 LingCode 的基础设施上；绑定域名就是在告诉边缘节点："当收到 yourbrand.com 的请求时，提供这个应用。"让应用正常工作的一切——HTML、哈希过的 JavaScript 文件、客户端路由——都会在您的域名下以完全相同的方式提供，只是换上了您的品牌名称和您的小锁头。

整个过程分为两个部分，值得分开来看，因为它们在两个不同的地方完成：绑定域名（在 IDE 中——告诉 LingCode 这个域名属于您）和指向域名（在您的注册商处——告诉互联网域名在哪里）。两者都满足后，站点才能正常加载。本教程将逐一讲解，解释 DNS 的选择方式，并介绍两个常见的坑。

您将学到什么

自定义域名如何到达您的 Cloud 应用——以及为什么 HTTPS 是自动的
完整步骤：在 IDE 中绑定，然后添加一条 DNS 记录
何时使用 CNAME，何时使用 A 记录（子域名 vs 根域名）
一步同时添加根域名和 www
Cloudflare"橙云"会导致证书签发失败的注意事项
读懂 Pending → Verified 状态，以及如何解绑域名

工作原理（30 秒版本）

LingCode 在您的应用前面运行一个边缘节点。当您绑定一个域名时，LingCode 会记录 yourbrand.com 属于您的应用。当浏览器访问 yourbrand.com 时，边缘节点会确认该域名已注册，按需申请一个免费的 Let's Encrypt 证书，然后通过 HTTPS 提供您的应用——包括每个 /assets/… 文件和单页应用的所有深层链接。您永远不需要生成、上传或续期证书。

"按需"这个细节解释了为什么顺序有点重要：证书是在 DNS 指向 LingCode 之后，第一次有人访问该域名时签发的。所以您先绑定，再设置 DNS，几分钟后第一次访问就会让它正式上线。

第 1 步——在 IDE 中绑定域名

在 Mac IDE 中登录您的 LingCode 账号——应用归此账号所有。
如果还没部署，先部署应用：打开项目，点击工具栏中的 Cloud 按钮（），设置构建命令和输出目录，然后点击 Deploy。您会得到一个 lingcode.dev/apps/<id>/ 的在线 URL。
在成功面板中展开 Custom domain，输入您的域名（例如 app.yourbrand.com 或 yourbrand.com），然后点击 Attach。
如果输入的是根域名或 www 域名，保持勾选 "Also add <the other>" 以同时注册两者。

IDE 随后会显示您需要添加的 DNS 记录，以及每个域名的状态指示点——橙色（Pending DNS）表示 DNS 记录尚未生效，绿色（Verified）表示已成功指向 LingCode。

第 2 步——将域名指向 LingCode

前往您域名的 DNS 管理处（注册商，或负责您名称服务器的服务商），添加以下其中一条记录。IDE 会显示两种选项，选择适合您的那种：

子域名（如 app.yourbrand.com）→ CNAME 记录，指向 apps.lingcode.dev。这是推荐选项——即使 IP 地址变更，它也会自动跟踪我们的边缘节点。
根域名 / 顶级域名（如 yourbrand.com，没有子域名前缀）→ A 记录，指向 138.197.107.228。顶级域名无法使用 CNAME，这就是为什么需要 A 记录。

如果您同时绑定了根域名和 www，需要为每个分别添加对应记录：根域名添加 A 记录，www 添加 CNAME 记录（指向 apps.lingcode.dev）——这是最常见的组合。

不确定您的 DNS 在哪里管理？

通常在您购买域名的地方。我们提供了常见注册商的分步指南——Namecheap、Cloudflare、GoDaddy、Porkbun 等——另外还有一份通用教程通过 DNS 连接域名。无论在哪里添加记录，记录类型和目标值都是一样的。

第 3 步——等待生效

DNS 变更的生效时间从几分钟到（少数情况下）一小时不等。当您的记录解析到 LingCode 边缘节点时，IDE 的状态点会变绿；此后第一次访问会签发证书，站点就正式通过 HTTPS 上线了。您也可以直接在浏览器中打开 https://yourbrand.com——第一次加载可能稍有延迟（证书正在签发），之后就会瞬间响应。

Cloudflare 用户——唯一真正的坑：如果您的 DNS 在 Cloudflare 上，请将记录设置为仅 DNS（灰云），而不是代理模式（橙云）。启用代理后，Cloudflare 会自己终止 TLS，导致 LingCode 的边缘节点永远收不到用于签发证书的请求——站点会显示 TLS 错误。改为灰云模式就正常了。（如果您确实需要 Cloudflare 在前面，那是另一种配置——参见将 Cloudflare 放在任意主机前面。）

后续域名管理

随时重新打开 Custom domain 区域，查看绑定到某个应用的所有域名及其实时状态。要移除某个域名，点击旁边的 ✕——立即解绑（您的应用继续在默认 URL 和其他绑定域名上运行）。使用同一项目重新部署应用不会影响已绑定的域名：部署会原地更新文件，域名仍然指向同一个应用。

几点值得知道的事：一个域名同时只能绑定到一个应用（绑定已被使用的域名会被拒绝）；*.lingcode.dev 名称为系统保留；域名归属于 IDE 当前登录的 LingCode 账号。