3.4 升级、迁移与卸载：面板最容易翻车的三个动作

一句话判断：面板的“日常使用”很少出事，出事的几乎都是这三个时刻——升级、换机器、说再见。两边的救援机制都给了，但“救援通道”的画风很不一样：宝塔是一抽屉的 bt 编号工具（bt 5 / bt 16 / bt 18……），1Panel 是快照 + 迁移器两条主线。

升级：点一下容易，翻车了怎么救

1Panel 的升级：官方安装文档写得很简单——登录 Web 控制台，在页面右下角点【检查更新】即可在线升级。社区版、专业版走同一条通道。

宝塔的升级：命令行 bt 34 更新面板到最新版本；也可以在面板界面里操作。两条路都官方提供。

看起来是打平？真正有意思的是两边官方都为“升级翻车”预备了什么样的故障手册——这恰恰反映了各家用户实际踩过的坑。

宝塔侧的救援工具箱（来源：宝塔官方 FAQ 与命令行文档）：官方 FAQ 专门有一篇《宝塔面板升级后无法登录》，给出的脱离步骤是：

bt 5     # 修改面板密码后重试登录
bt 16    # 仍无法登录？执行面板修复（安装当前版本的最新 bug 修复包）

还有更狠的一例：官方 FAQ《面板网站、数据库不显示》记录了一个真实故障模式——面板升级/异常后，网站列表和数据库列表空了，但网站本身还能正常访问。原因是存网站、数据库列表的两个 SQLite 文件（/www/server/panel/data/db 下的 site.db、database.db）被清空或损坏。官方给的恢复办法：从 /www/backup/panel 的自动备份压缩包里解出这两个文件覆盖回去，然后 bt restart；没有备份且站点少时，可以手动重建网站 + 用“同步数据库”捞回记录。官方还在末尾强调一句：不建议关闭面板自动备份（bt 18 可管理开关）。

1Panel 侧的救援逻辑：没有一抽屉编号命令，但官方有更“重”的事前保险——快照。官方功能说明：快照用于全量备份 1Panel 所产生的数据，包括 Docker 配置文件（/etc/docker/daemon.json）、应用商店应用、本地备份数据、1panel 二进制、1pctl 工具和 1panel.service。恢复快照时，系统会先把恢复前的数据备份到 [安装目录]/original_[快照名]；恢复失败可查“日志审计 → 系统日志”，或回滚到恢复之前。

公允点评：宝塔的 bt 工具箱更贴近“现场急救”，面板打不开了 SSH 上去敲两下就活；1Panel 的快照更贴近“灾备”，前提是你真的创建过快照。两者都不是免费的——宝塔的自动备份要硬盘空间（好在其压缩包按天滚），1Panel 的快照官方说明“创建和同步只支持选择第三方账号”。记住一句话：所有灾备工具，只有在灾难发生前用过，才叫灾备。

大版本迁移：1Panel V1 → V2 的官方答卷

这是本书最有料的一个官方案例。1Panel 官方明确：V2 架构变动大，不支持从 V1 直接在线升级，需要用官方的 1panel-migrator 迁移工具平滑升级。为什么单拎这个？因为它把“升级的阵痛成本”写得极为坦诚，是全书少见的官方自揭细节：

迁移操作本身分两步走：主节点先 1panel-migrator upgrade core（升服务）再 upgrade website（升网站）；从节点先 upgrade agent 再去主节点“节点管理”里添加，最后在从节点上执行网站升级。回滚也给了双段命令：1panel-migrator rollback service 回服务、rollback website 回网站。官方并强烈建议迁移前先在控制台手动创建系统快照或云主机快照。

对比看宝塔的升级——宝塔没有公开的同量级“大版本断裂”文档（至少在本书引用的官方文档范围内未见），社区共识是宝塔的大版本兼容做得比较克制（也可能只是历史包袱在两边表现不同，此处不作价值判断）。

这个案例给普通用户什么启示？ 三条：

1. “开源项目大版本重构”是真实风险，选型时把“我用的版本未来怎么升级”问一句；
2. 官方给工具、给回滚、给清单——这是一家开源厂商应对断裂式升级的标准动作，值得拿着清单逐条核；
3. 迁移前必做快照，官方文档的原话是“强烈建议”。

跨服务器迁移：整机迁站怎么搬

宝塔的官方方案：整机迁移功能。 来源：宝塔官方设置文档《整机迁移》。要点：

此外官方 FAQ 里还常被提到的“快速迁移网站”方案（如腾讯云轻量场景的迁移工具），那属于云厂商联手提供的轻量迁站路径。

1Panel 的官方方案：快照 + 备份。 1Panel 没有在官方文档里提供一个等价的“图形化整机迁移”按钮，它的迁移思路是面向备份的：

• 面板设置中的“备份账号”支持本地磁盘与一长串第三方对象存储（S3 兼容体系），计划任务、应用、网站、数据库和系统快照的备份都可以存进去；
• 快照恢复时会把恢复前数据备份一份（original_[快照名]），恢复失败可回滚；
• 对机器迁移场景，官方快照说明里专门写过一句：“如机器迁移等，需要将快照放到备份账号对应的指定目录下”（如服务器磁盘 /opt/1panel/backup/system_snapshot/）——也就是“把快照文件拷到新机器的规定目录，再执行恢复”。

直说差异：宝塔的整机迁移是为“搬家”这种场景量身定做的——一个向导、一个进度条、一句提示语；1Panel 把“搬家”拆成了“备份 → 恢复”的通用能力，更灵活、更 DevOps，但对伸手党没那么友好。谁适合谁，取决于你是想点一个按钮，还是想拥有一套可复制的备份恢复流程。

卸载：体面的告别

这一段与 03-2 节呼应，这里只补“工具入口”层面的信息：

双方都给了入口，但一个细节值得回味：1Panel 的卸载是它内置命令行（1pctl）的一等公民（和 start/stop/restart 并列）；宝塔的卸载被放在“新手入门”的说明性文字里做澄清（主要是回应用户“装了会不会赖着不走”的常见担心）。两个入口的位置，本身就是两种产品观的体现。

本节要点

• 升级：两者都有正式通道（1Panel 控制台【检查更新】、宝塔 bt 34），救援画风不同——宝塔靠 bt 工具箱现场急救（bt 5/bt 16/bt 18），1Panel 靠快照灾备回滚。
• 1Panel V1→V2 不能在线升级，官方给出迁移器 + 完整数据兼容清单 + 双段回滚，是研究“大版本断裂治理”的好样本；迁移前务必做快照。
• 跨服务器迁移：宝塔整机迁移是成熟的图形化向导（目标机 512MB+、需覆盖数据）；1Panel 用快照/备份体系实现，灵活但步骤化。
• 卸载入口两边都有，残留问题属宝塔长期社区话题（社区共识），结论以自己机器实测为准。

延伸阅读： 1Panel 快照与备份账号的官方操作步骤，见 《1Panel 官方文档：功能手册》；宝塔的备份与迁移向导，可参考 《宝塔面板运维与安全实战》。

下一步： 无论你选谁，今天就建第一条灾备——宝塔面板里开 bt 18 自动备份，或 1Panel 控制台设好备份账号并拍一张系统快照。备份这事，永远在做的前一天最值钱。备份就绪后，我们看最后一道环境考验：没外网、没公网 IP、还得过安全组，谁还能活（03-5 节）。