转到控制台

关联自定义网域

您可以将自定义网域(例如 example.commyrealtimeapp.example.com)关联到 Firebase 托管网站。

Firebase 托管会为您的各个网域预配 SSL 证书,并通过全球级 CDN 向用户分发您的内容。

通常,由于 SSL 证书创建限制,Firebase 托管建议任何顶层自定义网域的子网域不要超过 20 个。

针对 Firebase 托管设置您的网域

确保您已在项目的“Firebase 托管”页面中完成了“开始使用”向导部分,这样您的 Firebase 项目中就有一个 Firebase 托管网站。

  1. 在项目的托管页面,进入用于关联自定义网域的向导:

    • 如果您只有一个托管网站,请点击关联网域
    • 如果您有多个托管网站,请点击查看以找到所需网站,然后点击关联网域
  2. 输入您要与托管网站关联的自定义网域。

  3. (可选)选中相应的复选框,将针对此自定义网域的所有请求重定向至第二个指定网域。

  4. 点击继续以启动验证过程。然后,如果系统有相关要求,请按照设置向导中的说明验证您的网域所有权。

    这些步骤可确保您的网域尚未与 Firebase 项目关联,并且您对指定网域拥有所有权。

  5. 为完成自定义网域设置,大多数情况下都可以使用快速设置模式。

    不过,如果您已有一个在其他托管服务提供商那里运行的网站,且需要进行零停机迁移,请从设置模式下拉列表中选择高级设置

    • 快速设置 - 将网域的 DNS A 记录指向 Firebase 托管。

    • 高级设置 - 按照屏幕上的说明更新网域的 DNS TXT 记录或将文件上传到现有网站的指定位置。验证完成后,您可以安全地将您的 DNS A 记录指向 Firebase 托管。

  6. 在您将 DNS A 记录指向 Firebase 托管后的 24 小时内,Firebase 会预配 SSL 证书

自定义网域的设置状态说明

状态 说明
需要设置

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

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

  • 极少数情况下,尤其是当您使用高级设置流程时,SSL 挑战可能失败,原因如下:

    • 您的 DNS 记录具有指向其他托管服务提供商的 A 记录或 CNAME 记录。
      问题排查提示:检查您的 A 记录是否仅指向 Firebase 托管,并移除所有 CNAME 记录。
    • 迁移失败,令牌(DNS TXT 记录或提供给您的网站的已上传文件)现在无效。
      问题排查提示:点击查看以找到网域,然后为现有网域提供新令牌。
待处理

您正确设置了自定义网域,但 Firebase 托管未预配 SSL 证书。

有时,下列问题可能会阻碍系统为自定义网域创建 SSL 证书:

  • 您的 CAA 记录的限制过多。
    问题排查提示:确保允许证书授权机构 Let's Encrypt 为您的网域创建 SSL 证书。
  • 您的挑战代码无效。
    如果您使用的是高级设置流程,并且迁移失败,则您的令牌(及其挑战代码)现在无效。问题排查提示:点击查看以找到网域,然后为现有网域提供新令牌。
  • 您为过多的子网域请求了证书。
    问题排查提示:通常,由于 SSL 证书创建限制,Firebase 托管建议一个顶层自定义网域的子网域不要超过 20 个。
已连接

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

等待预配 SSL 证书

验证网域所有权后,我们将为您的网域预配 SSL 证书,并在我们的全球 CDN 上进行部署。此过程可能需要数小时,但您项目的 Firebase 托管页面将显示进度消息。

您的网域将在 FirebaseApp SSL 证书中作为一个主题备用名称 (SAN) 列出。您可以使用浏览器的安全工具查看此证书。在网域预配过程中,您可能会看到未包含您的域名的无效证书。这是此流程的正常环节,在您的网域证书有效后便会恢复正常。