# 1panel-migrator

**Repository Path**: fit2cloud-feizhiyun/1panel-migrator

## Basic Information

- **Project Name**: 1panel-migrator
- **Description**: 1Panel V1 至 V2 的版本迁移工具
- **Primary Language**: Go
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 0
- **Created**: 2025-05-29
- **Last Updated**: 2025-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## ⚠️ 使用前须知

**1panel-migrator** 是官方提供的迁移工具，用于将 **1Panel V1** 平滑升级至 **1Panel V2**。

为确保迁移顺利、安全，请务必在执行前仔细阅读以下内容：

---

### 建议提前创建快照

为防止意外风险，强烈建议：

- 登录 **1Panel 控制台 → 面板设置** 页面，手动创建系统快照；
- 或通过云服务商平台创建云主机快照。

### V1 版本要求

仅支持 **1Panel `v1.10.29-lts` 及以上版本** 执行迁移操作。

### 迁移后的 V2 版本

执行迁移后，系统将升级至 **1Panel v2.0.0 版本**

### 专业版与许可证

- 原有许可证将被清除，统一迁移为 **社区版本**；
- V1 的买断许可证无法在 V2 中使用，但可前往 [凌霞官网](https://www.lxware.cn/) 进行升级；
- 许可证导入 V2 前，请先前往 [凌霞官网](https://www.lxware.cn/) 确认是否已成功解绑。

### 网站

#### 网站主目录迁移

迁移完成后，**所有网站配置将存放于 `{1Panel 安装目录}/www`**

> 例如：`/opt/1panel/www`

#### OpenResty 版本

系统将自动升级至 **OpenResty `1.27.1.2-0-1-focal`**

#### OpenResty 主配置文件

由于 `1panel-migrator upgrade website` 会重置 OpenResty 主配置文件，如有自定义修改，请提前备份。

#### PHP 运行环境网站

- 面板内置的 PHP 环境将被移除；
- **已创建网站中的 PHP 容器不会删除**，将被迁移至 静态网站；
- 后续可创建 V2 版本的 PHP 运行环境，在原网站设置中将迁移的静态网站切换为 PHP 网站。

#### 反向代理网站

由于 V2 重构了反代缓存机制，改为每个网站使用独立目录，因此在执行 `1panel-migrator upgrade website` 前，请确认所有网站的反代缓存已关闭。

### 备份记录

出于兼容性考虑：

- 所有 **V1 的网站、应用和数据库备份记录将被清空**；
- 请在迁移完成后重新配置备份策略。

### 主机终端

主机列表、分组和快速命令仅在升级为主节点时迁移；若升级为从节点，这部分数据将不会迁移。

### 计划任务

- **计划任务本身会迁移**；
- **任务的执行记录不会保留**。

### 快照

由于版本机制差异，**V1 的快照记录无法迁移至 V2**。

### 面板设置

升级完成后，所有节点的面板设置将以当前 V2 主节点的配置为准。

### WAF 和网站监控

由于架构升级：

- **V1 的 WAF 配置与网站监控记录大部分不兼容**，不会被迁移；
- WAF 仅保留：黑白名单、IP组、自定义规则；
- 迁移后请重新配置相关功能。

### 问题反馈

如果您在使用过程中遇到任何问题或有其他反馈，请在 [1Panel 主仓库](https://github.com/1Panel-dev/1Panel/issues) 提交 Issue。

## 📚 使用文档

### 安装说明

- [安装说明](install.md)

指导如何下载和安装 `1panel-migrator` 工具。

### 升级说明

- [升级说明](upgrade.md)

详细介绍如何将 1Panel 从 V1 升级至 V2，包括主节点和从节点的升级步骤。

### 回滚说明

- [回滚说明](rollback.md)

说明在升级失败或需要恢复时，如何执行服务和网站的回滚操作。