连接你已有的域名

如果你已经拥有一个域名（无论是在 GoDaddy、Namecheap、Google、Cloudflare 还是其他地方购买的），都可以用它来显示你的 MonstarX 应用。域名留在原处不动。你只需添加一条 DNS 记录（域名设置中的一行，说明这个地址应该指向哪里），其余的事情都由 MonstarX 完成，包括 HTTPS。

开始之前

• 你的应用已经发布。请参阅发布你的应用。
• 你能登录管理域名 DNS 的地方（通常是你购买域名的公司，或者 Cloudflare）。
• 决定使用哪个地址：

地址类型	示例	你需要做什么
子域名	www.brewandbean.com、order.brewandbean.com	在你当前的 DNS 提供商处添加一条 CNAME 记录。其他都不用改。
根域名	brewandbean.com	域名的 DNS 必须托管在 Cloudflare 上（免费的 Cloudflare 账户即可）。

提示

想让 DNS 留在原处？连接 www.yourdomain.com，然后在你的 DNS 提供商处设置从根域名到 www 的重定向。

如何连接我的域名？

1. 打开你的项目，点击 发布，然后在 域名 下点击 连接已有域名。

   

2. 选择 根域名 或 子域名。

3. 在 要连接的域名 中输入完整地址，不要包含 https:// 或路径，例如 order.brewandbean.com。点击 连接域名。

4. 在 为此地址设置 DNS 下，MonstarX 会显示需要添加的记录。按照下面对应地址类型的步骤操作。

5. 等待状态从 等待 DNS 变为 正在签发证书，再变为 有效。点击 刷新状态 查看。这可能需要一点时间。

需要添加什么 DNS 记录？

子域名（www、app、order…）

在你当前的 DNS 提供商处添加这条记录。你不需要更改名称服务器。

类型	名称 / 主机	值 / 目标
CNAME	你的完整子域名，例如 order.brewandbean.com	customers.monstarx.app

有些提供商只要求填写根域名前面的部分：填 order，而不是 order.brewandbean.com。

根域名（yourbrand.com）

根域名需要使用你自己 Cloudflare 账户中的 Cloudflare DNS。不使用 MonstarX 的名称服务器。

1. 把这个域名添加到你的 Cloudflare 账户中（如果已经在里面，直接打开）。请确认 Cloudflare 中包含你所有现有的 DNS 记录，尤其是邮件记录。
2. 在这个域名的 Cloudflare DNS 中，为 @ 添加一条指向 customers.monstarx.app 的 CNAME，并把 代理状态（Proxy status）设为 仅 DNS（DNS only，灰色云朵图标）。Cloudflare 会自动扁平化根域名的 CNAME 记录。
3. 如果 Cloudflare 还不是你的 DNS 提供商，在这个域名的 概述（Overview）页面找到 Cloudflare 分配的两个名称服务器，然后在你的域名注册商处，把当前的名称服务器替换为这两个准确的地址。如果开启了 DNSSEC，请按照 Cloudflare 的 DNSSEC 说明操作。

MonstarX 无法替你更改 DNS 或注册商设置，因为它没有这些账户的访问权限。DNS 指向 MonstarX 之后，路由和 HTTPS 证书都会自动处理。

让根域名和 www 都能访问

连接域名时，只有你输入的那个准确地址会生效。连接 brewandbean.com 不会让 www.brewandbean.com 生效，连接 www.brewandbean.com 也不会让根域名生效。

如果你连接的是根域名，并且使用 Cloudflare DNS，可以让 www 重定向到根域名：

1. 添加一条已代理（橙色云朵图标）的 CNAME，名称为 www，目标为 brewandbean.com。根域名自己的记录保持上文所示不变。
2. 在 Cloudflare 中打开 规则 → 重定向规则（Rules → Redirect Rules），创建一条 301 规则。匹配 http*://www.brewandbean.com/*，重定向到 https://brewandbean.com/${2}。启用 保留查询字符串（Preserve query string）。这样访客切换到根地址时，路径和查询参数都会保留。请参阅 Cloudflare 从 www 重定向至根域名的指南。

如果你连接的是 www，请使用 DNS 提供商的转发功能把根域名转到 www，或者通过 Cloudflare DNS 单独连接根域名。通过 MonstarX 购买的域名已经自动支持两个地址。

各个状态是什么意思？

状态	含义
等待 DNS	MonstarX 还看不到你的记录。请确认记录已保存，然后等待，DNS 更改可能需要一段时间才能在全网生效。
正在签发证书	已找到记录，正在生成 HTTPS 证书。
有效	你的应用已在这个域名上线，并带有 HTTPS。
需要处理（或一条错误信息）	出了问题。阅读提示信息，修正记录，然后点击 重试 或 刷新状态。

已连接的域名会列在“发布”菜单中、“域名”窗口的 连接到此项目的域名 下，以及设置 → 域名中。点击 DNS 设置步骤 可以再次查看记录。

如何停止使用某个域名？

点击它旁边的垃圾桶图标（或“发布”菜单中的 ×），然后在“停止在 … 上提供此项目？”提示中确认。你的应用将不再通过这个域名访问；域名本身仍然归你所有，你的应用也会继续在它的 monstarx.app 地址上线。同时，请在你的 DNS 提供商处删除那条 CNAME 记录。

问题排查

• “此地址是根域名，请选择‘根域名’进行连接。”：你输入了 yourbrand.com，却选择了 子域名（或者反过来）。请选择对应的类型。
• “请输入有效域名，例如 example.com 或 www.example.com。”：去掉 https://、空格或域名后面的任何内容。
• “此域名已映射到另一个应用。”：这个地址已经连接到另一个项目。请先在那里移除它。
• monstarx.app 地址 无法连接，因为它们由 MonstarX 管理。请改为在你的应用的地址中更改。
• 一直停在“等待 DNS”：检查记录类型是否为 CNAME，值是否正好是 customers.monstarx.app，以及（在 Cloudflare 上）云朵图标是灰色而不是橙色。
• 托管在其他 DNS 服务商（非 Cloudflare）的根域名 无法通过这种方式连接。请使用 www，或者把域名的 DNS 迁到 Cloudflare。
• 域名什么都不显示：请发布应用。“域名”窗口会提醒你：“也请发布应用，让此地址有内容可显示。”
• 根域名能用但 www 不行（或者反过来）：每个主机名都需要单独设置 DNS。请按照让根域名和 www 都能访问操作。

常见问题

我需要把域名转移到 MonstarX 吗？

不需要。域名仍然留在你购买它的公司。你连接的地址只需要一条 DNS 记录；要同时使用根域名和 www，则需要再加一条记录和一个重定向。

我需要购买 SSL 证书吗？

不需要。DNS 记录生效后，MonstarX 会自动签发 HTTPS 证书。

为什么根域名需要 Cloudflare？

大多数 DNS 提供商不允许在根域名上设置能在这里正常使用的 CNAME 记录。Cloudflare DNS 可以，而且免费的 Cloudflare 账户就够了。你也可以连接 www，再把根域名重定向过去。

可以把多个域名连接到同一个应用吗？

可以。逐个连接即可；它们都会显示你的应用。

通过 MonstarX 购买域名会更简单吗？

是的。在 MonstarX 购买的域名完全不需要配置 DNS，根域名和 www 都能访问。请参阅购买域名。

相关内容

购买域名无需配置 DNS 的选择：点几下就能买到。

你的所有域名你所有应用的全部域名。

你自己的 Cloudflare 账户在你的 Cloudflare 账户上运行应用，并使用你的域名。