連接自定義域

您不必使用 Firebase 託管放棄以品牌為中心的獨特域名。您可以為您的 Firebase 託管網站使用自定義域（例如example.com或app.example.com ）而不是 Firebase 生成的域。

Firebase 託管為您的每個域提供 SSL 證書，並通過全球 CDN 提供您的內容。

本文檔的其餘部分將引導您完成這些步驟以連接您的自定義域。

設置您的主機域

確保您已從項目的Firebase 託管頁面完成“開始使用”嚮導，以便在您的 Firebase 項目中擁有一個 Firebase 託管站點。

第 1 步：添加域

1. 在項目的Hosting page中，輸入連接自定義域的嚮導：

   • 如果您只有一個託管站點，請單擊連接域。
   • 如果您有多個託管站點，請單擊所需站點的查看，然後單擊連接域。

2. 輸入您要連接到您的託管站點的自定義域名。

3. （可選）選中該框以將自定義域上的所有請求重定向到第二個指定域（例如example.com和www.example.com重定向到相同的內容）。

4. 單擊繼續以啟動驗證過程。

第 2 步：驗證域所有權

如果在連接域設置嚮導中請求，請驗證您的頂級域。

這些步驟可確保您的域尚未與 Firebase 項目相關聯，並且您擁有指定的域。

1. 在您的域提供商的站點中，找到 DNS 管理頁面。

2. 使用以下輸入添加並保存新記錄：

   • 類型：添加 TXT 記錄。

     Firebase 託管要求您始終在 DNS 設置中保留此 TXT 記錄，以證明您對域的所有權並授權 Firebase 為您的站點分配和續訂 SSL 證書。

     您的域提供商可能將此術語列為“記錄類型”。

   • 主持人：輸入您的頂級域密鑰。

     證明您對頂級域或根域的所有權證明了您對其所有子域的所有權。

     您的域提供商可能將此術語列為“主機名”、“名稱”或“域”。

   • 值：將唯一驗證值複製到字段中。

     Firebase 託管會檢查此值以證明您的域所有權。

     您的域提供商可能將此術語列為“數據”。

3. 最多允許 24 小時傳播更新的 TXT 記錄，然後單擊驗證。

   請注意，您可以單擊“取消”以安全地關閉“連接域”窗口並在稍後重新打開。這不會影響傳播時間，但是當您重新打開窗口時，系統會提示您重新輸入您的域名。

   在足夠的傳播時間後，單擊 Firebase 控制台的連接域窗口中的驗證允許您開始 SSL 證書配置過程。

   在大多數情況下，您的記錄的傳播和您的域的驗證將在幾個小時內完成，具體取決於您的域提供商。有關添加 TXT 記錄和傳播時間的詳細說明，請參閱您的域提供商的文檔。

   如果單擊驗證提示錯誤消息，則您的記錄尚未傳播或您的值可能不正確。

第 3 步：上線

在 Firebase 控制台的“連接域”窗口中，為新站點選擇“快速設置”或“高級設置”（如果您已經有一個在其他託管服務提供商上運行的站點並且需要零停機遷移）。

等待 SSL 證書配置

驗證域所有權後，我們會為您的域配置 SSL 證書，並在您將 DNS A 記錄指向 Firebase 託管後的 24 小時內將其部署到我們的全球 CDN 中。

您的域將在 FirebaseApp SSL 證書中列為主題備用名稱 (SAN) 之一。您可以使用瀏覽器的安全工具查看此證書。在配置域時，您可能會看到不包含您的域名的無效證書。這是該過程的正常部分，將在您的域證書可用後解決。

對於高級設置用戶，您的網站將由您之前的託管服務提供商託管，直到您項目的Firebase 託管頁面中的設置狀態更新為Connected 。

您的自定義域密鑰

添加或編輯 DNS 記錄時，不同的域提供商希望您在其 DNS 管理站點中為主機字段輸入不同的輸入。我們匯總了以下流行提供商的常見輸入。有關詳細說明，請參閱您的域提供商的文檔。

常見的域名提供商

以下是一些常見的域提供程序以及每個可能需要的輸入類型。此信息會盡可能保持最新，但請參閱您的域提供商的文檔以獲取詳細說明。

自定義域的設置狀態描述