4
0
0

Uptime-Kuma 从 v1 到 v2 版本升级实战记录

2026-08-14
2026-08-14
文章摘要
|

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 报错不再出现,系统运行平稳。我们将继续观察一段时间,以确保长期稳定性。
image

文档信息


如果本文对你有帮助,欢迎点赞、在看、转发,让更多开发、运维同学们看到!

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

Uptime-Kuma 从 v1 到 v2 版本升级实战记录
/archives/uptime-kuma-cong-v1-dao-v2-ban-ben-sheng-ji-shi-zhan-ji-lu
Author
Administrator
Published at
2026-08-14

欢迎来到我的博客!