Docker镜像查询下载工具使用说明

📖 工具概述

Docker镜像查询下载工具是一个专业的Docker Registry客户端，支持从各种Docker镜像仓库查询和下载镜像。该工具具有断点续传、多线程下载、自动token管理等高级功能，并能生成Docker兼容的tar格式压缩包，方便在离线环境中部署和使用。

✨ 主要功能

🔍 镜像查询功能

版本列表查询：查询指定镜像的所有可用版本标签
架构信息显示：展示每个版本支持的系统架构（amd64、arm64等）
大小统计：显示各版本镜像的存储大小
多平台支持：自动识别和显示多平台镜像信息
智能排序：按版本号智能排序，最新版本优先显示

⬇️ 镜像下载功能

多线程下载：使用3个并发线程，提升下载速度
断点续传：支持中断后继续下载，避免重复下载
自动token管理：自动获取和刷新认证令牌
平台选择：支持指定目标架构和操作系统
进度监控：实时显示下载进度和速度
错误重试：自动重试失败的下载任务

📦 压缩打包功能

Docker兼容格式：生成标准的tar格式压缩包
自动命名：压缩包名称包含镜像名和版本号
空间优化：可选择删除原文件夹节省存储空间
直接导入：生成的tar文件可直接用于Docker导入

🎯 使用场景

离线环境部署：在无网络环境中部署Docker镜像
镜像备份：定期备份重要的Docker镜像
版本管理：批量下载不同版本的镜像进行测试
跨网络传输：在不同网络环境间传输镜像
私有仓库迁移：从一个Registry迁移到另一个

🔧 参数说明

必填参数

参数名称	描述	示例
镜像仓库地址	Docker Registry的地址	`registry-1.docker.io`
镜像名称	要查询或下载的镜像名	`nginx`, `mysql`, `ubuntu`
操作模式	选择查询版本或下载镜像	`查询可用版本` / `下载指定版本`

下载模式参数

参数名称	描述	默认值	选项
镜像版本标签	指定要下载的版本	`latest`	`latest`, `1.20`, `alpine` 等
系统架构	目标系统架构	`amd64`	`amd64`, `arm64`, `386`, `arm/v7` 等
操作系统	目标操作系统	`linux`	`linux`, `windows`, `darwin`
下载保存目录	镜像保存的本地目录	无	任意有效路径

可选参数

参数名称	描述	用途
认证用户名	私有仓库用户名	访问私有镜像仓库
认证密码	私有仓库密码	配合用户名使用

📋 详细使用步骤

1. 查询镜像版本

设置基本参数
- 镜像仓库地址：registry-1.docker.io
- 镜像名称：nginx
- 操作模式：选择 查询可用版本
运行工具
- 点击运行按钮
- 工具将显示该镜像的所有可用版本
- 查看版本列表，选择需要的版本

查询结果解读

序号 版本标签              架构信息                      大小        状态
1    latest              amd64/linux, arm64/linux      142.13MB    ✅ 可用
2    1.25                amd64/linux                   138.45MB    ✅ 可用
3    alpine              amd64/linux, arm64/linux      23.45MB     ✅ 可用

2. 下载指定版本

设置下载参数
- 镜像仓库地址：registry-1.docker.io
- 镜像名称：nginx
- 操作模式：选择 下载指定版本
- 镜像版本标签：latest
- 系统架构：amd64
- 操作系统：linux
- 下载保存目录：选择本地目录
开始下载
- 工具将自动完成以下步骤：
  - 获取认证令牌
  - 解析镜像清单
  - 多线程下载镜像层
  - 创建tar压缩包

下载完成

🎉 镜像下载完成!
📦 Docker兼容tar包: nginx_latest.tar
💾 位置: /path/to/download/nginx_latest.tar
🐳 导入方法: docker load < nginx_latest.tar

🐳 镜像导入使用方法

下载完成后，你将得到一个以 .tar 结尾的压缩包文件。以下是将其导入Docker的详细步骤：

方法一：直接导入（推荐）

# 进入压缩包所在目录
cd /path/to/download/

# 导入镜像
docker load < nginx_latest.tar

方法二：使用输入重定向

# 完整路径导入
docker load -i /path/to/download/nginx_latest.tar

方法三：验证导入结果

# 查看已导入的镜像
docker images

