FROM指令不能直接加载本地tar包，必须先用docker load -i导入镜像到本地仓库，再在Dockerfile中以“镜像名:标签”格式引用，如FROM my-ubuntu:v1；导入前可解压tar包查看repositories文件确认名称。
FROM 指令本身不能直接加载本地 tar 压缩包，它只认已存在于本地镜像仓库中的镜像名称（如 ubuntu:22.04 或 my-base:dev）。所以“用 FROM 引用离线导入的基础镜像”，关键在于：先让那个基础镜像出现在本地镜像列表里，再在 Dockerfile 中写它的名字。
第一步：把压缩包导入成可用镜像
拿到 base-image.tar 或 base-image.tar.gz 后，在目标离线服务器上执行：
- 如果是 .tar 文件：
docker load -i base-image.tar - 如果是 .tar.gz 文件（需先解压或用管道）：
gunzip -c base-image.tar.gz | docker load
或先解压再 load：gunzip base-image.tar.gz && docker load -i base-image.tar
导入成功后，运行 docker images 确认镜像已列出，注意看 REPOSITORY 和 TAG 列——比如显示 my-ubuntu 和 v1，那它在本地的“名字”就是 my-ubuntu:v1。
第二步：Dockerfile 中正确引用这个本地镜像
不要写路径或文件名，只写导入后显示的镜像名+标签：
- ✅ 正确写法：
FROM my-ubuntu:v1 - ❌ 错误写法：
FROM ./base-image.tar（语法不支持）FROM /tmp/base-image.tar.gz（Docker 不识别路径）
如果导入时没指定标签，Docker 会默认设为 latest，此时写 FROM my-ubuntu:latest 即可。也可用 docker tag 重命名或打标：
docker tag my-ubuntu:latest base-os:prod- 然后 Dockerfile 就能写
FROM base-os:prod
第三步：构建时确保基础镜像已就位
执行 docker build 前，必须已完成导入操作。构建过程不会联网拉取，也不会自动解压 tar 包——它只查本地镜像库。
- 若报错
pull access denied for xxx, repository does not exist or may require 'docker login'，说明 FROM 后的名字在docker images里找不到，不是网络问题，是名字写错了或没导入成功 - 若提示
no matching manifest，通常是架构不匹配（比如 x86 镜像导入到 ARM 机器），和离线无关，需确认压缩包来源与目标平台一致
补充：怎么知道压缩包里镜像是什么名字？
导出时用了什么名字，导入后就是什么名字。如果不确定，可以临时解压查看：
mkdir tmp && tar -xf base-image.tar -C tmp- 进入
tmp目录，看repositories文件内容，里面明确写了镜像名和标签
或者更简单：在源服务器导出前，先运行 docker images 记下完整名称，导入后保持一致即可。
