如何将 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: 您可以在联系技术支持转换
config.data
文件时一并咨询。文件中记录了您之前安装的软件包信息。
- A: 您可以在联系技术支持转换
- Q: 迁移后我的网站无法访问怎么办?
- A: 请按顺序检查:
- 确保在第 9 步中已重启了所有相关的软件包(如 Nginx/Apache 和对应的 PHP 版本)。
- 检查 ServBay 中网站的配置是否正确。
- 查看相关软件包的日志文件,排查具体的错误信息。
- A: 请按顺序检查: