Kuma SQLite 备份坑

姜鱼问生2026-10-22 10:38

Kuma 备份变砖？踩坑 SQLite 的 WAL 模式，你的热备可能是假的

背景

服务器每天定时备份。cp 一下 Kuma 的 kuma.db。某天模拟恢复。起容器，Kuma 打不开。数据库损坏 database disk image is malformed。监控历史全丢。

原因

小学生版：Kuma 用 SQLite。开启 WAL (Write-Ahead Logging) 模式。数据写到一半，先进 kuma.db-wal。直接 cp kuma.db，没带上 -wal 和 -shm 文件。相当于抄作业只抄了封面。

解决

必须用 SQLite 官方备份命令，或者使用 Docker 卷停服备份。

不用停服的做法：

bash 复制代码

# 使用 sqlite3 命令行工具在线热备（不锁表）
sudo docker exec monitor sqlite3 /app/data/kuma.db ".backup '/app/data/kuma_backup.db'"
# 再拷出来
sudo docker cp monitor:/app/data/kuma_backup.db /home/user/backups/kuma_backup_$(date +%Y%m%d).db

验证效果

用 file 命令查备份文件。

file kuma_backup_20261021.db

如果显示 SQLite 3.x database，不是 empty。成功。

三个坑

忘记清理临时文件：.backup 会在容器里生成新文件，记得在容器内 rm，否则容器磁盘爆满。

直接备份 Volume：如果停服时间允许，用 docker compose stop monitor，备份整个 /app/data 目录，再 start。