2588 字
13 分钟
自建服务备份与迁移实战
2026-11-15

先说清楚:自建服务真正的资产是数据#

容器删了可以重拉,镜像没了可以重下,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 bash
set -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 都适用):

Terminal window
docker exec vaultwarden sqlite3 /data/db.sqlite3 ".backup /data/db-backup.sqlite3"

关系型数据库则把导出命令加进备份脚本,产物和项目包放在一起:

Terminal window
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 做异地备份:自带加密、增量、去重,恢复也简单:

Terminal window
# 初始化仓库(以 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/你的桶名 snapshots
restic -r s3:s3.amazonaws.com/你的桶名 restore latest --target /restore
WARNING

restic 的仓库密码丢了,备份就等于一堆乱码,谁也解不开——这正是它安全的原理。RESTIC_PASSWORD 必须记在密码库里并另有一份离线记录,不要只存在服务器的环境变量里,服务器没了它也跟着没了。

没有对象存储也可以用 rclone 传到网盘、或用 rsync 推到另一台 VPS,关键是「异地」和「自动」两条要占住。

第四步:定时执行与保留策略#

把打包脚本挂到 cron,每天凌晨跑,成功失败都写日志:

30 3 * * * /root/scripts/backup.sh >> /var/log/backup.log 2>&1

保留策略建议:本地保留最近 7 天、异地保留最近 30 天,更老的自动清掉,避免磁盘被备份撑爆:

Terminal window
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 ManagerNPM 的数据库与证书目录丢了等于全部站点代理配置重配,优先级高
Komari探针服务端数据库历史监控数据可丢,配置和节点列表别丢
Uptime Kumadata 目录(SQLite)停机打包最稳,监控项重建很费时
Cloudreve数据库 + 存储目录文件本体可能很大,考虑增量同步而非整包
Vaultwardenvw-data 整个目录含 rsa_key,丢了密钥等于丢了库
Rocket.ChatMongoDB + uploads 卷数据库用 mongodump,附件单独打包
Jellyfin配置与媒体库元数据媒体本体一般单独用同步/快照保护
FreshRSSdata 目录SQLite 热备后打包即可

两个通用提醒:其一,备份前先给服务列一张「恢复顺序表」——数据库和反代是其他服务的前置依赖,恢复时先起它们;其二,备份文件本身也要有校验,sha256sum 生成校验和存好,异地传输后比对一次,避免传回来一个损坏的包还浑然不知:

Terminal window
cd /backup/2026-11-15
sha256sum *.tar.gz > SHA256SUMS
sha256sum -c SHA256SUMS # 恢复前先验一遍

恢复演练:没验证过的备份不算备份#

每季度至少做一次演练:随便挑一个服务(比如 FreshRSS),用上周的备份在一个临时目录里完整恢复出来,打开页面确认数据在、能登录。演练中发现的问题——缺文件、密码对不上、版本不兼容——在真正的灾难里只会更难处理。把演练步骤和结果简单记成文档,下次照着做就行。

常见问题与排障#

1. 备份包越来越大 先查是不是把日志、缓存、转码临时文件打进去了,用 --exclude 排除;再查数据库类服务是否忘了做日志轮转。du -sh 逐层定位大头。

2. 定时备份没执行 查 cron 服务是否在运行、脚本是否有执行权限、日志里报了什么。最常见的是脚本用了相对路径或依赖交互式环境变量,cron 环境里都没有——路径全写绝对路径,密钥写进脚本或单独的 env 文件。

3. 恢复后服务起不来,日志报数据库连接失败 先确认 .env 里的数据库地址、密码和恢复的数据是不是同一套;再确认数据库容器先于应用完全就绪,应用连不上时加 depends_on 也没用,要看日志等数据库打印 ready 再重启应用。

4. restic 提示仓库被锁 上次备份异常中断留下了锁,确认没有正在运行的 restic 进程后执行 restic unlock 再重跑。

小结#

备份这件事没有技术难点,难在成体系和坚持:盘点不漏项、脚本全自动、异地有一份、失败有告警、恢复练过手。做到这五条,你的全部自建服务就从「坏了会心疼」变成「坏了能重来」。迁移也不要怕,它就是一次计划内的恢复演练而已。

自建服务备份与迁移实战
https://www.anexns.cloudns.org/posts/selfhost-backup-migration/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0