数据与备份 — ProbeDeck 文档

数据全部在一个目录里（默认 /opt/probedeck/data），备份就是复制它。

目录里有什么

文件	是什么
`monitor.db`	SQLite 主库，服务器配置、历史、设置、密码
`monitor.db-wal` / `-shm`	WAL 模式的日志与共享内存
`api_secret.txt`	首次启动生成的密钥
`do-storage.json`	Durable Object 兼容层的落盘状态
`geoip/`	GeoLite2 数据库（如果用了 maxmind）

备份不要直接 cp monitor.db。WAL 模式下最新数据可能还在 -wal 里，直接复制会得到一个不完整、甚至损坏的快照。

备份

宿主机需要 sqlite3（apt install -y sqlite3）：

# ① 先把 .db 和 -wal 一起复制出来
docker cp probedeck:/app/data/monitor.db    /tmp/monitor.db
docker cp probedeck:/app/data/monitor.db-wal /tmp/monitor.db-wal
 
# ② 用 .backup 合并成一致快照（这一步才是真正的备份）
sqlite3 /tmp/monitor.db ".backup '/tmp/backup.db'"
 
# ③ 清理临时文件
rm -f /tmp/monitor.db /tmp/monitor.db-wal

bash

定时备份

每天一次保留最近 7 份：

7 4 * * * /path/to/backup.sh && ls -t /backup/probedeck/*.db | tail -n +8 | xargs -r rm --

bash

恢复

docker stop probedeck
rm -f /opt/probedeck/data/monitor.db*
cp /backup/backup.db /opt/probedeck/data/monitor.db
docker start probedeck

bash

迁移到另一台 VPS

停掉旧面板 → 复制整个数据目录 → 新机器起容器挂载同一目录即可。API_SECRET 一起带过去，已有探针无需重新配置。

保留天数

HISTORY_RETENTION_DAYS=14      # 默认 14，可选 7 / 14 / 30 / 60 / 90 / 180 / 365

bash

也可以在面板里改（面板设置优先于环境变量）。配合每小时一次的表轮换，文件大小到达窗口后就稳定了，不会一直涨。