产品 使用场景 价格 文档 支持
转到控制台

关联自定义网域

您可以将自定义网域（例如 example.com 或 myrealtimeapp.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) 列出。您可以使用浏览器的安全工具查看此证书。在网域预配过程中，您可能会看到未包含您的域名的无效证书。这是此流程的正常环节，在您的网域证书有效后便会恢复正常。