您不必為透過 Firebase App Hosting 部署的應用程式,提供以品牌為中心的專屬網域名稱。您可以使用自訂網域 (例如 example.com
或 app.example.com
),而不使用 Firebase 為託管網站產生的網域。Firebase App Hosting 會為每個網域佈建 SSL 憑證
本文件的其餘部分將逐步引導您完成連結自訂網域的步驟。
設定網域以使用 App Hosting
請確認您已完成基本的 App Hosting 設定工作,您的 Firebase 專案中有 Firebase App Hosting 網站。
步驟 1:新增自訂網域
- 開啟專案的 App Hosting 頁面。
- 使用「View Dashboard」選項選取 App Hosting 後端。
- 選取「設定」分頁標籤,然後按一下「新增自訂網域」。
- 輸入要連結至 App Hosting 網站的自訂網域名稱。
- (選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如
example.com
和www.example.com
重新導向至相同的內容)。 - 按一下 [Continue] (繼續),設定 DNS 記錄並完成自訂網域的設定。
步驟 2:設定自訂網域
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 網域 |
常見的輸入內容包括:
|
子網域 | 常見的輸入內容包括:
|
常見網域供應商
以下列出一些常見的網域供應商,以及各家網域可能需要的輸入內容類型。系統會盡可能更新這項資訊,但如需詳細的操作說明,請參閱網域供應商的說明文件。
自訂網域的狀態說明
狀態 | 說明 |
---|---|
需要設定 |
您可能需要使用 DNS 記錄變更設定。
|
待處理 | 您已正確設定自訂網域,但 Firebase App Hosting 尚未佈建 SSL 憑證。 有時候,過度限制的 CAA 記錄可能會阻礙自訂網域的 SSL 憑證擷取作業。確認憑證授權單位「letsEncrypt.org」和「pki.goog」有權建立您網域的 SSL 憑證。 |
挖掘證書 | 系統正在為您的網域產生 SSL 憑證。 |
已連結 | 自訂網域具備適當的 DNS 記錄,並具備 SSL 憑證。 |