連結自訂網域

您不必為了在 Firebase App Hosting 上部署應用程式,而放棄獨特、以品牌為中心的網域名稱。您可以使用自訂網域 (例如 example.com 或 app.example.com),而非 Firebase 產生的網域,做為 Firebase 託管網站的網域。Firebase App Hosting 會為您的每個網域佈建 SSL 憑證。

本文其餘部分將逐步說明如何透過下列其中一種方式連結自訂網域:

為確保服務不中斷,請按照特定順序更新 DNS 記錄。請按照遷移網域的操作說明進行,以免應用程式發生停機。

如果不介意停機,例如要將新網域連結至網頁應用程式,請按照連結新網域的操作說明進行。

事前準備:DNS 記錄類型

App Hosting「設定網域」精靈可能會要求您新增或移除 1 到 5 筆 DNS 記錄,具體取決於網域目前的設定。記錄的「Type」會決定其功能。App Hosting 可能會要求提供下列類型的記錄:

類型 說明 獨家
A 這些記錄包含 IPv4 值 (例如 8.8.8.8),可讓瀏覽器知道嘗試與網域聯絡時應使用的位址。 是
AAAA 這些記錄包含 IPv6 值 (例如 2001:4860:4860::8888),這是一種不同類型的位址記錄,功能與 A 記錄大致相同。App Hosting 目前不使用 AAAA 記錄,但如果網域中有任何現有記錄,系統會要求你移除。 是
CNAME 這些記錄包含獨立的網域名稱,應使用該名稱 (而非目前的網域) 解析 DNS 查詢。CNAME 記錄只能用於子網域 (例如 www.example.com)。App Hosting 使用 CNAME 記錄的原因有兩個:
  • 輕鬆上手:App Hosting 會盡可能要求您將 CNAME 設為以 _custom-domain... 開頭的預先設定網域。
  • SSL 憑證驗證:App Hosting 會使用 Cloud Certificate Manager 為自訂網域佈建 SSL 憑證。Certificate Manager 可透過 _acme-challenge... 子網域的 CNAME 記錄,為您建立及更新憑證。完成新手上路程序後,請勿移除這筆記錄,否則憑證涵蓋範圍會失效。
是
TXT 這類記錄可讓您將任意中繼資料附加至網域。App Hosting 允許您使用特定格式的 TXT 記錄 fah-claim=[UUID],指出應在網域上提供哪個自訂網域。 否
CAA 這些記錄可做為許可清單,指定有權為網域建立 SSL 憑證的憑證授權單位。只有在無法為網域建立憑證時,App Hosting 才會要求 CAA 記錄。 否

事前準備:自訂網域名稱

新增或編輯 DNS 記錄時,不同的網域供應商會要求您在 DNS 管理網站的「主機」(或「主機名稱」) 欄位中輸入不同的內容。App Hosting 自訂網域精靈會要求您在「Name」(名稱) 欄位中輸入相同的值。

我們在下方彙整了熱門供應商的常見輸入內容。如需詳細操作說明,請參閱網域供應商的說明文件。

網域類型 自訂網域名稱
Apex 網域

常見的輸入內容包括:

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

常見的輸入內容包括:

  • 完整的子網域名稱 (例如 app.example.com)
  • 僅限子網域部分 (例如僅限 app,不含 .example.com)

常見的網域供應商

以下列出一些常見的網域供應商,以及各家可能要求的輸入類型。 我們會盡可能確保這項資訊符合最新情況,但仍請參閱網域供應商的說明文件,瞭解詳細操作說明。

遷移網域

如要將網域從其他供應商轉移至 App Hosting,且不希望發生任何停機時間,可以使用 Firebase 控制台中的「Migrate a domain」(遷移網域) 流程。這個流程會引導您完成兩步驟程序,先讓 App Hosting 準備好在您的網域上提供內容,再將流量導向 App Hosting 伺服器。

步驟 1:新增自訂網域

  1. 在 Firebase 控制台中,依序前往「Hosting & Serverless」> 「App Hosting」。
  2. 使用「View Dashboard」(查看資訊主頁) 選項,選取 App Hosting 後端。
  3. 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
  4. 輸入要連結至 App Hosting 網站的自訂網域名稱。
  5. (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如 example.com 和 www.example.com 重新導向至相同內容)。
  6. 按一下「Continue to setup」(繼續設定),設定 DNS 記錄並完成自訂網域設定。

步驟 2:準備網域

  1. 在「設定網域」精靈中,選取「遷移網域」分頁標籤。
  2. 請按照第一個步驟「準備網域」中的指示操作,其中包含 App Hosting 為您偏好的後端提供服務,以及為網域建立安全 TLS 連線所需的變更。在 DNS 供應商中新增、移除及儲存網域記錄,並為必要記錄輸入下列資訊:
    • 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
    • 記錄類型:新增提供的 DNS 記錄。
    • 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
  3. 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。

步驟 3:導向 App Hosting

  1. App Hosting 驗證上一步的記錄更新後, 精靈會進入最後的 「Direct to App Hosting」(直接前往 )步驟。這個步驟會顯示您必須進行的記錄更新,以便將網域流量導向 App Hosting 伺服器。和之前一樣,在 DNS 供應商中新增、移除及儲存網域記錄,並為必要記錄輸入下列內容:
    • 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
    • 記錄類型:新增提供的 DNS 記錄。
    • 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
  2. 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。

連結新網域

如果不介意停機,例如連結網頁應用程式的新網域,請按照本節的說明操作。

步驟 1:新增自訂網域

  1. 在 Firebase 控制台中,依序前往「Hosting & Serverless」> 「App Hosting」。
  2. 使用「View Dashboard」(查看資訊主頁) 選項,選取 App Hosting 後端。
  3. 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
  4. 輸入要連結至 App Hosting 網站的自訂網域名稱。
  5. (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如 example.com 和 www.example.com 重新導向至相同內容)。
  6. 按一下「Continue to setup」(繼續設定),設定 DNS 記錄並完成自訂網域設定。

步驟 2:驗證 DNS 記錄

  1. Firebase 控制台的「Set up domain」精靈會顯示需要更新的記錄,以便將頁面指向 Firebase App Hosting。在 DNS 供應商中,使用下列輸入內容新增、移除及儲存網域記錄:
    • 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
    • 記錄類型:新增提供的 DNS 記錄。
    • 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
  2. 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。

等待 SSL 憑證佈建

更新 DNS 記錄後,App Hosting 最多可能需要幾小時,才能為網域佈建 SSL 憑證。在某些情況下,將 DNS 指向 Firebase App Hosting 後,最多可能需要 24 小時。

您可以使用瀏覽器的安全性工具查看這項憑證。在佈建網域期間,您可能會看到無效的憑證,或無法連線至網域。這是正常現象,網域憑證可用後就會解決。

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

自訂網域的狀態說明

狀態 說明
需要設定

您可能需要變更 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 憑證。
您可以提供網站內容。