連結自訂網域

使用 Firebase Hosting 時,您不必放棄以品牌為中心的專屬網域名稱。您可以為 Firebase 託管網站使用自訂網域 (例如 example.comapp.example.com),而非 Firebase 產生的網域。

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

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

Hosting 設定網域

請務必完成專案「開始使用」精靈的步驟,Firebase Hosting頁面 在 Firebase 專案中建立 Firebase Hosting 網站。

步驟 1:新增自訂網域

  1. 前往專案的 Hosting頁面, 然後啟動自訂網域連線精靈:

    • 如果只有一個 Hosting 網站,請按一下「新增自訂網域」
    • 如果您有多個 Hosting 網站,請按一下所需網站的「查看」,然後按一下「新增自訂網域」
  2. 輸入要連結至Hosting網站的自訂網域名稱。

  3. (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (這樣 example.comwww.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 憑證。
您可以提供網站內容。