耗子面板 2.x 迁移升级 AcePanel 3.0 说明

[haozi (耗子)]

本文介绍通过耗子面板 >=2.5.11 版本的「工具箱」->「迁移 3.0」功能迁移升级到 AcePanel 3.0。整体思路是迁移网站及数据库至另一台安装 AcePanel 3.0 的服务器，相比就地升级操作更为简单。

若您需要就地升级，请参考：

耗子面板 2.x 就地升级 AcePanel 3.0 说明

从耗子面板 2.x 就地升级至 AcePanel 3.0 本文档介绍如何在不重装系统的前提下，将耗子面板 2.x升级到AcePanel 3.0。整体思路是：在旧面板对部分关键应用做「不删除数据的部分卸载」（移除 service/命令入口等），随后安装新面板并部署一致环境，最后将旧面板的数据与站点内容迁移到新面板。 此教程为就地升级，若此教程不适合，请考虑迁移升级： 名词解释 就地升级：在不重装系统的前提下完成升级。 迁移升级：将数据迁移至一台新服务器完成升级。 旧面板：耗子面板 2.x（待升级的面板）。 新面板：AcePanel 3.0（目标面板）。 操作须知（务必阅读） 风险极高：开始前必须对服务器做快照/完整备份，并确认可回滚。 停机时间较长：升级期间需停止网站及环境，请提前预留升级窗口并通知业务方。 路径冲突限制：旧面板不能安装在 /opt/ace 目录（避免与新面板默认目录冲突）。 不适用场景：若数据盘挂载在旧面板安装目录，本方案不适用；需额外购买/挂载新的数据盘用于部署新面板（或调整挂载方案后再执行）。 升级前准备 1）确认旧面板环境运行正常 登录旧面板，依…

名词解释

• 就地升级：在不重装系统的前提下完成升级。
• 迁移升级：将数据迁移至一台新服务器完成升级。
• 旧面板：耗子面板2.x（待升级的面板）。
• 新面板：AcePanel 3.0（目标面板）。

操作须知（务必阅读）

1. 风险极高：开始前必须对服务器做快照/完整备份，并确认可回滚。
2. 停机时间较长：升级期间建议停止网站及环境，请提前预留升级窗口并通知业务方。
3. 迁移限制：1. 不支持迁移网站的 SSL 证书，迁移后需要重新设置。2. 不支持迁移网站的伪静态等自定义配置，迁移后需要重新设置。3. 迁移后网站类型为 PHP/纯静态，反向代理类网站建议直接在新面板重新创建而不是迁移。

---

升级前准备

1）确认旧面板环境运行正常

登录旧面板，依次检查 OpenResty、Percona、PHP 等应用，确保运行正常并记录当前版本/配置（便于迁移后核对）。

2）进行服务器快照/备份

前往服务器控制台，对待升级服务器执行快照/备份操作，并务必等待备份成功后再开始后续步骤。

---

新面板准备

新服务器安装 AcePanel 3.0，记录登录信息保存备用。

前往「设置」->「用户」->「访问令牌」，创建用于迁移的访问令牌并保存备用。

安装与旧面板一致的环境（例如 OpenResty、Percona、PostgreSQL、PHP 版本及相关组件）。

等待环境安装完成后进入下一步。

---

迁移数据

旧面板前往「工具箱」->「迁移」，填写新面板信息，点击「下一步」。

确认环境无误（PHP 版本号差异可忽略），点击「下一步」。

勾选需要迁移的项目，点击「开始迁移」。

等待迁移完成，下载迁移日志确认无错误记录。

---

后续工作

注意：新面板默认网站目录结构不同，默认为：/opt/ace/sites/站点名/public

注意：若网站启用了 HTTPS，需要在新面板重新配置证书，使用伪静态的 PHP 网站需要重新配置伪静态。

全部站点迁移后，逐一访问验证（首页、接口、后台、静态资源、上传下载等）确保业务正常。