連結自訂網域

你不必特意為以品牌為主的獨特網域名稱， Firebase Hosting。您可以使用自訂網域 (例如 example.com 或 app.example.com)，而不是 Firebase 為您的應用程式產生的網域 Firebase 代管的網站。

「Firebase Hosting」會為你的每個網域佈建 SSL 憑證 並透過全球 CDN 放送內容

本文件的後續內容會逐步說明如何連結自訂網域。

為 Hosting 設定網域

請確認您已完成專案 Firebase Hosting 頁面中的「開始使用」精靈，以便在 Firebase 專案中建立 Firebase Hosting 網站。

步驟 1：新增自訂網域

  1. 來自專案的 Hosting 頁面， 輸入連結自訂網域的精靈：

    • 如果你只有一個 Hosting 網站，請按一下「新增自訂網域」。
    • 如果您有多個 Hosting 網站，請依序按一下所需網站的「查看」和「新增自訂網域」。

  2. 輸入要連結至 Hosting 的自訂網域名稱 網站。

  3. (選用) 勾選方塊，即可將自訂網域上的所有要求重新導向至 做為第二個指定網域 (例如 example.com 和 www.example.com 會重新導向至相同的內容)。

  4. 按一下「Continue」(繼續) 即可設定 DNS 記錄，並完成自訂網域的設定程序。

步驟 2：設定自訂網域

如果已在「Connect Domain」設定精靈中要求， 驗證您的 Apex 網域。

這些步驟可確保您的網域未與 Firebase 專案連結，且您擁有指定的網域。

  1. 在網域供應商的網站中，找出 DNS 管理頁面。

  2. 使用下列輸入內容新增並儲存新記錄：

    • 類型：新增 TXT 記錄。

      Firebase Hosting 要求您必須持續保留這項 TXT 記錄 以證明您的網域擁有權， 授權 Firebase 為網站指派及更新 SSL 憑證。

      網域供應商可能會將這個詞彙列為「記錄類型」。

    • 主機：輸入頂層網域金鑰。

      證明您對 Apex 網域或根網域的擁有權，可證明您的 所有子網域的擁有權。

      網域供應商可能會將這個字詞列為「主機名稱」、「名稱」 或「網域」

    • 值：將專屬驗證值複製到欄位中。

      Firebase Hosting 會檢查這個值，證明您擁有網域。

      您的網域供應商可能會將這項條款列為「資料」。

  3. 更新後的 TXT 記錄最多可能需要 24 小時才會生效，接著，按一下 驗證。

    請注意，您可以點選「取消」來安全關閉「連結網域」視窗，並在稍後重新開啟。這不會影響傳播 但系統會提示您 此時，重新輸入網域名稱 重新開啟視窗

    在充分的傳播時間過後，您可以按一下 Firebase 主控台「Connect Domain」視窗中的「Verify」，開始 SSL 憑證佈建程序。

    在大多數情況下，記錄會在幾小時內完成傳播，網域也會在幾小時內完成驗證，具體時間視網域供應商而定。詳情請參閱 網域供應商的說明文件 TXT 記錄和傳播時間。

    如果點選「驗證」後出現錯誤訊息，表示您的記錄並未 否則值可能不正確。

在Firebase控制台的新增自訂網域精靈中，選取快速 設定或進階設定。

快速設定可用於目前未接收流量的新網域，或是您嘗試從其他 Hosting 網站轉移的網域。如果您已有網域接收網域，則可使用進階設定 轉移要求，且無須停機遷移。

進階設定精靈可協助您建立 SSL 憑證和擁有權聲明，讓 Hosting 在收到流量之前，先在網域上提供流量。

等待 SSL 憑證佈建作業

驗證網域擁有權後，我們會為您的網域佈建安全資料傳輸層 (SSL) 憑證，並在您將 DNS A 記錄指向 Firebase Hosting 後的 24 小時內，在全球 CDN 中部署該憑證。

您的網域會列為 FirebaseApp SSL 憑證中的其中一個主體別名 (SAN)。您可以使用瀏覽器的 安全工具當網域正在佈建時，可能會看到無效的 憑證。這是正常的程序，在網域憑證可用後就會解決。

如果是進階設定的使用者，網站會由先前的代管服務代管 直到 設定狀態的 專案的 Firebase Hosting 頁 更新為「已連線」。

您的自訂網域金鑰

新增或編輯 DNS 記錄時，不同網域供應商會要求您在 DNS 管理網站中，針對「Host」欄位輸入不同的內容。歡迎參考以下熱門供應商的常用資料。 如需詳細操作說明，請參閱網域供應商的說明文件。

網域類型 自訂網域金鑰
Apex 網域

常見的輸入內容包括：

  • @
  • 頂層網域名稱 (例如 example.com)
  • 將「Host」欄位留空
子網域

常見的輸入內容包括：

  • 完整的子網域名稱 (例如：app.example.com)
  • 僅輸入子網域部分 (例如只輸入 app，而省略 .example.com)
  • 只有 www 的子網域 www.example.com

常見網域供應商

以下列出一些常見的網域提供者，以及各自可能需要的輸入類型。盡可能更新這些資訊，但是您可以參考 網域供應商的說明文件

自訂網域的設定狀態說明

狀態 說明
需要設定

您可能需要使用 DNS 記錄變更設定。

  • 在大多數情況下，您的 DNS A 記錄並未傳播 將您的網域名稱供應商轉移至 Firebase Hosting 伺服器。
    疑難排解提示：如果處理時間超過 24 小時，請確認 你已將記錄指向 Firebase Hosting。

  • 在較少見的情況下，尤其是使用進階設定流程時，SSL 驗證可能會失敗，原因如下：

    • SSL 憑證挑戰失敗，因此權杖 (提供給網站的 DNS TXT 記錄或上傳檔案) 現已失效。
      疑難排解提示：按一下網域的「查看」，然後將新的權杖提供給現有網域。
待處理

您正確設定自訂網域，但 Firebase Hosting 尚未佈建 SSL 憑證。

有時候，以下問題可能會阻礙 SSL 的挖掘 更新為自訂網域的憑證：

  • CAA 記錄限制過多。
    疑難排解提示：確認憑證授權單位 `letsEncrypt.org` 和「pki.goog」可以為 你的網域。
  • 驗證碼無效。
    如果您使用的是進階設定流程，且遷移作業失敗，則您的權杖 (及其驗證碼) 現已失效。
    疑難排解提示：針對網域按一下「查看」， 然後將新的權杖提供給您現有的網域。
  • 您要求取得憑證的子網域過多。
    疑難排解提示：由於 SSL 憑證鑄造限制，Firebase Hosting 一般建議在一個頂層自訂網域中，最多只能有 20 個子網域。
挖掘證書

系統正在為您的網域產生 SSL 憑證。
已連結

您的自訂網域具備正確的 DNS 記錄，且有 SSL 憑證。
您可以提供網站內容。