在多個網站上共用專案資源

您可以在單一 Firebase 專案中設定一或多個 Firebase Hosting 網站。由於這些網站都位於同一個 Firebase 專案中，因此所有網站都能存取專案的其他 Firebase 資源。

  • 每個網站都有專屬的代管設定。
  • 每個網站都會代管自己的內容集合。
  • 每個網站都可以有一個或多個關聯網域。

在同一個 Firebase 專案中設定多個 Hosting 網站，即可更輕鬆地在相關網站和應用程式之間共用 Firebase 資源。舉例來說，如果您將網誌、管理員面板和公開應用程式設為同一個 Firebase 專案中的個別網站，這些網站就能共用相同的 Firebase Authentication 使用者資料庫，同時擁有各自的專屬網域或內容。

步驟 1：更新 Firebase CLI 版本

更新至最新版 Firebase CLI，即可存取最新的 Firebase Hosting 功能。

步驟 2：新增其他網站

使用下列任一方法，將其他網站新增至 Firebase 專案：

  • 使用 Firebase 控制台 Hosting 頁面中的工作流程

  • 使用 Firebase CLI 指令： firebase hosting:sites:create SITE_ID

  • 使用 Hosting REST API： projects.sites.create

針對這些方法，您必須指定 SITE_ID，用於為網站建構 Firebase 佈建的預設子網域：

  • SITE_ID.web.app
  • SITE_ID.firebaseapp.com

由於 SITE_ID 會用於這些網址，因此網站 ID 必須符合下列規定：

  • 必須是有效的主機名稱標籤，也就是說，不得包含 .、_ 等字元。
  • 不得超過 30 個字元
  • 在 Firebase 中不得重複

您也可以選擇為每個網站新增自訂網域，為多個網址提供相同的內容和設定。

刪除次要網站

請使用下列其中一種方法，從 Firebase 專案中刪除不必要的網站：

  • 使用 Firebase 控制台 Hosting 頁面中的工作流程

  • 使用 Firebase CLI 指令： firebase hosting:sites:delete SITE_ID

  • 使用 Hosting REST API： projects.sites.delete

請注意，您無法刪除預設網站，因為該網站的 SITE_ID 與 Firebase 專案 ID 相同。

步驟 3：為網站設定部署目標

如果您擁有多個網站，並執行 Firebase CLI 部署指令，CLI 需要一種方式來傳達應將哪些設定部署至各個網站。透過部署目標，您可以在 firebase.json 設定檔和 Firebase CLI 指令中使用 TARGET_NAME 來唯一識別特定網站，以便測試或部署至網站。

如要建立部署目標，並將 TARGET_NAME 套用至 Hosting 網站，請在專案目錄的根目錄中執行下列 CLI 指令：

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

其中參數如下：

  • TARGET_NAME：您要部署至 Hosting 網站的專屬名稱 (由您自行定義)

  • RESOURCE_IDENTIFIER：Hosting 網站的 SITE_ID，如在 Firebase 專案中列出

舉例來說，如果您在 Firebase 專案中建立了兩個網站 (myapp-blog 和 myapp-app)，可以執行下列指令，為每個網站套用專屬的 TARGET_NAME (分別為 blog 和 app)：

firebase target:apply hosting blog myapp-blog
 
firebase target:apply hosting app myapp-app

部署目標的設定會儲存在專案目錄中的 .firebaserc 檔案中，因此每個專案只需設定一次部署目標。

步驟 4：定義每個網站的代管設定

在 firebase.json 檔案中定義網站的代管設定時，請使用網站已套用的 TARGET_NAME。

  • 如果 firebase.json 檔案定義多個網站的設定，請使用陣列格式：

    {
  "hosting": [ {
      "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
      "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"

      // ...
    },
    {
      "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
      "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"

      // ...

      "rewrites": [...]  // You can define specific Hosting configurations for each site
    }
  ]
}

  • 如果 firebase.json 檔案只定義一個網站的設定，則不必使用陣列格式：

    {
  "hosting": {
      "target": "blog",
      "public": "dist",

      // ...

      "rewrites": [...]
  }
}

步驟 5：在本機測試、預覽變更，並部署至網站

從本機專案目錄根目錄執行下列任一指令。

指令 說明
firebase emulators:start --only hosting 模擬預設 Hosting 網站在本機代管網址的 Hosting 內容和設定
firebase emulators:start --only hosting:TARGET_NAME 在本機代管的網址上模擬指定 Hosting 網站的 Hosting 內容和設定
firebase hosting:channel:deploy \
CHANNEL_ID		 在預覽網址中部署預設 Hosting 網站的 Hosting 內容和設定
firebase hosting:channel:deploy \
CHANNEL_ID --only TARGET_NAME		 在預覽網址中部署指定 Hosting 網站的 Hosting 內容和設定
firebase deploy --only hosting 將 Hosting 內容和設定部署至 firebase.json 中設定的所有 Hosting 網站的直播頻道
firebase deploy --only hosting:TARGET_NAME 將 Hosting 內容和設定部署至指定 Hosting 網站的直播頻道
指令 說明
(不建議使用，請改用 emulators:start)
firebase serve --only hosting 		在本機代管的網址上提供預設 Hosting 網站的 Hosting 內容和設定
(不建議使用，請改用 emulators:start)
firebase serve --only hosting:TARGET_NAME 		在本機代管的網址上，提供指定 Hosting 網站的 Hosting 內容和設定