← 返回命令列表

Linux command

docker-image-load 命令

文件

复制后可按需替换文件名、目录或参数。

常用示例

Load an image from a tar archive

docker image load -i [image.tar]

Load an image from stdin

cat [image.tar] | docker image load

Load an image with quiet output

docker image load -q -i [image.tar]

Load only a specific platform variant

docker image load --platform [linux/amd64] -i [image.tar]

说明

docker image load loads a Docker image from a tar archive (even if compressed with gzip, bzip2, xz, or zstd) created by docker image save, restoring the image layers and metadata to the local Docker daemon. The tar archive contains all image layers, configuration, and manifest data needed to fully reconstruct the image. Loading an image preserves its repository tags and digests exactly as they were when saved. This makes docker image load ideal for air-gapped environments, backup/restore workflows, and distributing images via physical media or secure file transfer. The command can read from a file specified with -i or from stdin, enabling flexible integration with compression tools and network transfers.

参数

-i, --input _file_
Read from tar archive file instead of STDIN.
-q, --quiet
Suppress load output.
--platform _value_
Load only the given platform variant(s), formatted as "os/arch[/variant]" (e.g., linux/amd64). Can be specified multiple times.

FAQ

What is the docker-image-load command used for?

docker image load loads a Docker image from a tar archive (even if compressed with gzip, bzip2, xz, or zstd) created by docker image save, restoring the image layers and metadata to the local Docker daemon. The tar archive contains all image layers, configuration, and manifest data needed to fully reconstruct the image. Loading an image preserves its repository tags and digests exactly as they were when saved. This makes docker image load ideal for air-gapped environments, backup/restore workflows, and distributing images via physical media or secure file transfer. The command can read from a file specified with -i or from stdin, enabling flexible integration with compression tools and network transfers.

How do I run a basic docker-image-load example?

Run `docker image load -i [image.tar]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does -i, --input _file_ do in docker-image-load?

Read from tar archive file instead of STDIN.