如何將 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: 請依序檢查: