nexus/wiki/concepts/Docker-Load.md

title, type, tags, last_updated

title	type	tags	last_updated
Docker Load	concept	docker container image-transfer	2026-04-21

Docker Load

Definition

docker load 是 Docker CLI 命令，用于从 tar 归档文件加载镜像到本地 Docker 镜像存储。与 docker save 配合使用，实现镜像的离线迁移。

Syntax

docker load [OPTIONS]

Options

Option	Description
-i, --input	指定输入的 tar 文件（默认从 stdin 读取）
-q, --quiet	静默模式，减少输出

Usage Examples

基本用法

# 从文件加载
docker load < nginx.tar

# 指定文件
docker load -i images.tar

# 静默模式
docker load -i images.tar -q

典型工作流：从开发机接收镜像到 NAS

# 在开发机上
docker save -o xiaoya.tar xiaoyaliu/alist:latest

# 将 xiaoya.tar 复制到 NAS
scp xiaoya.tar nas:/volume1/docker/images/

# 在 NAS 上加载
docker load < xiaoya.tar

# 验证
docker images | grep xiaoya

使用 SSH 管道直接传输

# 在目标机器上执行（镜像从远程机器流式传输）
ssh user@source-host 'docker save nginx:latest' | docker load

Related Concepts

• Docker-Save：对应的导出命令
• Docker-Image：被导入的目标
• Docker-TAR-Archive：输入的归档文件格式

Relationships

• Docker-Image ← 导入为 ← Docker-Load
• Docker-Load ← 依赖 ← Docker-Save

Key Points

1. 完整还原：从 tar 文件完整恢复镜像，包括所有层和元数据
2. 自动识别：自动识别 tar 文件中的镜像名称和标签
3. 可重复导入：同一镜像可多次导入（会创建重复条目，需配合 docker rmi）
4. ID 匹配：如果镜像 ID 已存在，会分配新的 ID

Comparison with Alternatives

特性	docker load	docker import
数据源	docker save 输出	docker export 输出
内容	完整镜像（含层）	容器文件系统快照
元数据	完整保留	不保留
适用场景	镜像迁移	容器基础创建

Notes

• 导入后的镜像默认标签可能为 <none>:<none>，需要手动 tag
• 使用 docker tag 命令为导入的镜像设置标签
• 大镜像加载可能需要较长时间，显示进度条