Docker Hub 镜像一键同步至阿里云 ACR
🐳 Docker Hub 镜像一键同步至阿里云 ACR
本脚本用于 从 Docker Hub 拉取镜像并推送到阿里云容器镜像服务（ACR）。
它通过 Python 的 docker SDK 封装了完整流程：拉取 → 重命名 → 登录 → 推送，并在控制台实时输出进度日志，方便运维和开发人员快速完成镜像同步。
✨ 功能特点
- 支持从 Docker Hub 拉取任意镜像（如
nginx:latest） - 自动重命名为 阿里云 ACR 标准镜像格式
- 支持 公网地址 和 内网 VPC 地址 两种形式
- 全过程输出拉取、推送进度，方便排错
- 命令行参数友好，可灵活调用
🚀 使用方法
-
确保本地安装了 Docker 并已启动
-
安装依赖：
pip install docker -
执行脚本（例如拉取
nginx:latest）：python ack-reg-sync.py nginx:latest
⚙️ 配置说明
在脚本中可修改以下固定参数：
acr_registry：阿里云 ACR 地址（如registry.cn-shenzhen.aliyuncs.com）acr_namespace：命名空间（仓库名）acr_username：阿里云账号或 RAM 用户acr_password：对应密码或临时令牌
import docker
import argparse # 新增导入def pull_from_dockerhub_and_push_to_acr(dockerhub_image: str,acr_registry: str,acr_namespace: str,acr_username: str,acr_password: str
):"""从 Docker Hub 拉取镜像（显示进度），推送到阿里云 ACR:param dockerhub_image: Docker Hub 镜像名称（如 `nginx:latest`）:param acr_registry: 阿里云 ACR 注册表地址（如 `registry.cn-hangzhou.aliyuncs.com`）:param acr_namespace: ACR 命名空间（仓库名称）:param acr_username: 阿里云账号或 RAM 用户名:param acr_password: 阿里云密码或临时令牌"""# 初始化 Docker 客户端client = docker.from_env()# 1. 从 Docker Hub 拉取镜像（显示进度）print(f"从 Docker Hub 拉取镜像: {dockerhub_image}")pull_logs = client.api.pull(dockerhub_image,stream=True, # 启用流式输出decode=True # 解析日志为字典)# 实时显示拉取进度for log in pull_logs:if "progress" in log:print(f"层 {log['id']}: {log['status']} "f"{log['progress'] if 'progress' in log else ''}")else:print(f"{log['status']} {log.get('id', '')}".strip())# 2. 重命名为阿里云 ACR 格式image_with_tag = dockerhub_image.split('/')[-1]target_image = f"{acr_registry}/{acr_namespace}/{image_with_tag}"alias_image = f"registry-vpc.cn-shenzhen.aliyuncs.com/{acr_namespace}/{image_with_tag}"print(f"\n重命名镜像为: {target_image}")image = client.images.get(dockerhub_image)image.tag(target_image)# 3. 登录阿里云 ACRprint("登录阿里云 ACR...")client.login(username=acr_username,password=acr_password,registry=acr_registry)# 4. 推送镜像到阿里云 ACRprint(f"推送镜像到阿里云 ACR: {target_image}")push_logs = client.images.push(target_image,stream=True,decode=True)# 显示推送进度（可选）for log in push_logs:if "error" in log:raise Exception(f"推送失败: {log['error']}")print(log.get("status", ""), log.get("progress", ""))print(f"\n阿里云公网地址为: {target_image}")print(f"\n阿里云内网地址为: {alias_image}")print("\n操作完成！")if __name__ == "__main__":# 配置参数解析器parser = argparse.ArgumentParser(description='从Docker Hub拉取镜像并推送到阿里云ACR')parser.add_argument('dockerhub_image', type=str, help='Docker Hub镜像名称（如 nginx:latest）')# 其他固定参数args = parser.parse_args()# 固定配置的其他参数acr_registry = "registry.cn-shenzhen.aliyuncs.com" # 阿里云 ACR 地址acr_namespace = "xxxxx" # ACR 命名空间（仓库名）acr_username = "xxxxxxxxxx" # 阿里云账号acr_password = "xxxxxxxxxx" # 密码或临时令牌# 执行操作pull_from_dockerhub_and_push_to_acr(args.dockerhub_image, # 使用命令行参数acr_registry,acr_namespace,acr_username,acr_password)