連結自訂網域
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用 Firebase Hosting 時,您不必放棄以品牌為中心的專屬網域名稱。您可以為 Firebase 託管網站使用自訂網域 (例如 example.com
或 app.example.com
),而非 Firebase 產生的網域。
Firebase Hosting 會為每個網域佈建 SSL 憑證,並透過全球 CDN 提供內容。
這份文件的後續內容會逐步說明如何連結自訂網域。
連結自訂網域時,請注意下列事項:
每個自訂網域只能連結至一個 Hosting 網站。
由於 SSL 憑證鑄造限制,每個自訂網域的頂層網域最多只能有 20 個子網域。
為 Hosting 設定網域
請務必完成專案「開始使用」精靈的步驟,Firebase Hosting 頁面
在 Firebase 專案中建立 Firebase Hosting 網站。
步驟 1 :新增自訂網域
前往專案的
Hosting 頁面 ,
然後啟動自訂網域連線精靈:
如果只有一個 Hosting 網站,請按一下「新增自訂網域」 。
如果您有多個 Hosting 網站 ,請按一下所需網站的「查看」 ,然後按一下「新增自訂網域」 。
輸入要連結至Hosting 網站的自訂網域名稱。
(選用) 勾選方塊,將自訂網域上的所有要求重新導向至第二個指定網域 (這樣 example.com
和 www.example.com
會重新導向至相同內容)。
按一下「繼續」 ,設定 DNS 記錄並完成自訂網域設定。
步驟 2 :設定自訂網域
如果「連結網域」 設定精靈要求您驗證頂層網域,請按照指示操作。
這些步驟可確保網域尚未連結至 Firebase 專案,且您擁有指定的網域。
在網域供應商的網站上,找出 DNS 管理頁面。
新增並儲存一筆記錄,輸入下列資訊:
類型 :新增 TXT 記錄。
Firebase Hosting 需要您持續在 DNS 設定中保留這項 TXT 記錄,以證明您擁有網域,並授權 Firebase 為您的網站指派及續約 SSL 憑證。
網域供應商可能會將這個字詞列為「記錄類型」。
主機 :輸入頂層網域金鑰 。
證明您是頂層網域或根網域的擁有者,即表示您是所有子網域的擁有者。
網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」。
值 :將專屬驗證值複製到這個欄位。
Firebase Hosting 會檢查這個值,證明您擁有網域。
網域供應商可能會將這個字詞列為「資料」。
更新的 TXT 記錄最多可能需要 24 小時才會生效,請稍待片刻,然後按一下「驗證」 。
請注意,您可以點選「取消」 ,安全地關閉「連結網域」 視窗,稍後再重新開啟。這不會影響傳播時間,但重新開啟視窗時,系統會提示您重新輸入網域名稱 。
經過充足的傳播時間後,在 Firebase 控制台的「Connect Domain」(連結網域) 視窗中按一下「Verify」(驗證) ,即可開始佈建 SSL 憑證。
一般來說,記錄傳播和網域驗證程序會在幾小時內完成,實際時間視網域供應商而定。如需新增 TXT 記錄和傳播時間的詳細操作說明,請參閱網域供應商的說明文件。
如果點選「驗證」 時出現錯誤訊息,表示記錄尚未傳播,或值可能不正確。
注意: 您隨時可以使用 Google Admin Toolbox Dig 服務 ,檢查 DNS 記錄是否已正確更新。
請注意,即使記錄已更新,SSL 憑證的傳播或佈建仍可能需要更多時間。
在 Firebase 控制台的「新增自訂網域」 精靈中,選取「快速設定」 或「進階設定」 。
快速設定 適用於目前未接收流量的新網域,或您嘗試從其他Hosting 網站轉移的網域。如果網域已在其他代管服務供應商接收要求,且您需要零停機時間遷移,可以使用「進階設定」 。
進階設定 精靈會協助您建立 SSL 憑證和擁有權聲明,讓 Hosting 在收到流量前,就能在網域上提供流量。
快速設定
Firebase 控制台的「新增自訂網域」 精靈會顯示必要記錄,您需要更新這些記錄,才能將頁面指向 Firebase Hosting 。在 DNS 供應商中,使用下列輸入內容新增、移除及儲存網域記錄:
類型 :新增提供的 DNS 記錄。
主機 :輸入記錄的自訂網域金鑰 。
您指定的主機是您要放送內容的網域,可以是頂層網域或子網域。
網域供應商可能會將這個字詞列為「主機名稱」、「名稱」或「網域」。
值 :將提供的 IP 位址指派給記錄的值。
網域供應商可能會將這個字詞列為「資料」、「指向」、「內容」、「地址」或「IP 位址」。
請等待系統佈建 SSL 憑證 。
將 DNS 指向 Firebase Hosting 後,最多可能需要 24 小時才會生效。一般來說,記錄傳播和 SSL 憑證佈建會在幾小時內完成,實際時間取決於網域供應商。
請務必移除指向其他供應商的 A 記錄或 CNAME 記錄。並移除所有 AAAA 記錄。如果存在任何這類記錄,Firebase 就無法佈建 SSL 憑證。
進階設定
在「新增自訂網域」 精靈的「進階」 設定模式中,您可以設定 Hosting ,在將流量導向網域伺服器之前,安全地提供網域服務。一般來說,Hosting 需要三項條件,才能在網域上順利放送流量:
擁有權記錄:TXT 記錄會告知 Hosting 要在網域上放送哪個網站
SSL 憑證:網域專屬憑證,可讓 Hosting 伺服器與使用者之間進行加密通訊
主機 IP 記錄:一或多個 A 和 AAAA 記錄,將網域的所有要求導向 Hosting 伺服器
進階 設定會引導您設定網域,讓 Hosting 預先處理前兩項規定,確保網域開始接收流量前,已準備好提供正確內容。
這個精靈會將這項程序呈現為兩步驟工作流程:
準備網域
更新 DNS 記錄 :在網域中新增一或多筆記錄:
擁有權:TXT 記錄,格式為 `hosting-site=[site_id]`。
CAA (選用):一組 CAA 記錄,允許 Hosting 的憑證授權單位 為您的網域核發 SSL 憑證。只有在 Hosting 發現現有 CAA 記錄會阻擋佈建憑證時,才會顯示這項資訊。
設定 SSL 憑證 :精靈會提供 ACME 驗證 ,Hosting 的憑證授權單位會使用這項驗證,為您的網域核發 SSL 憑證。您可以選擇 DNS 或 HTTP 驗證:
DNS 驗證 :前往網域供應商的 DNS 管理網站。新增 TXT 記錄,並使用 ACME 驗證子網域金鑰和系統提供的值。TXT 記錄最多需要 24 小時才會生效。
HTTP 挑戰 :
將提供的文字檔上傳至現有網站的
指定網址,並確認該檔案存在。
Hosting 會先嘗試自行驗證 ACME 挑戰,再向 CA 申請驗證。如果 CA 無法驗證您的驗證問題 (例如服務間歇性發生問題),Hosting 必須為你產生一組新的挑戰。驗證成功後,Hosting 最多可能需要幾小時才能佈建 SSL 憑證,並允許憑證傳播。
直接前往 Hosting
Hosting 驗證網域擁有權並佈建 SSL 憑證後,請返回 DNS 供應商網站,新增 DNS A/AAAA 記錄,將要求導向 Hosting :
等待系統佈建 SSL 憑證
驗證網域擁有權後,我們會為您的網域佈建安全資料傳輸層 (SSL) 憑證,並在您將 DNS A 記錄指向 Firebase Hosting 後 24 小時內,將憑證部署到全球 CDN。
您的網域會列為 Firebase 應用程式 SSL 憑證中的主體別名 (SAN)。您可以使用瀏覽器的安全工具查看這項憑證。網域佈建期間,您可能會看到無效憑證,其中不包含您的網域名稱。這是正常程序,網域憑證核發後就會解決。
進階設定 使用者:在專案的「Firebase Hosting 」頁面 中,「設定狀態 」更新為「已連結」 前,網站會由先前的代管服務供應商代管。
注意: Firebase Hosting 會視需要自動為自訂網域重新佈建 SSL 憑證。
您的自訂網域金鑰
新增或編輯 DNS 記錄時,不同網域供應商會要求你在 DNS 管理網站的「主機」 欄位中輸入不同內容。下方列出熱門供應商的常見輸入內容。
如需詳細操作說明,請參閱網域供應商的說明文件。
網域類型
自訂網域金鑰
Apex 網域
常見的輸入內容包括:
@
頂層網域名稱 (例如:
example .com
)
將「主機」 欄位留空
子網域
常見的輸入內容包括:
完整子網域名稱 (例如 app.example .com
)
僅限子網域部分 (例如僅限 app
,不含 .example .com
)
只有 www
子網域的 www.example .com
常見網域供應商
以下列出幾個常見的網域供應商,以及各供應商可能要求的輸入類型。
我們會盡可能提供最新資訊,但如需詳細操作說明,請參閱網域供應商的說明文件。
Cloudflare
類型
主機
值
DNS TXT 記錄輸入內容
TXT
example .com
Firebase 控制台中提供的驗證值
DNS A 記錄輸入內容
A
example .com
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
類型
主機
值
DNS TXT 記錄輸入內容
TXT
example .com
Firebase 控制台中提供的驗證值
DNS A 記錄輸入內容
A
example .com
199.36.158.100
A
www
199.36.158.100
NameCheap
類型
主機
值
DNS TXT 記錄輸入內容
TXT
@
Firebase 控制台中提供的驗證值
DNS A 記錄輸入內容
A
@
199.36.158.100
A
www
199.36.158.100
Squarespace
類型
主機
值
DNS TXT 記錄輸入內容
TXT
@
Firebase 控制台中提供的驗證值
DNS A 記錄輸入內容
A
@
199.36.158.100
A
www
199.36.158.100
自訂網域的設定狀態說明
狀態
說明
需要設定
您可能需要變更 DNS 記錄的設定。
待處理
您已正確設定自訂網域,但 Firebase Hosting 尚未佈建 SSL 憑證。
有時,下列問題可能會導致系統無法為自訂網域核發 SSL 憑證:
您的 CAA 記錄限制過多。
疑難排解提示:請確認憑證授權單位 `letsencrypt.org` 和 `pki.goog` 獲准為您的網域建立 SSL 憑證。
驗證碼無效。 如果您使用進階設定流程,且遷移作業失敗,則權杖 (和驗證碼) 現在無效。
疑難排解提示:按一下網域的「查看」 ,然後將新權杖提供給現有網域。
您為過多子網域要求憑證。
疑難排解提示:一般來說,Firebase Hosting 建議單一頂層自訂網域的子網域數量不超過 20 個,以免超出 SSL 憑證核發限制。
建立憑證
系統正在為您的網域製作 SSL 憑證。
已連結
自訂網域具有正確的 DNS 記錄和 SSL 憑證。
您可以提供網站內容。