docker image load

描述

• 从一个 tar 存档 (tar archive) 或标准输入 (STDIN) 加载 (还原) 镜像 (image) 或仓库 (repository)。

• 支持压缩格式：即使 tar 是通过 gzip、bzip2、xz 或 zstd 压缩的，也可以加载。

• 加载后会恢复镜像中的 标签 (tags)。

• 该命令的别名是 docker load。

用法

docker image load [OPTIONS]

(也可以只用 docker load，效果一样)

选项

| 选项 | 描述 | | - | | | -i, --input | 指定从某个 tar 文件读取 (而不是标准输入)。 | | --platform | API 1.48+ 才支持。指定只加载存档中某个平台 (platform) 的变体。例如 linux/amd64、linux/arm64/v8 等格式。 | | -q, --quiet | 安静模式：抑制加载过程中的输出 (不打印加载细节)。 |

示例 (Examples)

• 从标准输入 (STDIN) 加载镜像

  docker load < busybox.tar.gz

  加载后，输出类似：Loaded image: busybox:latest。

• 从指定压缩文件加载

  docker load --input fedora.tar

  如果 tar 包里包含多个镜像 (不同 tag)，例如 fedora:rawhide、fedora:20 等，都会被恢复。

• 只加载指定平台的镜像变体

  docker image load -i image.tar --platform=linux/amd64

  如果存档里有多个平台 (例如同时有 amd64 和 arm64)，这条命令会只加载 linux/amd64 版本。

  如果指定的平台在存档中不存在，命令会报错：

  requested platform (xxx) not found: image might be filtered out