連結自訂網域

您不需要透過 Firebase 託管提供以品牌為主的獨特網域名稱。您可以使用自訂網域 (例如 example.com 或 app.example.com)，而非 Firebase 為託管網站產生的網域。

Firebase 託管會為每個網域佈建 SSL 憑證，並透過全球 CDN 提供內容。

本文件的其餘部分將逐步引導您完成連結自訂網域的步驟。

設定要用於託管的網域

確認您已完成專案 Firebase 託管頁面中的「Get Started」精靈，因此您的 Firebase 專案中有 Firebase 託管網站。

步驟 1：新增自訂網域

  1. 在專案的「Hosting」(託管) 頁面中，輸入連接自訂網域的精靈：

    • 如果只有一個 Hosting 網站，請按一下「新增自訂網域」。
    • 如果您擁有多個託管網站，請針對所需網站按一下「View」(檢視)，然後按一下「Add custom domain」(新增自訂網域)。

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

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

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

步驟 2：設定自訂網域

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

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

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

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

    • 類型：新增 TXT 記錄。

      Firebase 代管會要求您持續在 DNS 設定中保留此 TXT 記錄，以證明您的網域擁有權，並授權 Firebase 為您的網站指派及更新安全資料傳輸層 (SSL) 憑證。

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

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

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

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

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

      Firebase 託管會檢查這個值，證明您的網域擁有權。

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

  3. 更新後的 TXT 記錄最多需要 24 小時才會生效，接著點選「Verify」(驗證)。

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

    大量傳播後，在 Firebase 控制台的「Connect Domain」(連結網域) 視窗中按一下「Verify」(驗證)，即可開始 SSL 憑證佈建程序。

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

    如果按一下「Verify」(驗證) 提示訊息，表示系統尚未傳播記錄，或者值可能不正確。

在 Firebase 控制台的「Add Custom Domain」精靈中，選取「Quick Setup」或「Advanced Setup」。

快速設定適用於目前不會接收流量的新網域，或是您嘗試從其他託管網站轉移的網域。如果您的網域已透過其他主機供應商接收要求，且需要進行零停機時間遷移，則可使用進階設定。

「Advanced Setup」精靈將協助您建立 SSL 憑證和擁有權聲明，允許託管在接收流量之前於網域提供流量。

等待 SSL 憑證佈建作業

驗證網域擁有權後，我們會為您的網域佈建 SSL 憑證，並在您將 DNS A 記錄指向 Firebase 託管後的 24 小時內，部署至全球 CDN。

您的網域會在 FirebaseApp SSL 憑證中列為「主體別名」(SAN)。您可以使用瀏覽器的安全性工具查看這個憑證。當網域佈建時，您可能會看到不含網域名稱的無效憑證。此為正常流程，會在網域憑證可用後解決。

如為進階設定使用者，在專案的 Firebase 託管頁面中「已連結」的設定狀態中，網站會先由先前的代管服務供應商託管。

您的自訂網域金鑰

新增或編輯 DNS 記錄時，不同的網域供應商會預期您在其 DNS 管理網站的「Host」欄位中輸入不同的輸入內容。下方彙整了熱門供應商的常見輸入內容。 如需詳細操作說明，請參閱網域供應商的說明文件。

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

常見的輸入內容包括：

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

常見的輸入內容包括：

  • 完整的子網域名稱 (例如 app.example.com)
  • 只有子網域部分 (例如僅限 app，並省略 .example.com)
  • 只有 www.example.com 的子網域使用 www

常見網域供應商

以下列出一些常見的網域供應商，以及各家網域可能需要的輸入內容類型。系統會盡可能更新這項資訊，但如需詳細的操作說明，請參閱網域供應商的說明文件。

自訂網域的設定狀態說明

狀態 說明
需要設定

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

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

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

    • 安全資料傳輸層 (SSL) 憑證驗證失敗，因此權杖 (DNS TXT 記錄或提供給網站的上傳檔案) 現在無效。
      疑難排解提示：按一下所需網域的「查看」，然後將新權杖提供給您現有的網域。
待處理

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

有時候，以下問題可能會阻礙自訂網域的 SSL 憑證擷取作業：

  • 您的 CAA 記錄限制過多。
    疑難排解提示：請確認憑證授權單位「letsEncrypt.org」和「pki.goog」有權為您的網域建立 SSL 憑證。
  • 您的驗證碼無效。
    如果使用的是「進階設定」流程，但遷移失敗，您的權杖 (及其驗證碼) 現已失效。
    疑難排解提示：按一下所需網域的「查看」，然後將新權杖提供給您現有的網域。
  • 您要求取得憑證的子網域過多。
    疑難排解提示：基於 SSL 憑證限制的限制，Firebase 託管通常會建議將單一 Apex 自訂網域的子網域不超過 20 個。
挖掘證書

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

自訂網域具備適當的 DNS 記錄，並具備 SSL 憑證。
您可以提供網站內容。