docker save 是 Docker 中用于将镜像打包为 tar 文件的命令，常用于镜像的备份、迁移或离线传输。以下是其核心用法和注意事项：

一、基本语法

bash

docker save [选项] IMAGE [IMAGE...] > 文件名.tar
# 或
docker save -o 文件名.tar IMAGE [IMAGE...]

• IMAGE：镜像名称（如 nginx:latest）或镜像 ID。
• 选项：
  • -o：指定输出文件路径（推荐）。
  • -q：静默模式，不显示进度。

二、常见场景示例

1. 导出单个镜像

bash

docker save -o nginx.tar nginx:latest

将 nginx:latest 镜像保存为 nginx.tar 文件。

2. 导出多个镜像

bash

docker save -o my_images.tar nginx:latest alpine:3.14

将多个镜像打包到同一个 tar 文件中。

3. 通过管道压缩（节省空间）

bash

docker save nginx:latest | gzip > nginx.tar.gz

使用 gzip 压缩镜像，减少文件体积。

三、镜像加载与传输

1. 加载镜像（在目标机器上）

bash

docker load -i nginx.tar
# 或通过管道加载压缩文件
docker load < nginx.tar.gz

2. 跨主机传输示例

bash

# 发送方：打包并通过 SSH 传输
docker save nginx:latest | ssh user@target-server "docker load"# 接收方：直接加载
scp user@source-server:/path/to/nginx.tar .
docker load -i nginx.tar

四、注意事项

1. 与 docker export 的区别

   • docker save：保存完整镜像（包括历史层），用于迁移镜像。
   • docker export：导出容器文件系统为 tar，丢失镜像历史，适合制作基础镜像。

2. 文件大小

   • 镜像可能占用大量磁盘空间，建议使用压缩（如 gzip）或增量备份工具。

3. 版本兼容性

   • 导出的镜像需在兼容的 Docker 版本上加载（尽量保持版本一致）。

4. 离线环境

   • 若目标机器无法联网，需提前保存所有依赖镜像（如基础镜像、工具镜像）。

五、实践建议

• 标签管理：导出时带上明确标签（如 nginx:1.23.3），避免加载后标签丢失。
• 验证完整性：传输后通过 docker images 检查镜像是否正确加载。
• 脚本自动化：批量导出多个镜像时，可结合脚本生成镜像列表：

  bash

  docker save -o all_images.tar $(docker images -q)
  

通过 docker save 和 docker load，你可以轻松实现镜像的迁移和备份，确保环境一致性。