标签搜索

Docker Compose 数据怎么备份?Volumes、数据库与容器迁移恢复教程

微芒网
2026-11-17 / 1 - 阅读

Docker Compose 备份流程示意

使用 Docker Compose 部署网站、数据库、NAS 应用或 AI 工具后,很多人会遇到一个问题:容器可以重新创建,但里面的数据怎么办?

例如:

  • MySQL 数据库保存了网站文章和用户信息。
  • Redis 保存了业务缓存或队列数据。
  • 应用 Volume 保存了上传文件。
  • 配置文件保存了数据库连接、账号和服务参数。
  • 某些 NAS 应用将重要数据直接映射到宿主机目录。

如果只备份 Docker 镜像或容器,并不一定能够恢复这些数据。

真正可靠的 Docker 备份方案,需要同时考虑持久化数据、数据库一致性、应用配置和恢复验证。

本文以 Docker Compose 为例,介绍常见的数据存储方式、备份方法、恢复步骤和迁移注意事项。

一、Docker 容器、镜像和 Volume 有什么区别?

首先需要理解 Docker 的几个基本概念。

1. Docker 镜像

镜像包含应用运行所需要的程序和依赖。

例如,一个 MySQL 镜像可以用于创建数据库容器。

但镜像本身通常不包含后来写入数据库的数据。

2. Docker 容器

容器是镜像运行后的实例。

容器内部可以产生文件和运行状态,但容器可写层不适合作为重要数据的唯一存储位置。

如果容器被删除,未持久化的数据可能随之丢失。

3. Docker Volume

Volume 是 Docker 提供的持久化数据存储方式。

即使容器被删除,Volume 中的数据通常仍然保留,除非执行了会删除相关 Volume 的操作。

例如:

services:
  mysql:
    image: mysql:8.0
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

这里的 mysql_data 是一个命名 Volume,用来保存数据库数据。

4. Bind Mount

Bind Mount 是将宿主机上的指定目录映射到容器内部。

例如:

services:
  app:
    image: example/app
    volumes:
      - ./uploads:/app/uploads

这里的 uploads 文件实际保存在宿主机的项目目录中。

备份时需要注意:Volume 和 Bind Mount 的存储位置及备份方式并不相同。

二、Docker Compose 应该备份哪些内容?

一个完整的备份方案至少应包含以下内容:

内容 作用 是否建议备份
Compose 文件 记录服务配置 是
环境变量文件 保存应用配置 是,注意加密保护
Docker Volume 保存持久化数据 是
Bind Mount 目录 保存映射文件 是
数据库逻辑备份 保证数据库可恢复 是
自定义镜像信息 恢复应用环境 视情况
网络及端口配置 恢复服务连接 记录配置

特别提醒:

不要把 .env 文件、数据库密码和 API Key 直接放进公开备份仓库。

建议使用受访问控制的备份位置,并对敏感备份进行加密。

三、第一步:查看 Docker Compose 项目结构

在备份之前,先确定项目使用了哪些 Volume 和宿主机目录。

查看当前运行容器:

docker ps

查看所有 Volume:

docker volume ls

查看指定容器的挂载情况:

docker inspect 容器名称

查看 Compose 项目:

docker compose ps

查看服务配置:

docker compose config

注意:docker compose config 可能展开环境变量,输出中可能包含敏感信息,不要直接公开或上传未经处理的结果。

建议整理以下信息:

  • Compose 项目名称。
  • 服务名称。
  • 数据库类型和版本。
  • Volume 名称。
  • Bind Mount 路径。
  • 环境变量文件位置。
  • 外部网络和依赖服务。

不要在不了解实际挂载关系的情况下直接备份某个目录,并认为整个应用已经备份完成。

四、第二步:备份 Docker Compose 配置文件

首先备份 Compose 配置。

例如:

mkdir -p ./backup/config

cp compose.yaml ./backup/config/
cp .env ./backup/config/

如果使用的是 docker-compose.yml,则需要按实际文件名调整。

如果配置中还引用了其他文件,例如:

  • nginx.conf
  • application.yaml
  • 数据库初始化 SQL
  • 自定义脚本
  • 证书和密钥

也需要根据实际部署情况整理。

