# 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) 加载镜像**

  ```bash
  docker load < busybox.tar.gz
  ```

  加载后，输出类似：`Loaded image: busybox:latest`。
* **从指定压缩文件加载**

  ```bash
  docker load --input fedora.tar
  ```

  如果 tar 包里包含多个镜像 (不同 tag)，例如 `fedora:rawhide`、`fedora:20` 等，都会被恢复。
* **只加载指定平台的镜像变体**

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

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

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

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