Docker Compose整套业务备份与隔离恢复

适用:Linux上的Docker Engine与Compose v2,业务数据保存在本机数据卷或绑定目录,允许安排一次维护停机。本文采用停机后复制完整数据的方法。外部数据库、对象存储和其他服务器上的文件要另外备份;如果重要数据仍写在容器可写层,先处理持久化,再按本文操作。

一、先列出需要带走的东西

一份完整备份应包含Compose配置、环境文件、挂载的配置或密钥、全部业务数据,以及实际运行的镜像版本。只保存镜像不能保存数据卷。

  1. 进入该项目目录,沿用原来的-p项目名、-f配置文件和环境文件参数。不要临时换一个项目名后执行停机。
  2. 执行下面的只读命令,记录每个容器的挂载来源。将mysite和实际容器名替换成自己的值。
docker compose -p mysite ps -a
docker compose -p mysite config --images
docker inspect 实际容器名 --format '{{json .Mounts}}'
docker inspect 实际容器名 --format '{{.Image}}'

逐项记录“容器内目录→实际数据卷名或主机目录→备份文件名”。同一个卷只备份一次,但数据库的数据、日志或外置表空间有多处挂载时不能漏掉。external卷也要核对是否被其他项目使用。

镜像标签可能指向新的内容,不能只记一个latest。保留实际镜像ID和可用的仓库摘要;自制镜像或无法保证日后还能取得的镜像,另用docker image save -o 镜像备份.tar 实际镜像ID保存。测试机用docker image load -i 镜像备份.tar导入,并让测试Compose使用对应镜像。

二、停写后备份数据

先准备一个本次专用的备份目录,例如/srv/backup/mysite-20261115-01,权限设为700,确认空间够用。把原Compose文件、.env及挂载配置复制进去。配置可能含密码,不能放在网站可下载的目录。

提前拉取用于打包的官方工具镜像,随后暂停入口、定时任务和所有会写入这套数据的程序。正常停止该项目,并查看数据库日志确认已完成关闭;如果被强制结束或仍有外部程序写入,不要把文件复制结果当成一致备份。

docker pull ubuntu:24.04
docker compose -p mysite stop -t 120
docker compose -p mysite ps -a
docker compose -p mysite logs --tail=80 db

db是示例数据库服务名。以下示例备份已核实存在的mysite_db_data卷;每个实际业务卷分别执行并使用不同文件名。

docker volume inspect mysite_db_data &&
docker run --rm --network none \
  --mount type=volume,src=mysite_db_data,dst=/source,readonly \
  --mount type=bind,src=/srv/backup/mysite-20261115-01,dst=/backup \
  ubuntu:24.04 \
  tar --numeric-owner --acls --xattrs -czpf /backup/db-data.tgz -C /source .

若是绑定目录,使用tar保存已核实的主机源目录;不要误打包容器里的同名路径。保留数字属主、权限及隐藏文件。备份过程中若出现读取变化、权限拒绝或非零退出码,先解决原因。完成后恢复原项目并检查业务,再把备份加密保存到另一台设备。

gzip -t /srv/backup/mysite-20261115-01/db-data.tgz
sha256sum /srv/backup/mysite-20261115-01/db-data.tgz
docker compose -p mysite start

三、先恢复到独立测试环境

使用相同架构、原镜像版本和数据库配置。先隔离正式数据库、邮件、支付及其他外部接口,测试配置只使用新目录、新卷和测试凭据。不要直接覆盖正在使用的正式卷。

将备份传到测试机并核对SHA256,创建一个确认不存在的新卷,再解压:

if docker volume inspect mysite_check_db >/dev/null 2>&1; then
  printf '%s\n' '目标卷已存在,停止恢复;请换一个未使用的新卷名。' >&2
else
  docker volume create mysite_check_db &&
  docker run --rm --network none \
    --mount type=volume,src=mysite_check_db,dst=/restore \
    --mount type=bind,src=/srv/backup/mysite-20261115-01,dst=/backup,readonly \
    ubuntu:24.04 \
    tar --numeric-owner --acls --xattrs -xzpf /backup/db-data.tgz -C /restore
fi

修改测试Compose文件,把原逻辑卷明确指向恢复后的新卷。下面的db_data必须与该文件中服务使用的逻辑卷名一致:

volumes:
  db_data:
    external: true
    name: mysite_check_db

其他数据卷、绑定目录和配置也逐项恢复。先执行docker compose -p mysite_check config -q检查配置,再启动测试项目。仅更换项目名不会自动隔离写死的目录、外部卷或外部接口。

四、怎样确认这份备份能用

检查数据库启动日志、代表性记录、用户登录、历史附件下载和一次测试写入;再正常重启测试项目,确认数据仍在。容器显示运行中只说明进程启动了。记录备份时间、数据范围、镜像版本和恢复结果后,这份备份才算有明确的可恢复证据。

相关教程:数据卷与目录挂载、SHA256校验、加密备份。