升级说明
升级须知
由于 V2 版本较 V1 版本有比较大的架构变动，目前不支持从 V1 版本直接在线升级至 V2 版本。
1Panel V1 版本的用户，可以使用官方提供的迁移工具 1panel-migrator，将 1Panel V1 平滑升级至 1Panel V2。
注意
为确保迁移顺利、安全，请务必在执行前仔细阅读以下内容。
建议提前创建快照⚓︎
为防止意外风险，强烈建议：
- 登录 1Panel 控制台 → 面板设置 页面，手动创建系统快照；
- 或通过云服务商平台创建云主机快照。
V1 版本要求⚓︎
仅支持 1Panel v1.10.29-lts 及以上版本 执行迁移操作。
迁移后的 V2 版本⚓︎
执行迁移后，系统将升级至 1Panel v2.0.0 版本
专业版与许可证⚓︎
网站⚓︎
网站主目录迁移⚓︎
迁移完成后，所有网站配置将存放于 {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 主仓库 提交 Issue。