1Panel V1.10 老版本 升级到 V2.0 版本（保姆教程）

1Panel V1.10 升级到 V2.0 版本需要通过官方迁移工具 1panel-migrator 进行操作，且需注意以下关键步骤和注意事项：

升级前提条件

1. 版本要求：仅支持从 1Panel v1.10.29-lts 及以上版本 迁移至 V2.0
2. 架构变动：V2 版本与 V1 架构差异较大，不支持直接在线升级，必须使用迁移工具

升级步骤

1. 下载并安装迁移工具（以 amd64 架构为例，如果是arm，自行替换参数）

# 进入临时目录
cd /tmp
# 下载工具（以 amd64 架构为例）
wget https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/download/v2.0.4/1panel-migrator-linux-amd64
# 添加执行权限
chmod +x 1panel-migrator-linux-amd64
# 移动至系统 PATH 并重命名
sudo mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator

注：若下载链接失效，可参考官方地址 https://gitee.com/fit2cloud-feizhiyun/1panel-migrator

2. 升级服务与网站

升级分为两步，必须按顺序执行：

1. 升级核心服务

   sudo 1panel-migrator upgrade core

   • 完成后系统将升级至 1Panel v2.0.0，并自动更新 OpenResty 至 1.27.1.2-0-1-focal
   • 面板内置的 PHP 环境会被移除，但已创建的 PHP 容器会迁移为静态网站，后续可手动切换回 PHP 环境。

2. 升级网站配置

   sudo 1panel-migrator upgrade website

   • 需确保 V2 服务已成功启动后再执行此命令
   • 所有网站配置将迁移至 {1Panel安装目录}/www

注意事项

• PHP 环境调整：V2 版本中 PHP 运行环境需重新创建，原静态网站需手动切换为 PHP 网站
• 资源优化：V2 版本后台资源占用降低约 50%（从 188MB 降至 94MB），性能更优
• 角色区分：若部署多节点，主节点需升级 core 和 agent，从节点仅需升级 agent

常见问题

• 端口开放：升级后需检查防火墙或安全组是否放行 1Panel 的默认端口（如 8080 或 8090）
• 回滚支持：官方未提及回滚方案，建议升级前备份重要数据。