Docker镜像离线迁移：从下载到本地部署完整实战指南

🚀 引言

在实际工作中，我们经常会遇到这样的场景：开发环境可以联网，但生产服务器处于内网环境无法访问Docker Hub；或者需要在多台服务器之间同步Docker镜像。这时候，将Docker镜像打包成tar文件进行迁移就成为必备技能。

本文将手把手教你完成：

✅ Docker镜像的下载和导出

✅ 镜像文件的跨服务器传输

✅ 目标服务器的镜像导入和运行

✅ 进阶技巧：一键压缩传输

📋 前置准备

在开始之前，请确保：

源服务器：已安装Docker，且可以联网下载镜像

目标服务器：已安装Docker，处于离线或内网环境

传输工具：两台服务器之间可以通信（或使用U盘等介质）

基本命令：熟悉Linux基础命令

🎯 实战步骤

Step 1：在源服务器上下载并导出镜像

首先，在可以联网的服务器上下载所需的Docker镜像：

shell 复制代码

# 以Nginx为例，下载最新版镜像
docker pull nginx:latest

# 查看已下载的镜像确认
docker images | grep nginx

接下来，使用docker save命令将镜像导出为tar文件：

shell 复制代码

# 基础导出命令
docker save -o nginx.tar nginx:latest

# 参数说明：
# -o：指定输出文件路径和名称
# nginx:latest：要导出的镜像名称和标签

# 如果需要同时导出多个镜像
docker save -o multiple-images.tar nginx:latest redis:latest mysql:8.0

导出完成后，查看文件大小：

shell 复制代码

ls -lh nginx.tar

小技巧：如果镜像较大，可以在导出时直接压缩：

shell 复制代码

# 导出并压缩
docker save nginx:latest | gzip > nginx.tar.gz

Step 2：将tar文件传输到目标服务器

方法一：使用SCP命令（网络传输）

shell 复制代码

# 从源服务器推送到目标服务器
scp nginx.tar user@目标服务器IP:/tmp/

# 或者在目标服务器上拉取
scp user@源服务器IP:~/nginx.tar /tmp/

方法二：使用rsync（支持断点续传）

复制代码

rsync -avP nginx.tar user@目标服务器IP:/tmp/

方法三：物理介质传输

如果没有网络连接，可以使用U盘或移动硬盘复制文件

Step 3：在目标服务器上导入镜像

登录到目标服务器，使用docker load命令导入镜像：

shell 复制代码

# 基础导入命令
docker load -i /tmp/nginx.tar

# 参数说明：
# -i：指定要加载的tar文件

# 如果是压缩文件，需要先解压
gunzip -c nginx.tar.gz | docker load

导入成功后，验证镜像是否加载成功：

shell 复制代码

# 查看所有镜像
docker images

# 应该能看到刚刚导入的nginx镜像
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
nginx        latest    605c77e624dd   2 weeks ago   141MB

Step 4：运行容器验证部署成功

导入成功后，就可以正常创建和运行容器了：

shell 复制代码

# 运行nginx容器测试
docker run -d --name my-nginx -p 80:80 nginx:latest

# 查看容器运行状态
docker ps

# 测试访问（确保80端口已开放）
curl localhost
# 或者用浏览器访问 http://服务器IP

💡 进阶技巧：一键完成打包和传输

如果两台服务器之间网络通畅，可以直接通过管道一次性完成打包、压缩、传输和导入，不在源服务器生成中间文件：

bash 复制代码

# 源服务器执行
docker save nginx:latest | gzip | ssh user@目标服务器IP "gunzip | docker load"

# 命令分解：
# 1. docker save：导出镜像
# 2. gzip：压缩数据流
# 3. ssh：连接到目标服务器
# 4. gunzip：在目标服务器解压
# 5. docker load：在目标服务器导入镜像

这个方法的优点：

✨ 不产生临时tar文件，节省磁盘空间
✨ 实时压缩传输，减少网络传输时间
✨ 一条命令完成全流程

⚠️ 常见问题与解决方案

Q1：导出时包含多个镜像，导入后标签丢失

bash 复制代码

# 导出前先确认所有需要的标签都存在
docker tag old-image:tag new-image:tag

# 导出时明确指定标签
docker save -o images.tar nginx:latest redis:7.0

Q2：save和export的区别混淆

很多初学者容易混淆这两个命令：

命令	操作对象	是否保留历史	适用场景
`docker save`	镜像(image)	✅ 保留完整历史	镜像迁移、备份
`docker export`	容器(container)	❌ 不保留历史	容器快照、调试

总结：迁移部署用save/load，临时导出容器状态用export/import

如果这篇文章对你有帮助，欢迎点赞、收藏、分享！有问题请在评论区留言，我会第一时间回复。