由于 V2 架构变动较大，不支持从 V1 直接在线升级至 V2。升级需分两部分：许可证升级 与 应用升级。
一、许可证升级
登录 凌霞官网，在 个人中心 → 许可证列表 中，选择需要升级的 V1 买断许可证，点击升级，即可获得对应的 V2 许可证。
二、应用升级
1Panel 官方提供迁移工具 1panel-migrator，可将 V1 平滑升级至 V2。
升级前必读
创建快照：在 1Panel 控制台「面板设置」手动创建系统快照，或通过云服务商创建云主机快照，防止意外风险。
版本要求：仅支持
v1.10.29-lts及以上版本，迁移后将升级至v2.0.0。许可证处理：迁移过程中，V1 许可证将被清除并统一降为社区版；V2 许可证导入前，请先在 凌霞官网 确认已成功解绑。
步骤 1：安装 1panel-migrator
前往 Gitee Releases 下载与服务器架构匹配的安装包（支持 amd64 / arm64 / arm / ppc64le / s390x），放入 /tmp 目录。以 amd64 为例：
cd /tmp
chmod +x 1panel-migrator-linux-amd64
mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator步骤 2：执行升级
升级分两步：先升级服务，再升级网站。根据节点角色选择命令。
主节点（含 1panel-core + 1panel-agent，对外开放端口）
# 升级服务
1panel-migrator upgrade core
# 确认 V2 服务启动成功后，再执行：
1panel-migrator upgrade website从节点（仅含 1panel-agent）
# 1. 升级服务
1panel-migrator upgrade agent
# 2. 前往主节点「节点管理」页面添加该从节点
# 3. 在从节点服务器执行：
1panel-migrator upgrade website数据迁移影响一览
回滚操作
如升级过程出现问题，可回滚至 V1（不区分主从节点，先回滚服务，再回滚网站）：
# 1. 回滚服务
1panel-migrator rollback service
# 2. 确认 V1 服务启动成功后：
1panel-migrator rollback website问题反馈
迁移过程中如遇问题，请在 1Panel 主仓库 提交 Issue。
