Docs 菜单
Docs 主页
/ /
Atlas App Services
/ /

使用自定义域名

在此页面上

  • Overview
  • 步骤

您可以为托管内容使用自己的自定义域名。默认情况下,您上传的内容可在如下形式的域名上访问:

<Your App ID>.mongodbstitch.com

您可以从 App Services 用户界面中为应用程序的托管内容配置自定义域名,也可以导入config.json 配置文件中指定域的应用程序配置目录以进行配置。选择下面与您要使用的方法对应的标签页。

1

您必须拥有要从其提供内容服务的自定义域名。如果您尚未拥有要使用的域名,您将需要从域名注册商处购买。

2

您需要先向 App Services 提供自定义域名,然后它才会从该域名提供内容服务。要指定域,请执行以下步骤:

  1. 单击左侧导航菜单中的 Hosting(应用用户)。

  2. 单击 Settings 标签页。

  3. Custom Domain 下,将切换开关设置为 Enabled

  4. Enabled 开关按钮下的输入框中输入自定义域。此值应为根域,不含任何子域。例如,您应该输入 example.com 而不是 www.example.com

  5. 单击 Save(连接)。

注意

如果在自定义域名验证期间遇到错误,App Services 会向项目所有者发送一封电子邮件,提醒他们存在问题。

3

要验证您是否拥有该域,必须添加新的 CNAME记录 在域的 DNS 配置中。Custom Domain部分将包括一个信息框,其中列出了要在记录中使用的托管名和目标值。

添加验证记录后,DNS 记录可能需要一些时间才能传播。App Services 会定期检查域的 DNS 记录有无验证 CNAME,如果发现该记录,则会将该域标记为已验证。

提示

故障排除

  • 在 App Services 用户界面的 Name 字段中,App Services 提供了 CNAME 记录的完整地址:<Subdomain>.<Your Base Domain>。然而,许多托管提供程序只是请求将 <Subdomain> 部分放入其用户界面中。如果遇到问题,请查看托管提供程序的文档,了解如何添加 CNAME 记录。

  • 如果您的 DNS 提供程序代理对域的请求,App Services 可能无法找到验证记录。如果 App Services 无法验证您的域,请确保您已在 DNS 提供程序上禁用验证 CNAME 记录的任何 HTTP 代理。

  • 如果在自定义域名验证期间遇到错误,App Services 会向项目所有者发送一封电子邮件,提醒他们存在问题。

4

App Services 验证您的域后,剩下的工作就是为域添加指向默认 App Services 域的 CNAME DNS 记录。使用以下主机名和目标值:

说明
主机名
例如 www 这样的子域。
目标

应用程序的默认域。该值在 Hosting 页面的 Settings 标签页中列为 App Services Domain。默认域的形式如下:

<Your App ID>.mongodbstitch.com
1

您必须拥有要从其提供内容服务的自定义域名。如果您尚未拥有要使用的域名,您将需要从域名注册商处购买。

2

要使用App Services CLI配置自定义域名,您需要应用程序配置文件的本地副本。

要提取最新版本应用的本地副本,请运行以下命令:

appservices pull --remote="<Your App ID>"

提示

您还可以从 App Services 用户界面的Deploy > Import/Export App屏幕下载应用程序配置文件的副本。

3

hosting/config.json中,设立custom_domain设置为您的自定义域名,然后保存文件。

hosting/config.json
{
"enabled": true,
"custom_domain": "example.com"
}

注意

custom_domain的值应为根域,不含任何子域。 示例,您应该输入example.com而不是www.example.com

4

指定自定义域名后,您可以导入应用程序目录。

导航到应用程序的根目录并运行以下命令:

appservices import --include-hosting
5

更新并保存hosting/config.json后,您可以将更新的配置推送到远程应用。 App Services CLI会立即在推送时部署配置,并且App Services会立即开始尝试验证您的域名。

appservices push --remote="<Your App ID>" --include-hosting
6

要验证您是否拥有该域,必须添加新的 CNAME记录 在域的 DNS 配置中。您可以在App Services用户界面Hosting > Settings标签页的记录Custom Domain部分找到要使用的托管名和目标值。

添加验证记录后,DNS 记录可能需要一些时间才能传播。App Services 会定期检查域的 DNS 记录有无验证 CNAME,如果发现该记录,则会将该域标记为已验证。

提示

故障排除

  • 在 App Services 用户界面的 Name 字段中,App Services 提供了 CNAME 记录的完整地址:<Subdomain>.<Your Base Domain>。然而,许多托管提供程序只是请求将 <Subdomain> 部分放入其用户界面中。如果遇到问题,请查看托管提供程序的文档,了解如何添加 CNAME 记录。

  • 如果您的 DNS 提供程序代理对域的请求,App Services 可能无法找到验证记录。如果 App Services 无法验证您的域,请确保您已在 DNS 提供程序上禁用验证 CNAME 记录的任何 HTTP 代理。

  • 如果在自定义域名验证期间遇到错误,App Services 会向项目所有者发送一封电子邮件,提醒他们存在问题。

7

App Services验证您的域后,剩下要做的就是为您的域添加一个或多个点默认App Services域的CNAME DNS 记录。 使用以下托管名和目标值:

说明
主机名
例如 www 这样的子域。
目标

应用程序的默认域。该值在 Hosting 页面的 Settings 标签页中列为 App Services Domain。默认域的形式如下:

<Your App ID>.mongodbstitch.com

注意

添加 App Services 的 AWS CAA 以验证您的域

如果您在验证域名时遇到问题:

  • 清除任何不必要的 CAA 来自站点记录的

  • 添加以下 CAA 记录:

    记录类型
    Flags
    Tag
    www.example.com
    CAA
    0
    issue
    "amazon.com"
    www.example.com
    CAA
    0
    issue
    "amazontrust.com"
    www.example.com
    CAA
    0
    issue
    "awstrust.com"

后退

使用自定义 404 页面

在此页面上