您不必為了在 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 記錄的原因有兩個:
|
是 |
| TXT | 這類記錄可讓您將任意中繼資料附加至網域。App Hosting 允許您使用特定格式的 TXT 記錄 fah-claim=[UUID],指出應在網域上提供哪個自訂網域。 |
否 |
| CAA | 這些記錄可做為許可清單,指定有權為網域建立 SSL 憑證的憑證授權單位。只有在無法為網域建立憑證時,App Hosting 才會要求 CAA 記錄。 | 否 |
事前準備:自訂網域名稱
新增或編輯 DNS 記錄時,不同的網域供應商會要求您在 DNS 管理網站的「主機」(或「主機名稱」) 欄位中輸入不同的內容。App Hosting 自訂網域精靈會要求您在「Name」(名稱) 欄位中輸入相同的值。
我們在下方彙整了熱門供應商的常見輸入內容。如需詳細操作說明,請參閱網域供應商的說明文件。
| 網域類型 | 自訂網域名稱 |
|---|---|
| Apex 網域 |
常見的輸入內容包括:
|
| 子網域 | 常見的輸入內容包括:
|
常見的網域供應商
以下列出一些常見的網域供應商,以及各家可能要求的輸入類型。 我們會盡可能確保這項資訊符合最新情況,但仍請參閱網域供應商的說明文件,瞭解詳細操作說明。
遷移網域
如要將網域從其他供應商轉移至 App Hosting,且不希望發生任何停機時間,可以使用 Firebase 控制台中的「Migrate a domain」(遷移網域) 流程。這個流程會引導您完成兩步驟程序,先讓 App Hosting 準備好在您的網域上提供內容,再將流量導向 App Hosting 伺服器。
步驟 1:新增自訂網域
- 在 Firebase 控制台中,依序前往「Hosting & Serverless」> 「App Hosting」。
- 使用「View Dashboard」(查看資訊主頁) 選項,選取 App Hosting 後端。
- 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
- 輸入要連結至 App Hosting 網站的自訂網域名稱。
- (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如
example.com和www.example.com重新導向至相同內容)。 - 按一下「Continue to setup」(繼續設定),設定 DNS 記錄並完成自訂網域設定。
步驟 2:準備網域
- 在「設定網域」精靈中,選取「遷移網域」分頁標籤。
- 請按照第一個步驟「準備網域」中的指示操作,其中包含 App Hosting 為您偏好的後端提供服務,以及為網域建立安全 TLS 連線所需的變更。在 DNS 供應商中新增、移除及儲存網域記錄,並為必要記錄輸入下列資訊:
- 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
- 記錄類型:新增提供的 DNS 記錄。
- 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
- 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。
步驟 3:導向 App Hosting
- App Hosting 驗證上一步的記錄更新後,
精靈會進入最後的 「Direct to App Hosting」(直接前往 )步驟。這個步驟會顯示您必須進行的記錄更新,以便將網域流量導向 App Hosting 伺服器。和之前一樣,在 DNS 供應商中新增、移除及儲存網域記錄,並為必要記錄輸入下列內容:
- 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
- 記錄類型:新增提供的 DNS 記錄。
- 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
- 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。
連結新網域
如果不介意停機,例如連結網頁應用程式的新網域,請按照本節的說明操作。
步驟 1:新增自訂網域
- 在 Firebase 控制台中,依序前往「Hosting & Serverless」> 「App Hosting」。
- 使用「View Dashboard」(查看資訊主頁) 選項,選取 App Hosting 後端。
- 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
- 輸入要連結至 App Hosting 網站的自訂網域名稱。
- (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如
example.com和www.example.com重新導向至相同內容)。 - 按一下「Continue to setup」(繼續設定),設定 DNS 記錄並完成自訂網域設定。
步驟 2:驗證 DNS 記錄
- Firebase 控制台的「Set up domain」精靈會顯示需要更新的記錄,以便將頁面指向 Firebase App Hosting。在 DNS 供應商中,使用下列輸入內容新增、移除及儲存網域記錄:
- 名稱:輸入記錄的自訂網域名稱。您指定的主機是您要提供內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」
- 記錄類型:新增提供的 DNS 記錄。
- 價值:將指定價值套用至記錄。網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,例如 TXT 記錄是字串。
- 選取「驗證記錄」。App Hosting會嘗試偵測你在網域供應商網站所做的變更。變更最多可能需要 24 小時才會生效。您可以在後端資訊主頁的「設定」>「網域」檢視畫面中查看狀態。
等待 SSL 憑證佈建
更新 DNS 記錄後,App Hosting 最多可能需要幾小時,才能為網域佈建 SSL 憑證。在某些情況下,將 DNS 指向 Firebase App Hosting 後,最多可能需要 24 小時。
您可以使用瀏覽器的安全性工具查看這項憑證。在佈建網域期間,您可能會看到無效的憑證,或無法連線至網域。這是正常現象,網域憑證可用後就會解決。
注意:Firebase App Hosting 會視需要自動為自訂網域重新佈建 SSL 憑證。
自訂網域的狀態說明
| 狀態 | 說明 |
|---|---|
| 需要設定 |
您可能需要變更 DNS 記錄設定。
|
| 待處理 | 您已正確設定自訂網域,但 Firebase App Hosting 尚未佈建 SSL 憑證。 有時,過於嚴格的 CAA 記錄可能會導致自訂網域的 SSL 憑證無法產生。確認憑證授權單位「letsencrypt.org」和「pki.goog」可以為您的網域建立 SSL 憑證。 |
| 建立憑證 | 系統正在為你的網域產生 SSL 憑證。 |
| 已連結 | 自訂網域具備適當的 DNS 記錄和 SSL 憑證。 |