背景uptime-kuma 当初是用 docker run 手起的命令大概长这样docker run -d --restartalways \ -p 3001:3001 \ -v uptime-kuma:/app/data \ --name uptime-kuma \ louislam/uptime-kuma:1问题不在 compose 里服务器重启后要手动管配置改动没有版本记录端口暴露公网。想迁移到 compose但数据不能丢里面有告警规则、监控目标、历史记录。原因关键概念Docker 卷是独立的。docker run 时创建的卷叫 uptime-kuma如果直接用 compose 定义同名卷compose 会自动加项目前缀变成 xxx_uptime-kuma新卷新容器读新卷看不到老数据正确做法在 compose 里声明 external: true告诉 compose用现有的卷别新建。解决第一步备份数据保命mkdir -p ~/backups/uptime-kuma docker run --rm \ -v uptime-kuma:/data \ -v /home/YOUR_USER/backups/uptime-kuma:/backup \ alpine \ tar czf /backup/uptime-kuma-$(date %F).tar.gz -C /data . # 验证备份里有 kuma.db tar tzf ~/backups/uptime-kuma/*.tar.gz | grep kuma.db看到 kuma.db 才算备份成功。第二步写 compose 文件services: uptime-kuma: image: louislam/uptime-kuma:1 container_name: uptime-kuma restart: always ports: - 127.0.0.1:3001:3001 # 撤下公网 volumes: - uptime-kuma:/app/data environment: - TZAsia/Shanghai mem_limit: 256m logging: driver: json-file options: max-size: 10m max-file: 3 volumes: uptime-kuma: external: true # 关键用现有卷不新建external: true 是这一篇的核心。第三步验证 compose 解析结果dockercompose config|grep-A2volumes:volumes: uptime-kuma: name: uptime-kuma ← 必须是 uptime-kuma如果看到 name: uptime-kuma_uptime-kuma → 停下external: true 没生效会新建卷、丢数据。第四步迁移1 分钟窗口# 停 删旧容器不加 -vdockerstop uptime-kumadockerrmuptime-kuma# 确认卷还在dockervolumels|grepuptimedockervolume inspect uptime-kuma|grepMountpoint# 用 compose 起新容器cd/home/YOUR_USER/uptime-kumadockercompose up-d⚠️ docker rm 千万不要加 -v——加了会连卷一起删。第五步验证数据完整dockerlogs uptime-kuma21|grep-EConnected|Listening|tail-5[SERVER] INFO: Connected [SERVER] INFO: Listening on 3001Connected 成功读到老数据。浏览器登进去监控目标、通知配置、历史记录都在。三个坑坑 1忘了 external: truecompose 默认会给卷加项目前缀。docker run 建的 uptime-kuma 卷到 compose 里会变成 项目名_uptime-kuma——新卷、空的、数据全丢。坑 2docker rm 加了 -vdocker rm uptime-kuma 删容器卷保留。docker rm -v uptime-kuma 删容器 删卷——数据全没。迁移时永远不加 -v。坑 3迁移前后没验证 kuma.db迁移前 tar 备份里要有 kuma.db迁移后容器日志里要有 Connected。前后两头都验证才能保证数据没丢。外加推荐一部电影挽救计划昨天看完的个人感觉——好看