dps-liumou-Stable 1.0.2

智能Docker镜像拉取工具 - 自动选择最优镜像源

DockerPull 智能镜像拉取工具

🚀 介绍

DockerPull 是一个智能的 Docker 镜像拉取工具，能够自动检测并使用最优的镜像加速源，解决 Docker 镜像拉取慢或失败的问题。

✨ 主要特性

• 智能镜像源选择: 自动检测 20+ 个可用镜像加速源，选择最优源进行拉取
• 实时进度显示: 显示镜像拉取的实时进度（Downloading/Extracting/Pulling）
• 调试模式: 支持 -d 参数输出实际执行的完整命令，便于调试
• 耗时统计: 自动统计并显示整个拉取过程的总耗时
• 容错机制: 支持重试机制，单个镜像源失败自动切换到下一个
• 命令行友好: 使用 argparse 标准库，支持完整的命令行参数和帮助

📦 安装

系统要求

• Python 3.6+
• Docker 已安装

快速安装

# 使用pip3安装
pip3 install dps_liumou_Stable

🎯 使用方法

基本用法

# 拉取镜像（自动选择最优镜像源）
dps nginx:latest

# 拉取指定版本
dps python:3.9

# 列出所有可用镜像源
dps --list-mirrors

# 列出本地镜像
dps --local-images

高级用法

# 调试模式 - 显示实际执行的完整命令
dps nginx:latest -d

# 设置超时时间（秒）
dps nginx:latest --timeout 600

# 设置最大重试次数
dps nginx:latest --max-retries 5

# 强制使用镜像站（适用于非Docker Hub镜像）
dps gcr.io/google/cadvisor:latest --force-mirror

# 组合使用
dps nginx:latest -d --timeout 600 --max-retries 5

非Docker Hub镜像支持

对于非Docker Hub镜像（如 gcr.io/google/cadvisor:latest），工具会自动检测并默认不使用镜像站加速，直接拉取：

# 非Docker Hub镜像 - 默认不使用镜像站
dps gcr.io/google/cadvisor:latest

# 非Docker Hub镜像 - 强制使用镜像站
dps gcr.io/google/cadvisor:latest --force-mirror

命令行参数

positional arguments:
  image_name            要拉取的镜像名称，如 nginx:latest

options:
  -h, --help            显示帮助信息
  --list-mirrors        列出所有可用的镜像源
  --local-images        列出本地Docker镜像
  --timeout TIMEOUT     Docker命令超时时间（秒），默认300秒
  --max-retries MAX_RETRIES
                        每个镜像源的最大重试次数，默认3次
  -d, --debug           调试模式，输出实际执行的完整命令
  --force-mirror        强制使用镜像站（即使非Docker Hub镜像）

使用示例:
  dps nginx:latest                    # 拉取nginx镜像
  dps python:3.9                     # 拉取python镜像
  dps gcr.io/google/cadvisor:latest   # 拉取非Docker Hub镜像
  dps --list-mirrors                   # 列出可用镜像源
  dps --local-images                   # 列出本地镜像
  dps -h                              # 显示帮助信息

🎨 输出示例

正常拉取模式

🎯 开始智能拉取镜像: nginx:latest
==================================================
📋 找到 22 个可用镜像源
  1. 阿里云镜像仓库 - https://registry.cn-hangzhou.aliyuncs.com
  2. 网易云镜像仓库 - https://hub-mirror.c.163.com
  ...

🔄 尝试镜像源 1/22: 阿里云镜像仓库
🔗 URL: https://registry.cn-hangzhou.aliyuncs.com
📥 Downloading  6e7cb3f1d8a5:  45.67MB/123.45MB
📥 Extracting  6e7cb3f1d8a5:  100%
✅ 成功拉取镜像: nginx:latest
==================================================
🎉 镜像拉取成功: nginx:latest
📍 使用的镜像源: 阿里云镜像仓库
⏱️  总耗时: 15.3秒

调试模式

🎯 开始智能拉取镜像: nginx:latest
==================================================
🔍 执行命令: docker pull https://registry.cn-hangzhou.aliyuncs.com/nginx:latest
📥 Downloading  6e7cb3f1d8a5:  45.67MB/123.45MB
📋 latest: Pulling from library/nginx
📋 Digest: sha256:1234567890abcdef...
✅ 命令执行成功: docker pull https://registry.cn-hangzhou.aliyuncs.com/nginx:latest (耗时: 12.5秒)
✅ 成功拉取镜像: https://registry.cn-hangzhou.aliyuncs.com/nginx:latest
🏷️  设置镜像标签: https://registry.cn-hangzhou.aliyuncs.com/nginx:latest -> nginx:latest
✅ 成功设置镜像标签: nginx:latest
🗑️  删除镜像: https://registry.cn-hangzhou.aliyuncs.com/nginx:latest
==================================================
🎉 镜像拉取成功: nginx:latest
📍 使用的镜像源: 阿里云镜像仓库
⏱️  总耗时: 15.3秒

🔧 技术特性

• 智能镜像源管理: 实时检测镜像源可用性，自动过滤失效源
• 实时输出: 使用 subprocess.Popen 实现实时进度显示
• 错误处理: 完善的异常处理和重试机制
• 跨平台: 支持 Windows、Linux、macOS
• 标准库: 使用 argparse 标准库，无需额外依赖

🤝 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

---