使用 Firebase Hosting 时,您不必放弃能够凸显品牌的独有域名。您可以选择不使用 Firebase 生成的网域,而是为托管的网站使用自定义网域(如 example.com
或 app.example.com
)。
Firebase Hosting 会为您的各个网域配置 SSL 证书,并通过全球级 CDN 向用户分发您的内容。
本文档的其余部分将逐步介绍关联自定义网域的操作。
针对 Hosting 设置您的网域
确保您已在项目的 Firebase Hosting 页面中完成了“使用入门”向导中的步骤,这样您的 Firebase 项目中就有一个 Firebase Hosting 网站。
第 1 步:添加网域
在项目的 Hosting 页面,进入用于关联自定义网域的向导:
- 如果您只有一个 Hosting 网站,请点击添加自定义网域。
- 如果您有多个 Hosting 网站,请点击查看找到所需网站,然后点击添加自定义网域。
输入您希望与 Hosting 网站关联的自定义域名。
(可选)选中相应的复选框,将针对该自定义网域的所有请求重定向到另一个指定网域(以便让
example.com
和www.example.com
重定向到相同的内容)。点击继续,启动验证过程。
第 2 步:验证网域所有权
如果关联网域设置向导中要求验证顶端网域,请进行验证。
以下步骤可确保您的网域尚未与 Firebase 项目关联,并且您对指定网域拥有所有权。
在域名提供商的网站中,找到 DNS 管理页面。
输入以下信息添加并保存新记录:
类型:添加 TXT 记录。
Firebase Hosting 要求您将此 TXT 记录持续保留在您的 DNS 设置中,以证明您对网域的所有权,并授权 Firebase 为您的网站分配和续订 SSL 证书。
此术语在您的域名提供商处可能显示为“记录类型”。
主机:输入您的顶端网域键。
通过证明您对顶端网域(或根网域)的所有权,证明您对其所有子网域的所有权。
此术语在您的域名提供商处可能显示为“主机名”“名称”或“网域”。
值:将唯一验证值复制到该字段中。
Firebase Hosting 会检查该值,以证明您对网域的所有权。
此术语在您的域名提供商处可能显示为“数据”。
等待更新的 TXT 记录传播(最长可能需要 24 小时),然后点击验证。
请注意,您可以点击取消以安全地关闭关联网域窗口,稍后再重新打开。这不会影响传播时间,但重新打开此窗口时,系统将提示您重新输入您的域名。
充分传播后,在 Firebase 控制台的关联网域窗口中点击验证,即可开始 SSL 证书预配过程。
在大多数情况下,记录的传播和网域的验证将在数小时内完成,具体取决于您的域名提供商。如需详细了解如何添加 TXT 记录和具体的传播时间,请参阅域名提供商的文档。
如果点击验证后提示错误消息,则表示您的记录尚未传播完成,或者您的值可能不正确。
第 3 步:上线
在 Firebase 控制台的关联网域窗口中,选择快速设置(如果是新网站)或高级设置(如果您已有一个在其他托管服务提供商处运行的网站,需要零停机迁移)。
等待预配 SSL 证书
验证网域所有权后,我们将为您的网域预配 SSL 证书,并在您将 DNS A 记录指向 Firebase Hosting 后的 24 小时内,在我们的全球级 CDN 上部署该证书。
您的网域将在 FirebaseApp SSL 证书中作为一个主题备用名称 (SAN) 列出。您可以使用浏览器的安全工具查看此证书。在网域预配过程中,您可能会看到未包含您的域名的无效证书。这是此流程的正常环节,在您的网域证书有效后便会恢复正常。
对于高级设置用户,您的网站将由之前的托管服务提供商托管,直到您的项目的 Firebase Hosting 页面中的设置状态更新为已关联。
您的自定义网域键
添加或修改 DNS 记录时,不同的域名提供商要求您在其 DNS 管理网站中的主机字段输入的信息不同。我们在下方汇总了常见提供商通常会要求您输入的内容。 如需了解详情,请参阅域名提供商的文档。
网域类型 | 自定义网域键 |
---|---|
顶端网域 |
常见输入包括:
|
子网域 | 常见输入包括:
|
常见的域名提供商
以下是一些常见的域名提供商以及每个提供商可能要求的输入类型。 此部分信息会尽可能及时更新,但详细说明请以域名提供商的文档为准。
自定义网域的设置状态说明
状态 | 说明 |
---|---|
需要设置 |
您可能需要更改 DNS 记录的某个配置。
|
待处理 | 您正确设置了自定义网域,但 Firebase Hosting 未配置 SSL 证书。 有时,下列问题可能会阻碍系统为自定义网域创建 SSL 证书:
|
已连接 | 您的自定义网域具有正确的 DNS 记录和 SSL 证书。 |
需要重新验证 | 如果您在网域的 DNS 设置中更改或移除了最初验证网域所有权时添加的 TXT 记录,Firebase 可能会要求您手动重新验证网域所有权。
|