# 输出示例：
# REPOSITORY   TAG      IMAGE ID       CREATED        SIZE
# nginx        latest   605c77e624dd   2 weeks ago    141MB

# 运行测试容器
docker run -d -p 8080:80 nginx:latest

# 测试访问
curl http://localhost:8080

📁 文件结构说明

下载完成后，工具会创建以下文件结构：

下载目录/
├── nginx_latest.tar          # Docker兼容的tar压缩包（主要文件）
└── nginx_latest/             # 原始文件目录（可选保留）
    ├── manifest.json         # 镜像清单文件
    ├── config_a1b2c3d4.json  # 镜像配置文件
    ├── layer_01_e4f5g6h7.tar.gz  # 镜像层文件
    ├── layer_02_i8j9k0l1.tar.gz  # 镜像层文件
    ├── ...                   # 更多层文件
    └── download_info.txt     # 下载信息说明

文件说明

tar压缩包：这是最重要的文件，可以直接用于Docker导入
manifest.json：包含镜像的完整元数据信息
config_*.json：镜像的配置信息，包含架构、环境变量等
layer_*.tar.gz：镜像的各个层文件，按顺序编号
download_info.txt：包含下载的详细信息和使用说明

⚙️ 高级配置

工具内置了一些高级配置参数，可以在代码中调整：

# 下载线程数 (1-8)
DEFAULT_DOWNLOAD_THREADS = 3

# 重试次数 (1-10)
DEFAULT_RETRY_COUNT = 3

# 是否创建压缩包
DEFAULT_CREATE_ARCHIVE = True

# 是否保留原文件夹
DEFAULT_KEEP_ORIGINAL = False

# 版本查询数量 (10-200)
DEFAULT_MAX_TAGS = 50

# 请求超时时间 (10-120秒)
DEFAULT_TIMEOUT = 30

🛡️ 安全认证

私有仓库访问

如果需要访问私有Docker仓库，请配置认证信息：

填写认证参数
- 认证用户名：你的仓库用户名
- 认证密码：你的仓库密码或访问令牌
支持的认证方式
- 基本用户名密码认证
- 访问令牌认证（推荐）
- 匿名访问（公共仓库）

仓库地址示例

仓库类型	地址示例	说明
Docker Hub	`registry-1.docker.io`	官方公共仓库
阿里云	`registry.cn-hangzhou.aliyuncs.com`	阿里云容器镜像服务
腾讯云	`ccr.ccs.tencentyun.com`	腾讯云容器镜像仓库
私有部署	`your-registry.com:5000`	自建私有仓库

🚀 性能优化建议

网络优化

选择就近仓库：使用地理位置最近的镜像仓库
网络稳定：确保网络连接稳定，避免频繁中断
带宽充足：大型镜像下载需要充足的网络带宽

存储优化

磁盘空间：确保有足够的磁盘空间存储镜像
SSD硬盘：使用SSD硬盘可以提升文件写入速度
清理空间：定期清理不需要的镜像文件

下载策略

分批下载：对于大量镜像，建议分批下载
错峰下载：在网络负载较低的时间段下载
断点续传：充分利用断点续传功能，避免重复下载

❓ 常见问题解答

Q1: 下载速度慢怎么办？

A: 可以尝试以下方法：

检查网络连接是否稳定
更换到距离更近的镜像仓库
在网络负载较低的时间段下载
检查是否有防火墙或代理影响

Q2: 下载中断后如何继续？

A: 工具支持断点续传：

重新运行工具，使用相同的参数
工具会自动检测已下载的文件
只下载未完成的部分，节省时间

Q3: 如何下载多平台镜像？

首先查询镜像版本，查看支持的平台
分别指定不同的架构参数多次下载
例如：先下载amd64版本，再下载arm64版本

Q4: 私有仓库认证失败怎么办？

A: 检查以下项目：

用户名和密码是否正确
是否有访问该镜像的权限
仓库地址是否正确
网络是否能访问该仓库

Q5: 导入镜像后无法运行？

A: 检查以下方面：

架构是否匹配（amd64 vs arm64）
操作系统是否兼容
Docker版本是否支持该镜像格式
是否有必要的运行权限

Q6: 如何验证下载的镜像完整性？

查看download_info.txt文件中的摘要信息
使用docker load导入后检查镜像大小
运行镜像进行功能测试
对比官方镜像的SHA256值

Docker镜像查询下载工具