連結自訂網域

使用 Firebase Hosting 時，您不必放棄以品牌為中心的專屬網域名稱。您可以為 Firebase 託管網站使用自訂網域 (例如 example.com 或 app.example.com)，而非 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. 按一下「繼續」，設定 DNS 記錄並完成自訂網域設定。

步驟 2：設定自訂網域

如果「連結網域」設定精靈要求您驗證頂層網域，請按照指示操作。

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

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

  2. 新增並儲存一筆記錄，輸入下列資訊：

    • 類型：新增 TXT 記錄。

      Firebase Hosting 需要您持續在 DNS 設定中保留這項 TXT 記錄，以證明您擁有網域，並授權 Firebase 為您的網站指派及續約 SSL 憑證。

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

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

      證明您是頂層網域或根網域的擁有者，即表示您是所有子網域的擁有者。

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

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

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

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

  3. 更新的 TXT 記錄最多可能需要 24 小時才會生效，請稍待片刻，然後按一下「驗證」。

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

    經過充足的傳播時間後，在 Firebase 控制台的「Connect Domain」(連結網域)視窗中按一下「Verify」(驗證)，即可開始佈建 SSL 憑證。

    一般來說，記錄傳播和網域驗證程序會在幾小時內完成，實際時間視網域供應商而定。如需新增 TXT 記錄和傳播時間的詳細操作說明，請參閱網域供應商的說明文件。

    如果點選「驗證」時出現錯誤訊息，表示記錄尚未傳播，或值可能不正確。

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

快速設定適用於目前未接收流量的新網域，或您嘗試從其他Hosting網站轉移的網域。如果網域已在其他代管服務供應商接收要求，且您需要零停機時間遷移，可以使用「進階設定」。

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

等待系統佈建 SSL 憑證

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

您的網域會列為 Firebase 應用程式 SSL 憑證中的主體別名 (SAN)。您可以使用瀏覽器的安全工具查看這項憑證。網域佈建期間，您可能會看到無效憑證，其中不包含您的網域名稱。這是正常程序，網域憑證核發後就會解決。

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

您的自訂網域金鑰

新增或編輯 DNS 記錄時，不同網域供應商會要求你在 DNS 管理網站的「主機」欄位中輸入不同內容。下方列出熱門供應商的常見輸入內容。 如需詳細操作說明，請參閱網域供應商的說明文件。

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

常見的輸入內容包括：

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

常見的輸入內容包括：

  • 完整子網域名稱 (例如 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 憑證核發限制。
建立憑證

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

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