您不必放棄在 Firebase App Hosting 上部署的應用程式專屬品牌網域名稱。您可以使用自訂網域 (例如 example.com
或 app.example.com
),而非 Firebase 產生的網域,為 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
重新導向至相同內容)。 - 按一下「繼續」,即可設定 DNS 記錄並完成自訂網域的設定。
步驟 2:設定自訂網域
Firebase 主控台的「Add Custom Domain」精靈會顯示需要更新的必要記錄,以便將網頁指向 Firebase App Hosting。使用下列輸入內容,在 DNS 供應商中新增、移除及儲存網域記錄:
- 類型:新增提供的 DNS 記錄。
Host:輸入記錄的自訂網域金鑰。您指定的主機是您要放送內容的網域,這個網域可以是頂層網域或子網域。網域供應商可能會將這個詞彙列為「主機名稱」、「名稱」或「網域」。
Value:將提供的值指派給記錄。網域供應商可能會將這項條件列為「資料」、「指向」、「內容」、「位址」或「IP 位址」。值欄位的內容會因記錄類型而異,A 和 AAAA 記錄的值為 IP 位址,而 TXT 記錄的值則為字串。
請留出時間讓SSL 憑證完成佈建。這項程序通常會在幾小時內完成,但有時可能需要 24 小時才會生效,具體取決於您將 DNS 指向 Firebase App Hosting 的時間。在大多數情況下,記錄會在 1 小時內傳播,SSL 憑證也會在這個時間內佈建完成,具體情況視網域供應商而定。
等待 SSL 憑證佈建
App Hosting 會在您更新 DNS 記錄後,最多需要幾小時才能為網域佈建 SSL 憑證。在某些情況下,您將 DNS 指向 Firebase App Hosting 後,可能需要最多 24 小時才能生效。
您可以使用瀏覽器的安全性工具查看這項憑證。在網域佈建期間,您可能會看到無效的憑證,或無法連線至網域。這是正常的程序,網域憑證可用後就會解決。
注意: Firebase App Hosting 會視需要自動為自訂網域重新提供 SSL 憑證。
DNS 記錄類型
App Hosting 自訂網域精靈可能會要求您新增 1 至 5 個 DNS 記錄,具體取決於網域的目前設定。記錄的類型會決定其功能。以下是 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 管理網站中,針對「Host」欄位輸入不同的內容。以下列出常見的輸入內容,供您參考。如需詳細操作說明,請參閱您的網域供應商說明文件。
網域類型 | 自訂網域鍵 |
---|---|
Apex 網域 |
常見的輸入內容包括:
|
子網域 | 常見的輸入內容包括:
|
常見的網域供應商
以下列出一些常見的網域提供者,以及各自可能需要的輸入類型。我們會盡可能保持這項資訊的最新狀態,但請參閱網域供應商的說明文件,瞭解詳細操作說明。
自訂網域的狀態說明
狀態 | 說明 |
---|---|
需要設定 |
您可能需要變更 DNS 記錄的設定。
|
待處理 | 您已正確設定自訂網域,但 Firebase App Hosting 尚未佈建 SSL 憑證。 有時,過度限制的 CAA 記錄可能會導致自訂網域的安全資料傳輸層 (SSL) 憑證無法正常產生。請確認憑證授權單位 `letsencrypt.org` 和 `pki.goog` 可以為您的網域建立 SSL 憑證。 |
憑證建立 | 系統正在為您的網域產生安全資料傳輸層 (SSL) 憑證。 |
已連結 | 您的自訂網域具備正確的 DNS 記錄,且有 SSL 憑證。 |