連結自訂網域

您不必為透過 Firebase App Hosting 部署的應用程式,提供以品牌為中心的專屬網域名稱。您可以使用自訂網域 (例如 example.comapp.example.com),而不使用 Firebase 為託管網站產生的網域。Firebase App Hosting 會為每個網域佈建 SSL 憑證

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

設定網域以使用 App Hosting

請確認您已完成基本的 App Hosting 設定工作,您的 Firebase 專案中有 Firebase App Hosting 網站。

步驟 1:新增自訂網域

  1. 開啟專案的 App Hosting 頁面
  2. 使用「View Dashboard」選項選取 App Hosting 後端。
  3. 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
  4. 輸入要連結至 App Hosting 網站的自訂網域名稱。
  5. (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如 example.comwww.example.com 重新導向至相同的內容)。
  6. 按一下 [Continue] (繼續),設定 DNS 記錄並完成自訂網域的設定。

步驟 2:設定自訂網域

  1. Firebase 控制台的「Add Custom Domain」(新增自訂網域) 精靈會顯示需要更新頁面,將頁面指向 Firebase 應用程式託管所需的記錄。使用下列輸入內容,從 DNS 供應商網域新增、移除及儲存您網域的記錄:

    • 類型:新增提供的 DNS 記錄。
    • Host (主機):輸入記錄的自訂網域金鑰。您指定的主機是您要提供內容的網域;這個網域可以是 Apex 網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」。

    • :將提供的值指派給記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異:A 和 AAAA 記錄的 IP 位址為字串,而 TXT 記錄則為字串。

等待一段時間,讓系統佈建 SSL 憑證。將 DNS 指向 Firebase App Hosting 後,系統最多可能需要數小時才能完成此操作。在大多數情況下,視您的網域供應商而定,您的記錄和佈建 SSL 憑證的傳播會在一小時內生效。

等待 SSL 憑證佈建作業

更新 DNS 記錄後,App Hosting 可能需要數小時才能佈建網域的 SSL 憑證。

您可以使用瀏覽器的安全性工具查看這個憑證。在網域佈建期間,您可能會看到無效的憑證,或是在連線至網域時發生問題。此為正常流程,會在網域憑證可用後解決。

注意:Firebase App Hosting 會視需要自動重新佈建自訂網域的 SSL 憑證。

您的自訂網域金鑰

新增或編輯 DNS 記錄時,不同的網域供應商會預期您在其 DNS 管理網站的「Host」欄位中輸入不同的輸入內容。歡迎參考以下熱門供應商的常用資料。如需詳細操作說明,請參閱網域供應商的說明文件。

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

常見的輸入內容包括:

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

常見的輸入內容包括:

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

常見網域供應商

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

自訂網域的狀態說明

狀態 說明
需要設定

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

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

  • 在極少數情況下,SSL 驗證可能會失敗,因為您的 DNS 記錄包含指向其他代管服務供應商的 A 記錄或 CNAME 記錄。
    疑難排解提示:檢查您的 A 記錄是否只指向 Firebase App Hosting,並移除所有 CNAME 記錄。

待處理

您已正確設定自訂網域,但 Firebase App Hosting 尚未佈建 SSL 憑證。

有時候,過度限制的 CAA 記錄可能會阻礙自訂網域的 SSL 憑證擷取作業。確認憑證授權單位「letsEncrypt.org」和「pki.goog」有權建立您網域的 SSL 憑證。

挖掘證書

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

已連結

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