如何使用tar导出的本地Docker镜像在新服务器启动容器

问题根因 #

出现启动时强制拉取远程镜像的问题，本质只有两个原因：

• YAML配置中填写的镜像标识和本地docker load导入的镜像实际标签/ID不匹配，Docker找不到对应本地镜像时会默认去远程公库拉取
• 容器编排工具（Docker Compose/Swarm等）默认配置的拉取策略会优先校验远程仓库镜像版本，哪怕本地存在同名镜像也会尝试拉取最新版

分步操作 #

第一步：确认本地导入镜像的准确标识 #

登录新服务器执行以下命令，列出所有本地存储的镜像，逐一核对7个迁移镜像的完整REPOSITORY和TAG字段，不要自行臆造镜像名：

docker images

如果docker commit制作镜像时未指定自定义tag，导入后镜像的TAG列会显示<none>，这类镜像无法被编排文件正确识别，必须先手动打标签：

# 命令格式：docker tag 本地镜像ID 自定义镜像名:自定义版本tag
# 示例：docker tag 7d94e2a1f3c8 biz-app:v2.1

第二步：修改编排YAML配置 #

打开你的容器编排YAML文件做两处修改：

1. 把每个服务的image字段值，替换成上一步查到的和本地镜像完全一致的REPOSITORY:TAG，不要添加任何远程仓库前缀（比如不要带docker.io/这类公库地址前缀）
2. 给每个服务显式添加拉取策略配置，强制Docker只使用本地镜像，禁止触发远程拉取：

services:
  your-app-name:
    image: biz-app:v2.1 # 必须和本地docker images查到的标签完全一致
    pull_policy: never # 核心配置：找不到本地镜像直接报错，绝不走远程拉取
    # 端口映射、目录挂载、环境变量等其余原有配置保持不变即可

如果你使用的是v2版本及更早的Docker Compose，拉取策略字段为image_pull_policy: never，效果完全相同。

第三步：清理残余资源后启动 #

先清理之前启动失败产生的冗余容器和缓存配置，再启动服务：

# 清理对应项目的残余容器、网络
docker compose down
# 后台启动服务
docker compose up -d

配置正确的情况下，启动过程会直接调用本地导入的镜像创建容器，不会触发任何远程仓库拉取动作。 #

注意事项 #

• 不要给本地镜像打latest标签后省略tag直接引用，latest是Docker的特殊浮动标签，默认会触发远程仓库版本校验，必须使用自定义固定tag搭配pull_policy: never才能彻底阻断远程拉取
• docker commit只会保存容器可写层的文件改动，不会包含容器挂载的外部volume数据，docker save/docker load流程也不会备份恢复volume内容，如果之前的容器有挂载本地目录/数据卷，需要单独迁移卷内文件
• 如果启动时提示image not found，直接回到第一步核对镜像标签，注意区分大小写、特殊字符，确保YAML里的镜像名和本地标签完全匹配

内容的提问来源于stack exchange，提问作者PaulMcF87