我是怎么把 Docker 容器从一台服务器搬到另一台的

第1步：提交容器改动到新镜像#

老实说，我刚开始的时候根本不知道 docker commit 这个命令，每次都是重新配置，简直浪费时间。后来知道这个命令，真的绝了。

1
docker commit [容器ID] [新镜像名称]

这条命令会把你对容器的所有改动（包括文件修改、配置更新、新安装的软件）打包成一个全新的镜像。就像给容器拍了个快照，随时都能恢复。

第2步：把镜像导出成 tar 文件#

有了镜像之后，下一步就是把它打包成一个可以传输的文件。

1
docker save -o [保存的tar文件路径] [新镜像名称]

这里有个小细节需要注意：tar 文件会包含镜像的所有层和元数据，所以文件可能会比较大。我之前迁移过一个 2GB 的镜像，导出来之后大概 1.8GB，这个压缩率还可以。

第3步：用 SCP 传输到目标服务器#

传输文件的方式有很多，但我最推荐 SCP，简单又安全。

1
scp <本地路径>/<镜像名称>.tar <目标服务器IP>:<目标路径>

如果你想更快一点，可以用 rsync，支持断点续传。之前我传输一个大镜像，网络突然断了，还好用了 rsync，不用重新传。

第4步：在目标服务器上加载镜像#

到了目标服务器，就是逆向操作了。

1
docker load -i [tar文件路径]

等它加载完，你可以在目标服务器上用 docker images 看到新的镜像已经乖乖躺在那里了。

第5步：给镜像打个好看的标签#

新加载的镜像可能没有 REPOSITORY 和 TAG，看着特别别扭。

1
docker tag <IMAGE ID> <NEW REPOSITORY>:<TAG>

比如我习惯打成 myapp:v1.0 这样，一看就知道是什么版本。

第1步：备份 Volume 数据卷#

这个步骤稍微复杂一点，但一定要认真操作。

1
docker run --rm --volumes-from [原容器名称或ID] -v $(pwd):/backup ubuntu tar cvf /backup/volume_backup.tar /path/in/container

我来解释一下这条命令的精髓：

• --rm：临时容器用完就删，不留垃圾
• --volumes-from：这是关键，告诉 Docker 使用原容器的数据卷
• -v $(pwd):/backup：把当前目录挂载到临时容器的 /backup 目录，这样 tar 文件就能写出来了
• tar cvf：把数据卷内容打包

举个例子，假设你的容器叫 myapp，数据卷路径是 /var/lib/mysql，完整命令就是：

1
docker run --rm --volumes-from myapp -v $(pwd):/backup ubuntu tar cvf /backup/volume_backup.tar /var/lib/mysql

第2步：传输备份文件#

这个跟前面一样，用 SCP 或者 rsync 都行。

1
scp volume_backup.tar <目标服务器IP>:<目标路径>

第3步：在目标服务器创建新数据卷#

先在目标服务器上创建一个空的数据卷。

1
docker volume create [新数据卷名称]

我习惯给数据卷也起个清晰的名字，比如 myapp-mysql-data，一看就知道是干啥的。

第4步：把备份数据恢复到新数据卷#

这一步是备份的逆向操作。

1
docker run --rm -v [新数据卷名称]:/data -v $(pwd):/backup ubuntu tar xf /backup/volume_backup.tar -C /data

注意这里用的是 tar xf（解压）而不是 tar cvf（打包），别搞混了。-C /data 这个参数很重要，告诉 tar 把文件解压到 /data 目录。

第5步：启动新容器并挂载数据卷#

最后一步，用新镜像启动新容器，把刚才迁移过来的数据卷挂载上去。

1
docker run -d --name [新容器名称] -v [新数据卷名称]:/path/in/container [新镜像名称]

比如这样：

1
docker run -d --name myapp-new -v myapp-mysql-data:/var/lib/mysql myapp:v1.0

启动之后，你可以进容器看看，数据是不是都还在。相信我，看到数据都在的那一刻，真的有种如释重负的感觉。

坑1：忘记迁移 Volume 数据卷#

这个前面提到了，真的惨。一定要记住：容器迁移 ≠ 数据迁移。Volume 是独立于容器的，必须单独处理。

坑2：路径不一致导致数据找不到#

我在迁移一个 WordPress 容器的时候，原容器的数据卷挂载路径是 /var/www/html，结果在新容器上挂载成了 /var/www/wp，WordPress 启动之后找不到数据，直接白屏。

一定要确保路径完全一致，或者至少确保应用能正确找到数据。

坑3：权限问题导致容器无法访问数据#

恢复数据到新 Volume 的时候，有时候会出现权限问题。比如之前用 root 运行的容器，数据文件权限都是 root，新容器用普通用户运行就会报错。

解决办法很简单，调整一下文件权限：

1
docker run --rm -v myapp-data:/data ubuntu chown -R 1000:1000 /data

这里的 1000:1000 要换成你容器运行用户的 UID 和 GID。

坑4：忘记停止原容器#

如果你的服务对数据一致性要求很高（比如数据库），迁移之前一定要先停止原容器，或者至少确保没有写入操作。不然恢复的数据可能不是最新的。