从1Panel V1升级到1Panel V2
前言
1Panel是一款服务器管理软件，和宝塔面板相比个人感觉轻量了不少，尤其是界面设计，让人耳目一新，商业气息也没有宝塔那么浓重，还是开源的。之前一直不知道1Panel出了v2，这几天看到有别人升级才知道，记录一下升级过程。
新特性
v2加入了很多新特性，例如：
- 多个 PHP 网站可共用一个 PHP 容器
- 同类型备份账号支持创建多个
- 概览页支持自定义显示应用
- 支持隐藏左侧菜单栏
上面的是我比较喜欢的，完整的在1Panel V2 正式上线！ – 凌霞软件。
占用情况
我的1Panel是跑在pve的CentOS容器里的，升级前占用如下：
升级后：
开始升级
备份！备份！备份！重要的事情说三遍，升级前一定要备份。
升级要特别注意以下几点，完整版可以看升级说明 – 1Panel 文档：
- 1Panel版本必须大于等于
v1.10.29-lts - 已有的PHP网页会成为静态网页
- 所有网站配置将存放于
{1Panel 安装目录}/www - 原有许可证将被清除，统一迁移为社区版本
（当然我肯定是没有买专业版）
docker容器的应用程序亲测不会在升级中被关闭。
首先下载官方迁移工具
# 1. 进入临时目录
cd /tmp
# 2. 下载适用于您服务器架构的二进制文件（以 amd64 架构为例）
wget https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/download/v2.0.10/1panel-migrator-linux-amd64
# 3. 添加执行权限
chmod +x 1panel-migrator-linux-amd64
# 4. 移动至系统 PATH 中并重命名
mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator完成后，正式开始升级，分为升级服务和升级网站两步，必须按照先服务再网站的顺序完成。
升级服务
1Panel支持分布式管理，因此服务升级需要区分主从节点，我是单节点部署，使用主节点的步骤。
运行，并按照提示操作
1panel-migrator upgrade core输出内容
[root@CentOS tmp]# 1panel-migrator upgrade core
注意事项：
在将 1Panel V1 服务迁移至 V2 主节点前，请务必阅读！
1. 原有 V1 版本的许可证信息将被清除，统一迁移为社区版本
2. 出于兼容性考虑，所有 V1 网站、应用和数据库的备份记录将被清空
3. 计划任务的执行记录将不保留（保留 V1 创建的计划任务本体）
4. 由于版本机制差异，V1 的快照记录无法迁移至 V2
迁移期间将停止当前 V1 服务，请确认风险后再继续操作。
是否确认将 V1 迁移至 V2 主节点？ (y/n): y
2025/08/23 14:19:38 即将开始自动下载 V2 安装包，请耐心等待，勿关闭终端。
2025/08/23 14:19:42 安装文件下载成功！
2025/08/23 14:19:43 初始化 core.db 完成
2025/08/23 14:19:43 [xpack] 初始化 core.db 完成
2025/08/23 14:19:44 初始化 agent.db 完成
2025/08/23 14:19:44 [xpack] 初始化 agent.db 完成
2025/08/23 14:19:44 基础数据初始化成功！
2025/08/23 14:19:44 即将自动迁移并备份 V1 相关数据，请耐心等待，勿关闭终端。
2025/08/23 14:19:51 数据迁移成功！
2025/08/23 14:19:51 备份 V1 相关数据成功！
迁移成功，版本已经成功迁移至 v2.0.0
请执行 1panel-migrator upgrade website 命令来升级网站升级网站
确保v2服务启动成功，1Panel可以访问之后，升级网站：
1panel-migrator upgrade website升级网站需要拉取openresty的镜像，可以先配置一下docker加速
1Panel V2的界面如图：
输出内容
[root@CentOS tmp]# 1panel-migrator upgrade website
注意事项：
网站迁移前请务必阅读！
1. 迁移完成后，所有网站配置将保存至 {1Panel 安装目录}/www
2. OpenResty 将升级至 1.27.1.2-0-1-focal
3. 迁移操作会重置 OpenResty 主配置文件，如有自定义修改，请提前备份
4. 迁移操作会重置 OpenResty 00.default.conf 会取消默认的 default_server 可以在升级之后用 v1 的 00.default.conf 文件替换，
5. PHP 运行环境将被移除（已创建网站中的 PHP 容器不会删除，但会迁移为静态网站）
6. V2 版本迁移成功后，可在网站设置中将迁移的静态网站切换为 PHP 网站
7. 因反代缓存机制已重构，所有网站的反代缓存将会关闭，请升级之后重新打开
迁移期间网站将不可访问，请确认风险后继续操作。
是否确认迁移网站？ (y/n): y
再次确认：确定要升级网站吗？ (y/n): y
正在升级网站...
2025/08/23 15:11:37 应用商店状态正常
2025/08/23 15:11:37 已存在 openresty 安装包，跳过下载
2025/08/23 15:11:37 开启拉取 Openresty 镜像 1panel/openresty:1.27.1.2-2-2-focal 请等待
镜像 1panel/openresty:1.27.1.2-2-2-focal 已存在，跳过拉取
2025/08/23 15:11:37 docker-compose down executed successfully
2025/08/23 15:11:37 备份 V1 Openresty 到 /opt/1panel/backup/openresty 目录
2025/08/23 15:11:37 备份 V1 Openresty 成功
2025/08/23 15:11:37 开始迁移网站目录
2025/08/23 15:11:37 迁移网站 www 目录到 /opt/1panel/www 目录
2025/08/23 15:11:37 迁移网站 www 目录成功
2025/08/23 15:11:37 迁移 Openresty conf.d 目录成功
2025/08/23 15:11:37 未找到匹配的目录
2025/08/23 15:11:37 开始升级 Openresty
2025/08/23 15:11:37 解压 Openresty
2025/08/23 15:11:38 移动 Openresty 目录 /tmp/openresty/1.27.1.2-2-2-focal 到 /opt/1panel/apps/openresty/openresty
2025/08/23 15:11:38 拷贝 Openresty .env
2025/08/23 15:11:38 处理 WAF 配置
2025/08/23 15:11:38 启动 Openresty ...
2025/08/23 15:11:39 docker-compose up -d executed successfully
2025/08/23 15:11:39 启动 Openresty 成功
2025/08/23 15:11:39 升级 Openresty 成功至此，升级完成。需要注意的是默认升级到2.0.0版本，可点击右下角再次更新。
