ServBay 跨平台資料遷移指南

當您升級設備或在不同平台間切換（例如從 Intel Mac 移至 Apple Silicon Mac，或從 macOS 遷移至 Windows），為確保您的 ServBay 本機開發環境能在新設備上順暢運作，需遵循特定的遷移流程。本指南將提供詳細步驟。

為什麼需要特別的遷移流程？

ServBay 是跨平台本機開發環境，支援 macOS 與 Windows 作業系統。在 macOS 上，主程式採通用架構，原生相容 Intel 及 Apple Silicon (M 系列) 晶片。

然而，ServBay 所提供的套件（如 PHP、Node.js、Python、Go、Java、MySQL、MariaDB、Nginx、Apache 等）皆針對指定的作業系統及 CPU 架構編譯與最佳化。這表示：

• macOS Intel 版本的套件無法於 Apple Silicon Mac 上執行
• macOS 版套件無法在 Windows 上運行
• Windows 版套件無法在 macOS 上執行

所以當您在不同平台或架構間切換時，不能只是單純複製整個 ServBay 目錄，而必須重新安裝所有套件，並移轉您的個人資料及設定。

詳細遷移步驟

請依照以下步驟作業，以確保資料完整且正確地移轉。

步驟 1：完整停止並退出 ServBay

在舊 Intel Mac 上，點擊螢幕頂端選單列的 ServBay 圖示，於選單中選擇 停止所有服務並退出。這能確保所有資料於備份前已正確關閉。

步驟 2：備份 ServBay 資料目錄

macOS:

1. 打開 Finder，前往 /Applications 目錄。
2. 找到名為 ServBay 的資料夾（注意，這不是 ServBay.app 應用程式本身）。
3. 將此資料夾重新命名為 ServBay.bak。

Windows:

1. 打開檔案總管，前往 C:\ 目錄。
2. 找到名為 ServBay 的資料夾。
3. 將此資料夾重新命名為 ServBay.bak。

此目錄包含您的所有網站檔案、資料庫、SSL 憑證、備份與設定。

步驟 3：在新設備上全新安裝 ServBay

1. 將 ServBay.bak 目錄完整自舊設備複製至新設備：
   • macOS: 複製至 /Applications 目錄下
   • Windows: 複製至 C:\ 目錄下
2. 於新設備上下載並安裝最新版 ServBay 主程式。
3. 首次開啟 ServBay 時，會引導您進行全新安裝，請依提示完成。安裝成功後會產生新的 ServBay 目錄：
   • macOS: /Applications/ServBay
   • Windows: C:\ServBay

步驟 4：重新安裝所有必要套件

1. 在新設備開啟 ServBay。
2. 進入左側導覽列 套件 (Packages) 頁面。
3. 根據您之前在舊設備使用的狀況，重新安裝所有曾用套件（如 PHP 8.2、MySQL 8.0、Nginx 1.25 等）。
4. 重要提醒： 此時僅需安裝套件，無需啟用。

步驟 5：再次完整停止並退出 ServBay

安裝完所有套件後，再次點選選單列 ServBay 圖示，選擇 停止所有服務並退出。

步驟 6：移轉核心資料及設定

此時，您的設備上應有兩個相關目錄：

• macOS:
  • /Applications/ServBay.bak（舊設備備份）
  • /Applications/ServBay（新設備安裝）
• Windows:
  • C:\ServBay.bak（舊設備備份）
  • C:\ServBay（新設備安裝）

請執行以下複製作業：

打開備份目錄，將下列子目錄複製至新 ServBay 安裝目錄，並選擇覆蓋所有同名的檔案與目錄：

• backup：包含所有手動及自動備份檔案。
• data：包含您的網站設定、應用程式設定等。
• db：包含全部資料庫檔案（MySQL、MariaDB、PostgreSQL）。
• ssl：包含所有 SSL 憑證檔案。
• www：包含所有網站專案檔案。

注意：此步驟至關重要，會恢復您的所有資料。

步驟 7：聯絡技術支援轉換設定檔（關鍵步驟）

由於平台與架構不同，需將舊的設定檔進行轉換，才能於新平台使用。

1. 在新設備找到之前備份的設定檔：
   • macOS: /Applications/ServBay.bak/data/servbay/config.data
   • Windows: C:\ServBay.bak\data\servbay\config.data
2. 請將此 config.data 以官方 Discord、Telegram、微信或信箱發送給 ServBay 技術支援人員。
3. 技術支援團隊會協助轉換此檔案，使其適配新平台與架構，並將轉換後檔案回傳給您。
4. 收到後，請將轉換後的檔案覆蓋至新 ServBay 之對應路徑：
   • macOS: /Applications/ServBay/data/servbay/config.data
   • Windows: C:\ServBay\data\servbay\config.data

步驟 8：重新安裝 ServBay Root CA

1. 開啟 ServBay 應用程式。
2. 進入左側導覽列之 設定 (Settings)。
3. 於設定頁面找到 ServBay Root CA 選項，點選 重新安裝 ServBay Root CA 按鈕。

步驟 9：重新啟動全部服務

1. 進入左側導覽列之 套件 (Packages) 頁面。
2. 對已安裝的每個套件逐一進行重啟：先點選開關將其停用，再點一次開關將其啟用。此舉可確保所有服務均以您剛剛遷移的資料與設定啟動。

步驟 10：完成遷移

至此，您的 ServBay 資料遷移作業已全部完成！您可在新設備上正常使用 ServBay，並檢查網站、資料庫及各服務均是否運作正常。

常見問題 (FAQ)

• Q: 我能否跳過聯絡技術支援轉換 config.data 的步驟？
  • A: 不行。 config.data 內含平台與架構相關的關鍵設定。略過此步驟將使 ServBay 無法正確載入網站、資料庫及其它服務設定，甚至可能無法啟動。
• Q: 如果忘記原本安裝了哪些套件怎麼辦？
  • A: 您可在聯絡技術支援轉換 config.data 檔時一併詢問。檔案中紀錄了您原先安裝的套件資訊。
• Q: 遷移後網站無法訪問怎麼處理？
  • A: 請依序檢查：
    1. 確認已於第 9 步重啟所有相關套件（如 Nginx/Apache 及對應 PHP 版本）。
    2. 檢查 ServBay 中網站設定是否正確。
    3. 查看套件的日誌檔，排除具體錯誤。