您无需为部署在 Firebase App Hosting 上的应用放弃以品牌为中心的唯一域名。对于 Firebase 托管的网站,您可以使用自定义网域(如 example.com
或 app.example.com
),而不使用 Firebase 生成的网域。Firebase App Hosting 会为您的各个网域预配 SSL 证书。
本文档的其余部分将引导您完成关联自定义网域的步骤。
针对 App Hosting 设置您的网域
确保您已完成基本的 App Hosting 设置任务,以便在您的 Firebase 项目中拥有 Firebase App Hosting 网站。
第 1 步:添加自定义网域
- 打开您项目的“App Hosting”页面。
- 使用 View Dashboard 选项选择 App Hosting 后端。
- 选择设置标签页,然后点击添加自定义网域。
- 输入要关联到 App Hosting 网站的自定义域名。
- (可选)选中相应的复选框,将针对该自定义网域的所有请求重定向到另一个指定网域(使
example.com
和www.example.com
重定向到相同的内容)。 - 点击继续以配置 DNS 记录并完成自定义网域设置。
第 2 步:设置自定义网域
Firebase 控制台的添加自定义网域向导将显示需要更新以将您的网页指向 Firebase App Hosting 的必要记录。通过以下输入在 DNS 提供商中添加、移除和保存来自您网域的记录:
- 类型:添加提供的 DNS 记录。
主机:输入您的自定义网域密钥作为记录。您指定的主机是要在其中提供内容的网域;此网域可以是顶端网域,也可以是子网域。此术语在您的域名提供商处可能显示为“主机名”“名称”或“网域”。
值:将提供的值分配给您的记录。此术语在您的域名提供商处可能显示为“数据”“指向”“内容”“地址”或“IP 地址”。值字段的内容因记录类型而异,其中 A 记录和 AAAA 记录将 IP 地址作为值,而 TXT 记录是字符串。
等待预配您的 SSL 证书。在您将 DNS 指向 Firebase App Hosting 后,此过程最多可能需要几个小时。在大多数情况下,记录的传播和 SSL 证书的预配将在一小时内进行,具体取决于您的域名提供商。
等待预配 SSL 证书
更新 DNS 记录后,App Hosting 最多可能需要几个小时才能为您的网域预配 SSL 证书。
您可以使用浏览器的安全工具查看此证书。在网域预配过程中,您可能会看到无效证书,或无法连接到您的网域。这是此流程的正常环节,在您的网域证书可用后便会恢复正常。
注意:Firebase App Hosting 会根据需要自动为自定义网域重新预配 SSL 证书。
您的自定义网域键
添加或修改 DNS 记录时,不同的域名提供商要求您在其 DNS 管理站点内的主机字段输入不同的输入。我们在下方汇总了来自常见提供商的常见输入。如需了解详细说明,请参阅域名提供商的文档。
网域类型 | 自定义网域键 |
---|---|
顶端网域 |
常见输入包括:
|
子网域 | 常见输入包括:
|
常见的域名提供商
以下是一些常见的域名提供商以及每个提供商可能要求的输入类型。 此部分信息会尽可能及时更新,但详细说明请以域名提供商的文档为准。
自定义网域的状态说明
状态 | 说明 |
---|---|
需要设置 |
您可能需要更改 DNS 记录的某个配置。
|
待处理 | 您正确设置了自定义网域,但 Firebase App Hosting 尚未预配 SSL 证书。 有时,限制过于严格的 CAA 记录可能会导致自定义网域的 SSL 证书无法创建。确保允许证书授权机构“letsencrypt.org”和“pki.goog”为您的网域创建 SSL 证书。 |
正在创建证书 | 正在为您的网域生成 SSL 证书。 |
已连接 | 您的自定义网域具有正确的 DNS 记录和 SSL 证书。 |