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

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

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

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

重要事項： 為反映您的工作流程環境 (例如開發、第 1 階段、第 2 階段、正式版)，建議您為每個環境建立個別的 Firebase 專案，而不是在單一 Firebase 專案中建立多個網站。一般來說，您不應在開發環境中使用正式環境的 Firebase 資源 (例如 Realtime Database 中的客戶資料)。建議您使用自動 SDK 設定，透過單一程式碼基底複製多個環境。

每個 Firebase 專案最多支援 36 個網站。

步驟 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 中不得重複

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

注意： 如果您在 2018 年 8 月前在 Firebase 專案中建立了多個 Firebase Realtime Database 執行個體，Firebase 會為每個資料庫執行個體自動佈建對應的網站。如果您不需要這些額外網站，可以刪除這些網站，而不會影響資料庫執行個體。

刪除次要網站

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

• 使用 Firebase 主控台「Hosting」頁面中的工作流程

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

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

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

注意： 刪除網站是永久性動作，如果您刪除網站，Firebase 不會保留已部署檔案或部署記錄的記錄，而且您或任何人也無法重新啟用 SITE_ID。

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

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

重要事項：建議您使用部署目標，為多個 Hosting 網站設定部署作業。
如果您先前曾透過明確參照 SITE_ID 來設定 firebase.json 檔案，則應編輯 firebase.json 設定和 CLI 指令，改為使用部署目標。

如要建立部署目標，並將 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 內容和設定

注意：如果您搭配 --only hosting 標記執行指令，就只能模擬或部署 Hosting 內容和設定。如果您也想模擬或部署其他專案資源或設定 (例如函式或資料庫規則)，請在標記中使用以半形逗號分隔的清單執行指令 (例如 --only hosting,functions)。

如果是部署至預覽頻道，您不需要在 --only 標記中指定 hosting，因為這些指令只能部署 Hosting 內容和設定。