Uptime-Kuma 从 v1 到 v2 版本升级实战记录
Uptime-Kuma 从 v1 到 v2 版本升级实战记录
介绍
Uptime Kuma 是一款开源、易于使用的自托管监控工具,常被视为 Uptime Robot 等商业监控服务的免费替代方案。它提供一个直观的 Web 界面,让用户可以实时监控网站、API、服务器等各种网络服务的运行状态和可用性
背景与问题
我们一直在使用 Uptime-Kuma v1.23 版本进行服务监控,但近期频繁遇到服务不稳定的情况,日志中反复出现以下报错,导致部分监控项状态异常:
[DOWN] dev-aaa
Knex: Timeout acquiring a connection. The pool is probably full. Are you missing a .transacting(trx) call?
经过排查,该问题源于数据库连接池超时。在 GitHub 社区中,此问题已被广泛讨论(Issue #7289),但截至当前版本尚未得到彻底修复。为了解决这一稳定性问题,我们决定将 Uptime-Kuma 从 v1 升级至最新的 v2.5.0 版本。
升级前准备
由于之前的部署方式使用的是默认配置,未将数据目录挂载到宿主机,因此在升级前必须先进行数据备份,以防升级过程中出现数据丢失。
数据备份操作:
# 将容器内的数据目录拷贝到本地
docker cp uptime-kuma:/app/data .
升级操作步骤
备份完成后,我们停止旧的 v1 容器,并使用新的 Docker 命令启动 v2 版本。关键步骤是确保将备份的数据目录挂载到新容器中,以便触发自动数据迁移。
启动 Uptime-Kuma v2:
# 使用 v2 镜像启动新容器,并挂载之前备份的数据卷
docker run -d --restart=always -p 3001:3001 \
-v /usr/local/uptime1/data:/app/data \
--name uptime-kuma2 \
louislam/uptime-kuma:2
数据迁移过程
容器启动后,系统会自动检测到旧版本数据并开始迁移流程。此过程可能需要一些时间,具体取决于监控数据的体量。
1. 查看迁移状态
可以通过查看容器日志或访问特定的迁移状态页面来监控进度:
2. 迁移日志示例
日志显示系统正在逐条迁移监控数据,并清理非关键的心跳记录:
[DB] INFO: [DON'T STOP] Migrating monitor 230s' (209 of 209 total) data - 2026-08-14 - total migration progress 99.95%
[DB] INFO: Clearing non-important heartbeats
[DB] INFO: Deleting non-important heartbeats for monitor 1
...
[DB] INFO: Deleting non-important heartbeats for monitor 230
[DB] INFO: Aggregate Table Migration Completed
3. 迁移完成
当看到 Finished, please refresh this page 提示时,表示迁移已完成。随后服务会自动重启并监听端口:
[SERVER] INFO: Listening on:
[SERVER] INFO: - http://localhost:3001
[SERVER] INFO: - http://172.17.0.4:3001
升级结果
目前服务已成功升级至 v2.5.0 版本,之前的 Knex Timeout 报错不再出现,系统运行平稳。我们将继续观察一段时间,以确保长期稳定性。

文档信息
- 文章作者: 运维技术团队 - 辣个男人Devin
- 发布日期: 2026-08-14
- 适用平台: ubuntu
- 参考连接:
- https://github.com/louislam/uptime-kuma/issues/7289
- https://github.com/louislam/uptime-kuma
如果本文对你有帮助,欢迎点赞、在看、转发,让更多开发、运维同学们看到!
