关联自定义网域

对于部署在 Firebase 应用托管上的应用,您不必放弃能够凸显品牌的独有域名。您可以为 Firebase 托管的网站使用自定义网域(如 example.comapp.example.com),而不是 Firebase 生成的网域。Firebase App Hosting 会为您的各个网域预配 SSL 证书。

本文档的其余部分将逐步介绍关联自定义网域的操作。

针对 App Hosting 设置您的网域

确保您已完成基本的 App Hosting 设置任务,这样您的 Firebase 项目中就有一个 Firebase App Hosting 网站。

第 1 步:添加自定义网域

  1. 打开项目的“应用托管”页面
  2. 使用查看信息中心选项选择 App Hosting 后端。
  3. 选择设置标签页,然后点击添加自定义网域
  4. 输入您要关联到 App Hosting 网站的自定义域名。
  5. (可选)选中相应的复选框,将针对自定义网域的所有请求重定向到第二个指定网域(使 example.comwww.example.com 重定向到相同的内容)。
  6. 点击继续以配置您的 DNS 记录并完成自定义网域设置。

第 2 步:设置自定义网域

  1. Firebase 控制台的添加自定义网域向导将显示需要更新以将您的页面指向 Firebase App Hosting 的必要记录。通过输入以下信息,在 DNS 提供商中添加、移除和保存您的域名的记录:

    • 类型:添加提供的 DNS 记录。
    • 主机:为记录输入您的自定义网域键。您指定的主机是要在其中提供内容的网域;此网域可以是顶端网域,也可以是子网域。此术语在您的域名提供商处可能显示为“主机名”“名称”或“网域”。

    • :将提供的值分配给记录。此术语在您的域名提供商处可能显示为“数据”“指向”“内容”“地址”或“IP 地址”。value 字段的内容因记录类型而异,A 和 AAAA 记录具有 IP 地址作为值,而 TXT 记录是字符串。

等待系统配置您的 SSL 证书。将 DNS 指向 Firebase App Hosting 后,此过程最多可能需要几个小时。在大多数情况下,记录的传播和 SSL 证书的预配将在一小时内完成,具体取决于您的域名提供商。

等待预配 SSL 证书

更新 DNS 记录后,App Hosting 最多可能需要几个小时才能为您的网域预配 SSL 证书。

您可以使用浏览器的安全工具查看此证书。在网域预配过程中,您可能会看到证书无效或在连接到您的网域时遇到问题。这是此流程的正常环节,在您的网域证书可用后便会恢复正常。

注意:Firebase 应用托管会根据需要自动为自定义网域重新预配 SSL 证书。

您的自定义网域键

添加或修改 DNS 记录时,不同的域名提供商要求您在其 DNS 管理网站中的主机字段输入不同的输入。我们在下方汇总了来自常见提供商的常见输入。如需查看详细说明,请参阅域名提供商的文档。

网域类型 自定义网域键
顶端网域

常见输入包括:

  • @
  • 顶端域名(例如 example.com
  • 主机字段留空
子网域

常见输入包括:

  • 完整的子域名(例如 app.example.com
  • 仅限子网域部分(例如,仅 app,省略 .example.com
  • www.example.com 子网域的 www 部分

常见的域名提供商

以下是一些常见的域名提供商以及每个提供商可能要求的输入类型。 此部分信息会尽可能及时更新,但详细说明请以域名提供商的文档为准。

自定义网域的状态说明

状态 说明
需要设置

您可能需要更改 DNS 记录的某个配置。

  • 在大多数情况下,您的 DNS A 记录没有从域名提供商传播到 Firebase App Hosting 服务器。
    问题排查提示:如果已超过 24 小时,请检查您是否已将记录指向 Firebase App Hosting。

  • 在极少数情况下,SSL 质询可能会失败,因为您的 DNS 记录具有指向其他托管服务提供商的 A 记录或 CNAME 记录。
    问题排查提示:检查您的 A 记录是否仅指向 Firebase App Hosting,并移除所有 CNAME 记录。

待处理

您已正确设置了自定义网域,但 Firebase App Hosting 尚未预配 SSL 证书。

有时,限制过于严格的 CAA 记录可能会阻止为自定义网域创建 SSL 证书。确保允许证书授权机构“letsencrypt.org”和“pki.goog”为您的网域创建 SSL 证书。

正在创建证书

正在为您的网域生成 SSL 证书。

已连接

您的自定义网域具有正确的 DNS 记录和 SSL 证书。
您可以提供网站的内容。