您不需要透過 Firebase 託管提供以品牌為主的獨特網域名稱。您可以使用自訂網域 (例如 example.com
或 app.example.com
),而非 Firebase 為託管網站產生的網域。
Firebase 託管會為每個網域佈建 SSL 憑證,並透過全球 CDN 提供內容。
本文件的其餘部分將逐步引導您完成連結自訂網域的步驟。
設定要用於託管的網域
確認您已完成專案 Firebase 託管頁面中的「Get Started」精靈,因此您的 Firebase 專案中有 Firebase 託管網站。
步驟 1:新增自訂網域
在專案的「Hosting」(託管) 頁面中,輸入連接自訂網域的精靈:
- 如果只有一個 Hosting 網站,請按一下「新增自訂網域」。
- 如果您擁有多個託管網站,請針對所需網站按一下「View」(檢視),然後按一下「Add custom domain」(新增自訂網域)。
輸入要連結至託管網站的自訂網域名稱。
(選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (例如
example.com
和www.example.com
會重新導向至相同的內容)。按一下「Continue」(繼續) 即可設定 DNS 記錄,並完成自訂網域的設定程序。
步驟 2:設定自訂網域
如果已在「Connect Domain」設定精靈中要求,請驗證您的 Apex 網域。
這些步驟可確保您的網域尚未與 Firebase 專案建立連結,且您擁有指定網域。
在網域供應商的網站上找出 DNS 管理頁面。
使用下列輸入內容,新增並儲存新記錄:
類型:新增 TXT 記錄。
Firebase 代管會要求您持續在 DNS 設定中保留此 TXT 記錄,以證明您的網域擁有權,並授權 Firebase 為您的網站指派及更新安全資料傳輸層 (SSL) 憑證。
網域供應商可能會將這個字詞列為「記錄類型」。
Host (主機):輸入您的 Apex 網域金鑰。
證明您對 Apex 網域 (或根網域) 的擁有權,可證明您擁有其所有子網域的擁有權。
網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」。
Value (值):將專屬驗證值複製到欄位中。
Firebase 託管會檢查這個值,證明您的網域擁有權。
網域供應商可能會將這個字詞列為「資料」。
更新後的 TXT 記錄最多需要 24 小時才會生效,接著點選「Verify」(驗證)。
請注意,您可以按一下「Cancel」,安全關閉「Connect Domain」視窗,並稍後再重新開啟。這不會影響傳播時間,但當您重新開啟視窗時,系統會提示您重新輸入網域名稱。
大量傳播後,在 Firebase 控制台的「Connect Domain」(連結網域) 視窗中按一下「Verify」(驗證),即可開始 SSL 憑證佈建程序。
多數情況下,網域記錄和驗證的傳播作業會在幾小時內完成,具體取決於您的網域供應商。如需新增 TXT 記錄和傳播時間的詳細操作說明,請參閱網域供應商的說明文件。
如果按一下「Verify」(驗證) 提示訊息,表示系統尚未傳播記錄,或者值可能不正確。
在 Firebase 控制台的「Add Custom Domain」精靈中,選取「Quick Setup」或「Advanced Setup」。
快速設定適用於目前不會接收流量的新網域,或是您嘗試從其他託管網站轉移的網域。如果您的網域已透過其他主機供應商接收要求,且需要進行零停機時間遷移,則可使用進階設定。
「Advanced Setup」精靈將協助您建立 SSL 憑證和擁有權聲明,允許託管在接收流量之前於網域提供流量。
等待 SSL 憑證佈建作業
驗證網域擁有權後,我們會為您的網域佈建 SSL 憑證,並在您將 DNS A 記錄指向 Firebase 託管後的 24 小時內,部署至全球 CDN。
您的網域會在 FirebaseApp SSL 憑證中列為「主體別名」(SAN)。您可以使用瀏覽器的安全性工具查看這個憑證。當網域佈建時,您可能會看到不含網域名稱的無效憑證。此為正常流程,會在網域憑證可用後解決。
如為進階設定使用者,在專案的 Firebase 託管頁面中「已連結」的設定狀態中,網站會先由先前的代管服務供應商託管。
您的自訂網域金鑰
新增或編輯 DNS 記錄時,不同的網域供應商會預期您在其 DNS 管理網站的「Host」欄位中輸入不同的輸入內容。下方彙整了熱門供應商的常見輸入內容。 如需詳細操作說明,請參閱網域供應商的說明文件。
網域類型 | 自訂網域金鑰 |
---|---|
Apex 網域 |
常見的輸入內容包括:
|
子網域 | 常見的輸入內容包括:
|
常見網域供應商
以下列出一些常見的網域供應商,以及各家網域可能需要的輸入內容類型。系統會盡可能更新這項資訊,但如需詳細的操作說明,請參閱網域供應商的說明文件。
自訂網域的設定狀態說明
狀態 | 說明 |
---|---|
需要設定 |
您可能需要使用 DNS 記錄變更設定。
|
待處理 | 您已正確設定自訂網域,但 Firebase 託管尚未佈建 SSL 憑證。 有時候,以下問題可能會阻礙自訂網域的 SSL 憑證擷取作業:
|
挖掘證書 | 系統正在為您的網域產生 SSL 憑證。 |
已連結 | 自訂網域具備適當的 DNS 記錄,並具備 SSL 憑證。 |