试迁移会原地修改数据库。回到旧环境依赖升级前已经验证可恢复的备份,单独换回旧程序无法撤销数据库迁移。

数据库为什么不能直接降级
Uptime Kuma 3.0.0-beta.1 是预发行版本。它的发布页指向官方 2.x 到 3.x 迁移指南。试迁移时,新版本会直接升级旧数据库。这一变化发生在数据本身,单独换回旧镜像或程序不会撤销已经执行的迁移。

迁移前备份覆盖哪些数据
迁移指南把停机列为数据库备份的前提。备份范围是整个 data 目录,包含 kuma.db 和 db-config.json,并要求事先验证备份确实能够恢复。可用的回退点是升级前的备份。仅有升级后的数据库,无法按旧格式直接降级。
采集与认证有哪些变化
如果现有部署依赖 Prometheus,迁移后的测试还涉及 /metrics,该端点默认关闭。认证也迁移到 Better Auth,现有第三方集成的认证兼容性需要单独评估。普通登录和外部客户端连通属于不同的检查范围。
非容器部署的运行条件
直接在宿主机运行的非容器部署要求 Node.js 26.2.0 或更新的版本。官方指南还说明,旧的直接运行服务端脚本的方式不能照搬到 3.x。预发行测试的范围包括数据库能否恢复、监控能否继续执行,以及现有采集与认证集成是否兼容。










