1panel 从v1 升 v2版本

由于 V2 版本较 V1 版本有比较大的架构变动，目前不支持从 V1 版本直接在线升级至 V2 版本。

1Panel V1 版本的用户，可以使用官方提供的迁移工具 1panel-migrator，将 1Panel V1 平滑升级至 1Panel V2。但是，为了避免出以外，先备份好数据。

1 安装 1panel-migrator

1.1 安装包获取

请访问 1PanelGitee 发布页面，手动下载适用于您服务器架构的安装包，并将其放置到 /tmp 目录：

每个版本会提供以下架构的安装包（文件名示例）：

• 1panel-migrator-linux-amd64
• 1panel-migrator-linux-arm64
• 1panel-migrator-linux-arm
• 1panel-migrator-linux-ppc64le
• 1panel-migrator-linux-s390x

1.2 安装步骤

以 amd64 架构为例说明 1panel-migrator 的安装步骤：

# （1）进入临时目录
cd /tmp

# （2）添加执行权限
chmod +x 1panel-migrator-linux-amd64

# （3）移动至系统 PATH 中并重命名
mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator

2 升级说明

升级过程分为两步：升级服务 和 ​升级网站​。

服务升级分为两种角色：

• ​主节点​：包含 1panel-core 和 1panel-agent 两个服务，开放对外端口，支持通过浏览器访问；
• ​从节点​：仅包含 1panel-agent 服务，不开放对外端口，需要通过主节点的 节点管理 页面添加并管理。

2.1 升级为主节点

• 升级服务

升级前先确保v1版时为最新版本

1panel-migrator upgrade core

• 升级网站

注意：请确保 V2 服务启动成功后再执行该命令。

1panel-migrator upgrade website

3 回滚说明

如果升级过程出现问题，可以使用回滚操作恢复到之前的 1Panel V1 版本。

回滚过程也分为两步：回滚 1Panel 服务 和 ​回滚网站​。

注意

请务必先完成服务的回滚，再进行网站回滚。

3.1 服务回滚

不区分主从节点，直接在目标服务器执行以下命令：

1panel-migrator rollback service

3.2 网站回滚

同样在目标服务器执行以下命令：

1panel-migrator rollback website