备份目录建议按日期组织:

backup/
├── 2026-11-17/
│   ├── config/
│   ├── database/
│   ├── volumes/
│   └── manifest.txt

注意:包含密码和密钥的文件应加密保存,不能直接上传到公开目录。

五、第三步:备份 Docker Named Volume

对于 Named Volume,可以使用临时容器挂载 Volume,再将其中的数据打包。

先查看 Volume 名称:

docker volume ls

假设 Volume 名称为:

myproject_mysql_data

可以使用下面的方式进行文件级备份:

docker run --rm \
  -v myproject_mysql_data:/source:ro \
  -v "$PWD/backup:/backup" \
  alpine \
  tar -czf /backup/mysql_data.tar.gz -C /source .

命令说明:

  • --rm:临时容器结束后自动清理。
  • -v myproject_mysql_data:/source:ro:只读挂载待备份 Volume。
  • -v "$PWD/backup:/backup":将备份目录映射到临时容器。
  • tar -czf:将数据压缩为归档文件。

这里的 :ro 可以减少备份容器意外修改源数据的风险。

但必须注意:

只读挂载并不等于数据库一致性备份。

如果数据库仍在运行,直接打包数据库底层数据目录可能得到不一致的文件集合。

对于 MySQL、PostgreSQL 等数据库,应优先采用数据库官方支持的备份方法,或者在确认数据库已经安全停止、数据文件处于一致状态后再进行文件级备份。

六、第四步:数据库应该怎样备份?

数据库备份和普通文件备份需要区别处理。

MySQL 逻辑备份示例

可以使用 mysqldump 导出数据库:

docker exec mysql \
  sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" --single-transaction --routines --triggers --databases your_database' \
  > backup/database.sql

上面是示意命令,实际使用前需要根据容器名称、数据库用户、环境变量和数据库引擎调整。

对于 InnoDB 等支持事务一致性快照的表,--single-transaction 可以在适用条件下提供一致性导出。

如果存在非事务表或其他并发写入情况,需要额外评估备份一致性。

另外:

  • 不要把数据库密码直接写入公开脚本。
  • 不要将真实密码放在命令行历史记录中。
  • 应确认备份文件非空。
  • 应检查数据库备份日志。
  • 应定期进行实际恢复测试。

PostgreSQL 逻辑备份示例

可以使用 pg_dump:

docker exec postgres \
  sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  > backup/database.dump

实际操作时需要核对 PostgreSQL 版本、认证方式、数据库权限和容器配置。

如果数据库中存在角色、权限等集群级对象,还需要考虑使用 pg_dumpall 等工具备份相应信息。

不同数据库不能套用同一套备份命令。

七、第五步:如何恢复 Docker Volume?

恢复之前,建议先在隔离环境创建一个新的测试 Volume。

例如:

docker volume create myproject_mysql_restore

然后将备份数据解压到新的 Volume:

docker run --rm \
  -v myproject_mysql_restore:/target \
  -v "$PWD/backup:/backup:ro" \
  alpine \
  sh -c 'tar -xzf /backup/mysql_data.tar.gz -C /target'

注意:

以上命令只适用于与备份方法、目录结构和应用版本兼容的数据。

如果备份来自正在运行的数据库且文件不一致,恢复后可能无法启动。

建议先使用数据库逻辑备份恢复到独立测试数据库,再检查:

  • 数据库能否正常启动。
  • 表数量是否一致。
  • 关键记录是否存在。
  • 应用是否能够正常连接。
  • 是否存在权限和版本兼容问题。

不要直接覆盖正在运行的生产 Volume。

八、第六步:如何将 Docker Compose 迁移到另一台服务器?

跨服务器迁移不仅要复制数据,还需要恢复运行环境。

建议按以下顺序操作:

第一步:整理原服务器的 Compose 文件和环境变量。

第二步:记录镜像名称、版本和架构。

第三步:备份数据库。

第四步:备份 Named Volume 和 Bind Mount 中的重要数据。

第五步:将备份文件安全传输到新服务器。

第六步:安装兼容版本的 Docker 和 Docker Compose。

第七步:创建目标 Volume 和目录。

第八步:恢复数据和配置。

第九步:启动测试环境。

