連結自訂網域

您不必放棄使用 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：設定自訂網域

如果「連結網域」設定精靈要求，請驗證頂層網域。

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

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

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

    • 類型：新增 TXT 記錄。

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

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

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

      證明您是頂層網域 (或根網域) 的擁有者，就等於證明您擁有所有子網域。

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

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

      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 管理網站中，針對「Host」欄位輸入不同的內容。歡迎參考以下熱門供應商的常用資料。 如需詳細操作說明，請參閱網域供應商的說明文件。

網域類型 自訂網域鍵
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) 憑證
您可以提供網站內容。