連結自訂網域

你不必特意為以品牌為主的獨特網域名稱， 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 憑證。

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

    • Host (主機)：輸入您的 apex 網域金鑰。

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

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

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

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

      網域供應商可能會將這個字詞列為「資料」。

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

    請注意，您可以按一下「Cancel」，安全關閉「Connect Domain」 並稍後再重新開啟這不會影響傳播 但系統會提示您 此時，重新輸入網域名稱 重新開啟視窗

    過一陣子生效後，請按一下「Connect Domain」(連結網域) 中的「Verify」(驗證) Firebase 控制台的視窗可讓您啟動 SSL 憑證 佈建程序。

    在多數情況下，你的記錄和網域驗證資訊就會傳播 作業會在幾小時內完成，具體取決於您的網域供應商。詳情請參閱 網域供應商的說明文件 TXT 記錄和傳播時間。

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

，瞭解如何調查及移除這項存取權。

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

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

「進階設定」精靈會協助您建立 SSL 憑證並 擁有權聲明，允許「Hosting」在網域之前提供流量 接收流量

等待 SSL 憑證佈建作業

我們驗證網域擁有權後，我們會為您的 並在 24 小時內部署至全球 CDN 對 Firebase Hosting 的 DNS A 記錄。

您的網域會在 FirebaseApp SSL 憑證。您可以使用瀏覽器的 安全工具當網域正在佈建時，可能會看到無效的 憑證。這是標準處理中 程序，並在網域憑證可用後予以解決。

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

您的自訂網域金鑰

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

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

常見的輸入內容包括：

  • @
  • 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」可以為 你的網域。
  • 你的驗證碼無效。
    如要使用「進階」模式 設定流程和遷移失敗，您的權杖 (及其驗證問題) 代碼) 將會失效。
    疑難排解提示：針對網域按一下「查看」， 然後將新的權杖提供給您現有的網域。
  • 您要求取得憑證的子網域過多。
    疑難排解提示：一般來說，Firebase Hosting 建議不要 單一 Apex 自訂網域和超過 20 個子網域，因為安全資料傳輸層 (SSL) 憑證限制。
挖掘證書

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

自訂網域具備正確的 DNS 記錄且採用安全資料傳輸層 (SSL) 憑證
您可以提供網站內容。