如何將 ServBay 資料從 Intel 晶片遷移到 Apple Silicon (M系列) 晶片 Mac
首先，恭喜您升級到搭載 Apple Silicon 晶片的新 Mac！為了確保您的 ServBay 本機開發環境能夠順利且高效地在新裝置上運作，需要跟隨一套特定的遷移流程。本指南會為您說明詳細的操作步驟。
為什麼需要特別的遷移流程？
ServBay 的主程式為通用架構，原生支援 Intel 及 Apple Silicon (M系列) 晶片。
然而，ServBay 提供的核心套件（如 PHP、Node.js、Python、Go、Java、MySQL、MariaDB、Nginx、Apache 等）皆是針對指定 CPU 架構編譯與優化。也就是說，為 Intel 晶片編譯的套件無法直接在 M 系列晶片上執行，反之亦然。
因此，從 Intel Mac 換到 M 系列 Mac 時，不能僅僅直接複製整個 ServBay 目錄，還必須替換所有已安裝的套件，並遷移您的個人資料和設定。
詳細遷移步驟
請務必依照以下步驟操作，以確保資料遷移過程的完整與正確。
第 1 步：完全停止並退出 ServBay
在舊的 Intel Mac 上，請點擊畫面頂部選單列 (Menubar) 的 ServBay 圖示，從選單中選擇 停止所有服務並退出。這一步可確保所有資料檔案在備份前都已正確關閉，是關鍵的一步。
第 2 步：備份 ServBay 資料目錄
- 開啟 Finder (訪達)，前往
/Applications目錄。 - 找到名為
ServBay的目錄（注意，不是ServBay.app應用程式本身）。 - 將此目錄重新命名為
ServBay.bak。此目錄含有您的所有網站檔案、資料庫、SSL 憑證、備份及設定資料。
第 3 步：在新 Mac 上全新安裝 ServBay
- 將
ServBay.bak目錄完整從舊 Mac 複製到新 M 系列 Mac 的/Applications目錄下。 - 在您的新 M 系列 Mac 上下載並安裝最新版 ServBay 主程式。
- 首次開啟 ServBay.app，系統會引導您進行全新的安裝流程。請依照提示正常安裝。安裝完成後，
/Applications目錄下會產生一個新的ServBay目錄。
第 4 步：重新安裝所有必需的套件
- 在新 Mac 上開啟 ServBay。
- 進入左側導覽列的 套件 (Packages) 頁面。
- 根據舊裝置的使用情況，重新安裝所有曾經用過的套件（例如 PHP 8.2、MySQL 8.0、Nginx 1.25 等）。
- 重要提醒： 這個階段只需安裝套件，無需啟用。
第 5 步：再次完全停止並退出 ServBay
所有必需套件安裝完成後，再次點擊選單列的 ServBay 圖示，選擇 停止所有服務並退出。
第 6 步：遷移核心資料與設定
這時候，您的 /Applications/ 目錄下應該有兩個相關資料夾：
/Applications/ServBay.bak（從舊 Mac 備份過來）/Applications/ServBay（新 Mac 剛安裝的）
請依下列步驟操作：
打開 /Applications/ServBay.bak 目錄，將底下的這些子目錄複製到新的 /Applications/ServBay 目錄，並選擇覆蓋所有同名檔案及目錄：
backup：包含您所有的手動與自動備份檔案。data：包含您網站的設定、應用程式相關資料等。db：包含您所有的資料庫檔案（MySQL, MariaDB, PostgreSQL）。ssl：包含您所有的 SSL 憑證檔案。www：包含您的所有網站專案檔案。
注意：這一步非常重要，會還原您全部的資料。
第 7 步：聯絡技術支援進行設定轉換（關鍵步驟）
由於 CPU 架構不同，舊的設定檔案無法直接在新架構下使用。
- 在新 Mac 上，找到之前備份的設定檔：
/Applications/ServBay.bak/data/servbay/config.data。 - 請將這個
config.data檔案發送給 ServBay 官方技術支援（如 Discord、Telegram、微信或電子郵件）。 - 技術支援團隊會幫您轉換該檔案，以相容 M 系列新架構，並將轉換檔寄回給您。
- 收到新檔案後，請將其覆蓋至新 ServBay 的相對位置：
/Applications/ServBay/data/servbay/config.data。
第 8 步：重新安裝 ServBay Root CA
- 開啟 ServBay 應用程式。
- 進入左側導覽列的 設定 (Settings)。
- 在設定頁面中，尋找
ServBay Root CA選項，點擊重新安裝 ServBay Root CA按鈕。
第 9 步：重啟所有服務
- 進入左側導覽列的 套件 (Packages) 頁面。
- 對於所有已安裝的套件，逐一進行重啟：先點擊開關將其停用，再點一次開關將其啟用。這樣可以確保所有服務都會以您剛遷移的資料與設定正確啟動。
第 10 步：完成遷移
到此為止，您的 ServBay 資料已經全部順利遷移！您現在可在新的 M 系列 Mac 上正常運作 ServBay。請檢查您的網站、資料庫及其他服務是否皆正常。
常見問題集 (FAQ)
- Q: 可以跳過聯絡技術支援轉換
config.data檔案嗎？- A: 不可以。
config.data檔案中包含與硬體架構相關的重要設定。如跳過此步驟，ServBay 將無法正確載入您的網站、資料庫和其他服務設定，甚至可能無法啟動。
- A: 不可以。
- Q: 如果忘記之前安裝了哪些套件怎麼辦？
- A: 您可以在聯絡技術支援進行設定檔轉換時一併詢問。相關資訊已記錄在檔案中。
- Q: 遷移後網站無法訪問怎麼處理？
- A: 請依序檢查：
- 確認已於第 9 步重啟所有相關套件（如 Nginx/Apache 及相對應的 PHP 版本）。
- 檢查 ServBay 內網站的設定是否正確。
- 查看相關套件的日誌檔，排查具體錯誤資訊。
- A: 請依序檢查：
