对于部署在 Firebase 应用托管上的应用,您不必放弃能够凸显品牌的独有域名。您可以为 Firebase 托管的网站使用自定义网域(如 example.com
或 app.example.com
),而不是 Firebase 生成的网域。Firebase App Hosting 会为您的各个网域预配 SSL 证书。
本文档的其余部分将逐步介绍关联自定义网域的操作。
针对 App Hosting 设置您的网域
确保您已完成基本的 App Hosting 设置任务,这样您的 Firebase 项目中就有一个 Firebase App Hosting 网站。
第 1 步:添加自定义网域
- 打开项目的“应用托管”页面。
- 使用查看信息中心选项选择 App Hosting 后端。
- 选择设置标签页,然后点击添加自定义网域。
- 输入您要关联到 App Hosting 网站的自定义域名。
- (可选)选中相应的复选框,将针对自定义网域的所有请求重定向到第二个指定网域(使
example.com
和www.example.com
重定向到相同的内容)。 - 点击继续以配置您的 DNS 记录并完成自定义网域设置。
第 2 步:设置自定义网域
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 管理网站中的主机字段输入不同的输入。我们在下方汇总了来自常见提供商的常见输入。如需查看详细说明,请参阅域名提供商的文档。
网域类型 | 自定义网域键 |
---|---|
顶端网域 |
常见输入包括:
|
子网域 | 常见输入包括:
|
常见的域名提供商
以下是一些常见的域名提供商以及每个提供商可能要求的输入类型。 此部分信息会尽可能及时更新,但详细说明请以域名提供商的文档为准。
自定义网域的状态说明
状态 | 说明 |
---|---|
需要设置 |
您可能需要更改 DNS 记录的某个配置。
|
待处理 | 您已正确设置了自定义网域,但 Firebase App Hosting 尚未预配 SSL 证书。 有时,限制过于严格的 CAA 记录可能会阻止为自定义网域创建 SSL 证书。确保允许证书授权机构“letsencrypt.org”和“pki.goog”为您的网域创建 SSL 证书。 |
正在创建证书 | 正在为您的网域生成 SSL 证书。 |
已连接 | 您的自定义网域具有正确的 DNS 记录和 SSL 证书。 |