容器跨主机数据迁移备份中转模型：从备份到恢复的全流程实践

场景说明：为什么要用中转模型迁移容器

当需要把一台服务器上的容器完整搬到另一台服务器时，直接复制运行中的容器并不可靠。
容器跨主机数据迁移备份中转模型是指先将镜像和数据打包成文件，通过中间存储（如SSH、NFS、对象存储）传输，再在目标机上恢复。

这种方法不依赖集群管理工具，适合单机环境或没有共享存储的场合。

前置准备

• 两台服务器：源主机（IP: 192.168.1.10）和目标主机（IP: 192.168.1.20），均安装Docker。
• 源主机停止目标容器：docker stop 容器名。
• 确认容器包含哪些资源：镜像、数据卷（volume或bind mount）、启动参数。
• 中转存储：最简单的就是通过公钥SSH在主机间传文件，也可以先下载到本机再上传。

分步操作：完整的备份与恢复流程

1. 在源主机备份容器镜像

# 查看镜像名称
sudo docker ps -a --format "table {{.ID}} {{.Image}} {{.Names}}" | grep 你的容器

# 导出镜像为tar文件
sudo docker save -o myapp-image.tar 镜像名:标签

如果容器基于多个镜像层，docker save 会打包所有层，文件可能较大，建议先执行 docker images 确认。

2. 备份数据卷 (volume 或 bind mount)

对于命名卷，先查询卷挂载点：

sudo docker inspect 容器名 | grep -A10 "Mounts"

你会看到类似 "Source": "/var/lib/docker/volumes/xxx/_data" 的路径。

# 假设容器有个卷挂载到 /data，用tar打包
sudo tar -czf data-backup.tar.gz -C /var/lib/docker/volumes/xxx/_data .

如果数据直接绑定宿主目录（例如 -v /home/user/data:/app/data），直接打包源目录：

sudo tar -czf data-backup.tar.gz -C /home/user/data .

3. 传输文件到目标主机

使用 scp 或 rsync（推荐，支持断点续传）：

# 传输镜像
scp myapp-image.tar root@192.168.1.20:/root/

# 传输数据包
scp data-backup.tar.gz root@192.168.1.20:/root/

若文件很大，改用 rsync -avP 避免中断重传。

4. 在目标主机恢复

# 加载镜像
sudo docker load -i /root/myapp-image.tar

# 查看加载后的镜像名和标签
sudo docker images

# 恢复数据卷（先创建目标文件夹）
sudo mkdir -p /opt/containers/myapp/data
sudo tar -xzf /root/data-backup.tar.gz -C /opt/containers/myapp/data

5. 还原容器启动参数并运行

最好提前从源主机导出启动配置：

sudo docker inspect 容器名 > container-config.json

根据里面的 Config.Cmd、Config.Env、HostConfig.PortBindings 等信息，在目标主机上组合 docker run 命令。
示例：

sudo docker run -d \
  --name myapp \
  -p 8080:80 \
  -v /opt/containers/myapp/data:/app/data \
  -e "DB_HOST=192.168.1.20" \
  myapp-image:latest

复制时注意端口冲突、卷路径一致性。

避坑指南

• 迁移前一定要停止容器，否则数据卷可能正在写入导致文件不一致。
• 镜像导出时如果容器引用了私有仓库镜像，需确认目标主机能否拉取相同版本，最好将镜像完整导出。
• 如果容器使用 docker-compose，建议直接拷贝 docker-compose.yml 和 .env 文件，在目标主机上执行 docker-compose up -d，更简单。
• 迁移后若容器启动失败，先 docker logs 容器名 查看日志，常见原因是环境变量或卷路径不匹配。
• 跨操作系统迁移（如CentOS到Ubuntu）时，注意应用本身对glibc等依赖，容器内已封装可忽略；但卷内的二进制文件可能不兼容。

效果验证与高频问题

验证步骤

1. 在目标主机执行 curl http://localhost:8080 或访问业务地址，确认服务正常。
2. 检查数据完整性：登录容器 docker exec -it 容器名 bash，查看数据文件内容是否与源主机一致。

FAQ

Q：迁移后容器名称冲突怎么办？
A：运行 docker ps -a 查看已有容器，修改 --name 参数或先删除旧的。

Q：数据卷非常大，传输中断了怎么继续？
A：使用 rsync -avP --partial 命令，支持断点续传；或者先压缩再传输。

Q：能否在不停止容器的情况下备份？
A：不推荐，尤其是数据库容器。如果必须在线，考虑数据库自身备份工具（如mysqldump）。

建议在实际迁移前先在测试环境演练一遍，熟悉中转模型的每一个环节。
如果你使用 Docker Compose 管理多个容器，优先采用整体迁移的 docker-compose.yml 方案会更高效。