凌霞官网对于 1Panel V2 特性的描述：https://www.lxware.cn/archives/1panel-v2

1Panel V1 升级 1Panel V2 的官方迁移工具：https://gitee.com/fit2cloud-feizhiyun/1panel-migrator

在进行以下操作前务必前往 1Panel 面板中的 面板设置 -> 快照 中创建快照并保存快照，避免升级失败后配置丢失和回滚操作。(注意：由于版本机制差异，V1 的快照记录无法迁移至 V2)

方式一：使用迁移工具升级到 1Panel V2

1）安装迁移工具

工具下载：https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/

工具安装说明：https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/blob/master/install.md

注意修改代码中的版本号

# 1. 进入临时目录
cd /tmp

# 2. 下载适用于您服务器架构的二进制文件（以 amd64 架构为例）
wget https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/download/v2.0.3/1panel-migrator-linux-amd64

# 3. 添加执行权限
chmod +x 1panel-migrator-linux-amd64

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

2）升级 1Panel

使用迁移工具升级说明：https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/blob/master/upgrade.md

🚀 升级说明

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

请务必先完成服务升级，再进行网站升级。

服务升级分为两种角色：

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

升级为主节点

第一步：升级服务

1panel-migrator upgrade core

第二步：升级网站

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

1panel-migrator upgrade website

升级为从节点

第一步：升级服务

1panel-migrator upgrade agent

第二步：在主节点添加从节点

前往主节点 节点管理 页面，添加该从节点。系统会自动识别并处理 V1 的历史数据。

第三步：升级网站

注意：添加完成后，请在从节点服务器上执行网站升级命令。

1panel-migrator upgrade website

方式二：手动升级 1Panel V2

如果使用官方迁移工具无法升级到 1Panel V2，则尝试手动升级。（注意，网站、证书等部分无法备份，需要重新配置）

1）备份数据

保存容器文件： 保存1Panel 安装地址中 apps 目录下的全部内容 /vol1/@appdata/1Panel/1panel/apps

创建应用备份：进入 1Panel 管理面板 -> 应用商店 中为所有应用手动创建备份并保存备份。（注意 Halo 建站工具应在 Halo 控制台中手动创建备份以防止 1Panel 备份失效）

2）卸载原 1Panel V1

# 停止 1Panel 服务
systemctl stop 1panel

# 使用 1Panel 自带工具卸载
1pctl uninstall

# 清理残留数据文件
rm -rf /var/lib/1panel /etc/1panel /usr/local/bin/1pctl

3）安装 1Panel V2

# 使用官方安装脚本，为方便管理，安装目录选择在飞牛的 @appdata 目录下
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

常见问题

（回滚）回退到 1Panel V1

回退操作说明：https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/blob/master/rollback.md

ℹ️ 回滚说明

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

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

服务回滚

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

1panel-migrator rollback service

网站回滚

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

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

1panel-migrator rollback website

升级失败：提示 SQL 没有表 mcp_servers

错误详情：

=============== error ===============
github.com/1Panel-dev/v1-to-v2-migrator/upgrade/transfer/mcp_server.go: line-13
migrator v1 to v2 core failed, err: SQL logic error: no such table: mcp_servers (1)

迁移工具版本：v2.0.3

解决方案：

没有找到对应解决方案，可能导致 1Panel 面板及其代理网站无法访问，使用 systemctl restart 1panel 重启面板服务恢复访问。

等待新版本的迁移工具以及 lts 版本的 1panel v2 。

面板 IPv6 支持

在 V1 版本中，可在 设置 -> 安全 中添加对监听 IPv6 的支持，但是 V2 版本没有此选项，因此只能使用终端手动开启。

1pctl listen-ip ipv6