吐槽
由于飞牛官方没有适配1panel的v2版本,别说v2了,v1升级都升不了;1panel官方也没有单独提供对飞牛的版本进行升级的额外支持。只能自己另辟蹊径了。
升级效果展示



目前已知bug
1、升级后程序会异常退出(可以在飞牛日志中查看到)
这是因为升级到2.x版本后会额外再运行一个客户端,两个都是同一个端口,导致冲突
# 2.x 的端
/usr/bin/1panel-agent
/usr/bin/1panel-core
# 飞牛的端
/vol1/@appcenter/1Panel/bin/1panel # 之前v1.10.34版本
解决方案:
a、可以给其中一个换一个端口,然后v1、v2版本共存
b、先进商店手动停止1panel
c# 停止2.x版本
systemctl stop 1panel-core
# 禁止2.x版本自动启动
systemctl disable 1panel-core
# 将2.x版本替换商店的版本
mv /usr/bin/1panel-core /usr/bin/1panel-core_backup
cp /usr/bin/1panel-core_backup /vol1/@appcenter/1Panel/bin/1panel
# 这样商店的版本就是2.x的版本了,但是后续升级不知道会不会又在
# /usr/bin/下创建1panel-agent和1panel-core
# 所以目前这样操作也仅是权宜之计
流程开始
开始前必须确认自己已经做好升级准备
开始前必须确认自己已经做好升级准备
开始前必须确认自己已经做好升级准备
升级至v1最新版
如果你已经是 v1.10.34,需要确认下1panel面板是否有AI功能,如果没有建议先按照以下方式升级一次
1、下载v1最新版本
# 进入到临时目录
cd /tmp
# 下载v1最新版本
wget https://resource-fit2cloud-com.oss-cn-hangzhou.aliyuncs.com/1panel/package/stable/v1.10.34-lts/release/1panel-v1.10.34-lts-linux-amd64.tar.gz
# 解压到当前目录
tar -xzvf 1panel-v1.10.34-lts-linux-amd64.tar.gz
2、替换文件
# 飞牛商店下载的版本 替换的文件路径, 也就是将解压出来的1panel二进制文件,替换到原来的1panel二进制文件;如果提示无法替换,可以另外起个名字先复制到/vol1/@appcenter/1Panel/bin/目录下,然后回到飞牛商店,关闭1panel,再用飞牛的文件管理进到/vol1/@appcenter/1Panel/bin/下进行替换即可
cp 1panel-v1.10.34-lts-linux-amd64/1panel /vol1/@appcenter/1Panel/bin/
升级至v2版本
替换完成后,在飞牛商店启动1panel,开始进行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
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-migrator upgrade core
# 确认 V2 服务启动成功后,再执行:
1panel-migrator upgrade website
从节点(仅含 **1panel-agent**)
# 1. 升级服务
1panel-migrator upgrade agent
# 2. 前往主节点「节点管理」页面添加该从节点
# 3. 在从节点服务器执行:
1panel-migrator upgrade website
# 1. 升级服务
1panel-migrator upgrade agent
# 2. 前往主节点「节点管理」页面添加该从节点
# 3. 在从节点服务器执行:
1panel-migrator upgrade website
数据迁移影响一览
| 项目 |
说明 |
| 网站目录 |
迁移至 {1Panel 安装目录}/www(如 /opt/1panel/www) |
| OpenResty |
自动升级至 1.27.1.2-0-1-focal;自定义主配置请提前备份 |
| PHP 网站 |
内置 PHP 环境移除;原 PHP 容器保留,迁移为静态网站。可在 V2 创建新 PHP 环境后切换 |
| 反向代理 |
执行 upgrade website 前,请关闭所有网站的反代缓存 |
| 备份记录 |
V1 所有备份记录清空,需重新配置备份策略 |
| 主机终端 |
主机列表、分组、快速命令仅在升级主节点时迁移 |
| 计划任务 |
任务本身迁移,执行记录不保留 |
| 快照记录 |
V1 快照与 V2 不兼容,无法迁移 |
| WAF / 网站监控 |
大部分不兼容,仅保留黑白名单、IP 组、自定义规则 |
| 面板设置 |
以当前 V2 主节点的配置为准 |
回滚操作
如升级过程出现问题,可回滚至 V1(不区分主从节点,先回滚服务,再回滚网站):
# 1. 回滚服务
1panel-migrator rollback service
# 2. 确认 V1 服务启动成功后:
1panel-migrator rollback website