先说清楚:自建服务真正的资产是数据
容器删了可以重拉,镜像没了可以重下,Compose 文件可以重写——唯独数据丢了就是丢了。密码库、聊天记录、云盘文件、监控历史,这些才是自建服务真正的资产。备份不是可选项,而是自建服务从「玩具」变成「生产」的分界线。
这一篇给出一套对前面所有服务都通用的方法:先盘点每个服务的数据构成,再写一个通用打包脚本,配上数据库热备和异地加密备份,最后是换服务器时的完整迁移流程。单个数据库自身的备份命令细节,在数据库系列的 数据库备份与恢复全攻略 里有更深入的展开,这一篇侧重「多服务整体」的组织方法。
主线:盘点 → 打包脚本 → 数据库热备 → 异地备份 → 定时执行 → 迁移实战 → 恢复演练。
第一步:盘点每个服务的数据构成
任何一个 Docker 服务的数据都由四部分组成,备份时逐项对照,漏一项就可能恢复不完整:
| 构成 | 例子 | 备份方式 |
|---|---|---|
| 配置文件 | docker-compose.yml、.env、反代配置 | 直接打包 |
| 数据卷/绑定目录 | Cloudreve 数据、Vaultwarden 的 vw-data | 打包目录 |
| 数据库 | PostgreSQL、MySQL、MongoDB、SQLite 文件 | 逻辑导出或停机打包 |
| 密钥与证书 | rsa_key、JWT 密钥、证书私钥 | 随配置一起加密保存 |
特别提醒:只备份数据卷、不备份 Compose 和 .env,是最常见的翻车姿势——恢复时环境变量对不上,服务起来了也是一堆报错。把每个服务的整个项目目录(Compose + .env + 数据目录)当作一个整体来备份,就不会漏。
第二步:通用打包脚本
在服务器上建一个统一的备份脚本,把所有服务项目目录逐个打包到 /backup 并按日期命名:
#!/usr/bin/env bashset -euo pipefail
BACKUP_DIR="/backup/$(date +%F)"mkdir -p "$BACKUP_DIR"
# 需要备份的服务项目目录,一行一个PROJECTS=( "/root/apps/vaultwarden" "/root/apps/cloudreve" "/root/apps/rocketchat" "/root/apps/freshrss" "/root/apps/komari")
for p in "${PROJECTS[@]}"; do name=$(basename "$p") echo "==> backing up $name" tar --exclude='*/cache' --exclude='*/logs' \ -czf "$BACKUP_DIR/${name}.tar.gz" -C "$(dirname "$p")" "$name"done
echo "done: $BACKUP_DIR"注意脚本里排除了 cache 和 logs 这类可再生目录,能显著减小体积。但有个前提问题:正在运行的服务直接打包数据目录,可能把数据库文件拷到写入一半的状态。处理办法按数据库类型分:
| 类型 | 在线打包是否安全 | 推荐做法 |
|---|---|---|
| SQLite | 有风险 | 先用 .backup 命令热备出一致副本再打包 |
| PostgreSQL / MySQL | 不安全 | 用 pg_dump / mysqldump 逻辑导出 |
| MongoDB | 不安全 | mongodump,或短暂停机打包 |
| 纯文件(网盘、附件) | 基本安全 | 直接打包,个别文件不一致可接受 |
SQLite 热备示例(Vaultwarden、FreshRSS 都适用):
docker exec vaultwarden sqlite3 /data/db.sqlite3 ".backup /data/db-backup.sqlite3"关系型数据库则把导出命令加进备份脚本,产物和项目包放在一起:
docker exec postgres pg_dump -U postgres appdb > "$BACKUP_DIR/appdb.sql"docker exec mysql mysqldump -u root -p'密码' appdb > "$BACKUP_DIR/appdb.sql"如果服务能接受几分钟停机(比如深夜的个人服务),最省心的做法是备份前 docker compose stop、打包完再 up -d,一致性问题直接归零。个人自建服务大多能接受,优先选这个笨办法。
第三步:异地备份——本机留一份不算备份
备份只存在同一台 VPS 上,机器被回收、磁盘损坏、账号出问题时就一起没了。遵循经典的 3-2-1 原则:至少 3 份副本、2 种介质、1 份异地。对个人自建服务,落地版本是:服务器本地一份 + 加密后传到对象存储或另一台机器一份。
推荐用 restic 做异地备份:自带加密、增量、去重,恢复也简单:
# 初始化仓库(以 S3 兼容对象存储为例)export AWS_ACCESS_KEY_ID="你的KEY"export AWS_SECRET_ACCESS_KEY="你的SECRET"export RESTIC_PASSWORD="仓库密码,务必另行保存"restic -r s3:s3.amazonaws.com/你的桶名 init
# 执行备份restic -r s3:s3.amazonaws.com/你的桶名 backup /backup
# 查看与恢复restic -r s3:s3.amazonaws.com/你的桶名 snapshotsrestic -r s3:s3.amazonaws.com/你的桶名 restore latest --target /restoreWARNINGrestic 的仓库密码丢了,备份就等于一堆乱码,谁也解不开——这正是它安全的原理。RESTIC_PASSWORD 必须记在密码库里并另有一份离线记录,不要只存在服务器的环境变量里,服务器没了它也跟着没了。
没有对象存储也可以用 rclone 传到网盘、或用 rsync 推到另一台 VPS,关键是「异地」和「自动」两条要占住。
第四步:定时执行与保留策略
把打包脚本挂到 cron,每天凌晨跑,成功失败都写日志:
30 3 * * * /root/scripts/backup.sh >> /var/log/backup.log 2>&1保留策略建议:本地保留最近 7 天、异地保留最近 30 天,更老的自动清掉,避免磁盘被备份撑爆:
find /backup -maxdepth 1 -type d -mtime +7 -name "20*" -exec rm -rf {} +restic forget --keep-daily 30 --prune再进一步,把备份任务的成败纳入监控告警:脚本结尾按退出码发一条通知,连续失败必须有人知道。通知通道的搭法见 监控告警实战:通知、值班与故障处理流程——静默失败是备份系统最危险的故障模式,跑了三个月才发现脚本一直在报错的惨剧非常常见。
第五步:迁移实战——换服务器的完整流程
迁移和「从备份恢复」本质是同一件事,所以流程直接复用备份体系:
| 步骤 | 动作 | 要点 |
|---|---|---|
| 1 | 旧机停服务并做最后一次全量备份 | 选业务低峰期 |
| 2 | 备份传到新机 | restic restore 或直接 scp |
| 3 | 新机装 Docker、解开项目目录 | 版本尽量与旧机一致 |
| 4 | 逐个 docker compose up -d 并看日志 | 先起数据库类,再起应用 |
| 5 | 用 hosts 或内网地址逐个验证 | 别急着改 DNS |
| 6 | 改 DNS 解析到新机 IP | 提前把 TTL 调小到 300 |
| 7 | 观察 24 小时,旧机保留一周再销毁 | 出问题随时切回 |
几个迁移专属的坑:
- 数据库大版本不能降级:新机如果装了更低版本的数据库镜像,旧数据可能起不来。迁移时镜像 tag 先与旧机对齐,升级是另一件事,分开做。
- 文件属主变了:打包解包跨机器时注意属主,容器内服务用非 root 用户跑的(如 www-data),解包后属主不对会报权限错,按容器要求 chown 回来。
- 证书不用搬:反代的 HTTPS 证书在新机上重新申请即可,Nginx Proxy Manager 的配置本身在它的数据库里,如果 NPM 也在迁移名单里,记得它自己的数据目录也要备份,见 Nginx Proxy Manager:所有自建服务的统一入口。
各服务的备份要点速查
把本系列部署过的服务逐个过一遍,备份时各自的注意事项不同:
| 服务 | 核心数据 | 备份注意 |
|---|---|---|
| Nginx Proxy Manager | NPM 的数据库与证书目录 | 丢了等于全部站点代理配置重配,优先级高 |
| Komari | 探针服务端数据库 | 历史监控数据可丢,配置和节点列表别丢 |
| Uptime Kuma | data 目录(SQLite) | 停机打包最稳,监控项重建很费时 |
| Cloudreve | 数据库 + 存储目录 | 文件本体可能很大,考虑增量同步而非整包 |
| Vaultwarden | vw-data 整个目录 | 含 rsa_key,丢了密钥等于丢了库 |
| Rocket.Chat | MongoDB + uploads 卷 | 数据库用 mongodump,附件单独打包 |
| Jellyfin | 配置与媒体库元数据 | 媒体本体一般单独用同步/快照保护 |
| FreshRSS | data 目录 | SQLite 热备后打包即可 |
两个通用提醒:其一,备份前先给服务列一张「恢复顺序表」——数据库和反代是其他服务的前置依赖,恢复时先起它们;其二,备份文件本身也要有校验,sha256sum 生成校验和存好,异地传输后比对一次,避免传回来一个损坏的包还浑然不知:
cd /backup/2026-11-15sha256sum *.tar.gz > SHA256SUMSsha256sum -c SHA256SUMS # 恢复前先验一遍恢复演练:没验证过的备份不算备份
每季度至少做一次演练:随便挑一个服务(比如 FreshRSS),用上周的备份在一个临时目录里完整恢复出来,打开页面确认数据在、能登录。演练中发现的问题——缺文件、密码对不上、版本不兼容——在真正的灾难里只会更难处理。把演练步骤和结果简单记成文档,下次照着做就行。
常见问题与排障
1. 备份包越来越大
先查是不是把日志、缓存、转码临时文件打进去了,用 --exclude 排除;再查数据库类服务是否忘了做日志轮转。du -sh 逐层定位大头。
2. 定时备份没执行 查 cron 服务是否在运行、脚本是否有执行权限、日志里报了什么。最常见的是脚本用了相对路径或依赖交互式环境变量,cron 环境里都没有——路径全写绝对路径,密钥写进脚本或单独的 env 文件。
3. 恢复后服务起不来,日志报数据库连接失败
先确认 .env 里的数据库地址、密码和恢复的数据是不是同一套;再确认数据库容器先于应用完全就绪,应用连不上时加 depends_on 也没用,要看日志等数据库打印 ready 再重启应用。
4. restic 提示仓库被锁
上次备份异常中断留下了锁,确认没有正在运行的 restic 进程后执行 restic unlock 再重跑。
小结
备份这件事没有技术难点,难在成体系和坚持:盘点不漏项、脚本全自动、异地有一份、失败有告警、恢复练过手。做到这五条,你的全部自建服务就从「坏了会心疼」变成「坏了能重来」。迁移也不要怕,它就是一次计划内的恢复演练而已。