---
title: Docker Save
type: concept
tags: [docker, container, image-transfer]
last_updated: 2026-04-21
---

# Docker Save

## Definition

`docker save` 是 Docker CLI 命令，用于将一个或多个镜像导出为 tar 归档文件（`.tar`），实现镜像的离线存储和传输。

## Syntax

```bash
docker save [OPTIONS] IMAGE [IMAGE...]
```

### Options

| Option | Description |
|--------|-------------|
| `-o, --output` | 指定输出文件名（默认输出到 stdout） |

## Usage Examples

### 基本用法

```bash
# 导出单个镜像
docker save -o nginx.tar nginx:latest

# 导出多个镜像
docker save -o images.tar nginx:latest redis:alpine postgres:15

# 使用管道传输
docker save nginx:latest | ssh user@remote-host 'docker load'
```

### 典型工作流：将镜像从开发机传输到 NAS

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

# 将 xiaoya.tar 复制到 NAS（通过 SMB/SCP）
scp xiaoya.tar nas:/volume1/docker/images/

# 在 NAS 上
docker load < xiaoya.tar
```

## Related Concepts

- [[Docker-Load]]：对应的导入命令
- [[Docker-Image]]：被导出的对象
- [[Docker-TAR-Archive]]：生成的归档文件格式

## Relationships

- [[Docker-Image]] ← 导出为 ← [[Docker-Save]]
- [[Docker-Save]] → 输出 → [[Docker-TAR-Archive]]

## Key Points

1. **保留镜像层**：完整保留镜像的分层结构
2. **保留元数据**：包括 CMD、ENTRYPOINT、ENV、LABEL 等
3. **可移植性**：生成的 tar 文件可在任何 Docker 环境中导入
4. **适用场景**：离线环境迁移、备份、镜像分发

## Notes

- 文件大小可能较大（包含所有镜像层）
- 多次 save 同一镜像会重复包含所有层
- 可配合 `docker load` 实现完整的镜像迁移闭环