第十步:检查服务状态、数据库和业务功能。

第十一步:确认数据完整性后,再安排正式切换。

特别注意:

如果旧服务器使用 ARM 架构,新服务器使用 x86 架构,某些镜像可能无法直接兼容。

另外,数据库主版本、应用版本、插件和环境变量也需要核对。

九、Docker Compose 备份时最危险的操作

以下命令尤其需要谨慎:

docker compose down -v

它会在停止和移除 Compose 项目容器、网络的同时,移除 Compose 文件声明的命名 Volume,以及关联的匿名 Volume。

如果重要数据库数据只保存在这些 Volume 中,就可能造成数据丢失。

另外:

docker volume prune

会清理未使用的 Volume。

不要把这些命令放入未经验证的自动化脚本中。

也不要为了备份而随意执行:

docker system prune -a --volumes

清理 Docker 环境与备份数据是两件不同的事情。

对于生产环境,任何删除操作都必须先确认数据位置、备份状态和恢复能力。

十、如何建立可靠的 Docker 备份策略?

可以采用 3-2-1 备份原则:

  • 至少保留 3 份数据副本。
  • 使用 2 种不同的存储介质。
  • 至少 1 份备份放在异地。

例如:

备份副本 保存位置 用途
原始数据 NAS 日常运行
第一份备份 外置硬盘 本地恢复
第二份备份 异地或云端 应对设备损坏

还建议设置:

  • 每日数据库备份。
  • 每周完整数据备份。
  • 重要配置文件变更后立即备份。
  • 定期检查备份文件完整性。
  • 定期执行恢复演练。

具体频率需要结合业务重要性、数据变化量和恢复时间目标决定。

备份成功不代表一定能恢复。只有经过恢复验证的备份,才真正具有可靠性。

十一、Docker 备份常见问题 FAQ

1. 删除 Docker 容器会丢失数据吗?

如果重要数据存储在 Named Volume 或 Bind Mount 中,通常不会因为删除容器而丢失。但存储在容器可写层的数据可能随容器删除而丢失。

2. Docker 镜像可以代替数据备份吗?

不可以。镜像主要保存程序环境,不能代替数据库、上传文件和业务配置的备份。

3. Docker Volume 可以直接复制到另一台服务器吗?

可以迁移,但需要考虑数据一致性、权限、目录结构和应用版本。

4. 数据库运行时能不能直接压缩 Volume?

不能简单认为这样就安全。数据库正在写入时,直接复制底层数据目录可能产生不一致备份。应优先使用数据库支持的备份工具。

5. NAS 上的 Docker 应用需要备份吗?

需要。NAS 硬盘故障、误操作、系统升级和应用配置变化都可能影响数据。建议将重要数据备份到独立设备或异地位置。

6. 如何确认 Docker 备份真正成功?

不要只检查文件是否存在。还需要验证文件大小、归档完整性,并在隔离环境执行恢复,检查数据库和应用能否正常工作。

总结

Docker Compose 数据备份不能只关注容器和镜像。

真正需要保护的是数据库、Named Volume、Bind Mount、配置文件和应用所依赖的环境。

对于数据库,优先使用对应数据库的官方备份工具;对于普通持久化文件,可以采用 Volume 或目录级备份。

跨服务器迁移时,要检查应用版本、数据库版本、文件权限和网络配置。

最重要的是:不要将未经验证的备份当作可靠备份。定期进行隔离恢复演练,才能真正降低 Docker 应用的数据丢失风险。


参考资料:

  1. Docker 官方文档:Volumes https://docs.docker.com/engine/storage/volumes/

  2. Docker 官方文档:Backup, restore, or migrate data volumes https://docs.docker.com/engine/storage/volumes/#back-up-restore-or-migrate-data-volumes

  3. Docker Compose 官方文档:docker compose down https://docs.docker.com/reference/cli/docker/compose/down/

  4. MySQL 官方文档:mysqldump https://dev.mysql.com/doc/refman/8.0/en/mysqldump.html

  5. PostgreSQL 官方文档:pg_dump https://www.postgresql.org/docs/current/app-pgdump.html

相关阅读:绿联云的 Docker 部署示例

0

评论

博主关闭了本网站的评论