夏有木工作室夏有木工作室夏有木工作室
  • 首页
  • 博客
  • 关于我们
  • 联系我们
夏有木工作室夏有木工作室夏有木工作室
全部文章/
运维

国内无法拉取 Docker 镜像解决方案

EricEric
2024/08/20
·2 分钟阅读 (429 字)·

使用 GitHub Actions 将国外 Docker 镜像转存到阿里云私有仓库,解决国内无法拉取 Docker 官方镜像的痛点。

目录

  • 配置阿里云容器镜像服务
  • 配置 GitHub Actions 变量
  • GitHub Actions 自动运行
  • 查看与拉取阿里云镜像
  • 运维推荐阅读

2024 年 7 月份后,国内无法拉取 Docker 官方仓库的镜像,同时很多国内的镜像网站也无法使用,对于软件开发和项目部署造成了很大麻烦。

使用 GitHub Actions 将国外的 Docker 镜像转存到阿里云私有镜像仓库,供国内服务器拉取使用,免费且易用:

  • 支持 DockerHub, gcr.io, k8s.io, ghcr.io 等任意仓库
  • 支持最大 40GB 的大型镜像
  • 使用阿里云的官方线路,拉取速度快
  • 自定义配置想要同步的镜像与版本标签,方便快捷进行同步和使用

配置阿里云容器镜像服务

登录阿里云容器镜像服务:https://cr.console.aliyun.com/

新建命名空间:

新建命名空间

设置固定密码:

设置好密码后,可以通过 docker login 进行登录了。

设置固定密码

配置 GitHub Actions 变量

配置 GitHub Actions 变量

设置以下四个 Repository Secrets 变量(在第一步配置阿里云中获取):

- ALIYUN_REGISTRY: registry.cn-chengdu.aliyuncs.com <根据你的区域设置>
- ALIYUN_NAME_SPACE: <你的命名空间>
- ALIYUN_REGISTRY_USER: <你的阿里云用户名>
- ALIYUN_REGISTRY_PASSWORD: <你的固定密码>

源代码仓库参考:

flyeric0212/aliyun-docker-image-mirror (github.com)

可以直接 Fork 该项目,修改 images.txt 文件,替换成你想要 Mirror 的 Docker 镜像与版本号。

GitHub Actions 自动运行

在 images.txt 中加入想要镜像的名称和版本号,提交代码后,GitHub Actions 会自动触发构建并执行转存。

GitHub Actions 运行

查看与拉取阿里云镜像

转存成功后的镜像列表展示如下:

同步镜像列表

查看对应镜像的版本列表,选择需要的版本标签进行拉取:

镜像版本列表

在本地或服务器登录阿里云 Docker Registry 后,直接执行 docker pull 即可高速拉取:

拉取镜像验证

运维推荐阅读

如果你对系统运维、服务部署与合规备案感兴趣,推荐阅读:

  • 域名备案全流程详解

👉 查阅更多环境部署与基础设施治理实战,欢迎访问 运维专栏完整目录。

上一篇

异步批处理方案设计:JDK21 + 虚拟线程

下一篇

微服务鉴权源码解析:SpringBoot 3.x + OAuth2

更多文章

域名备案全流程详解

域名备案全流程详解

个人与企业域名 ICP 备案与公安联网备案全流程拆解,助你高效合规上线网站服务。

EricEric
2025/01/16
Grok Bot 定时任务实战:每日选题推送与 Codex hi

Grok Bot 定时任务实战:每日选题推送与 Codex hi

用 Grok Bot 定时处理每日选题扫描和 Codex hi,分享两个真实任务的完整提示词、配置方法,以及筛选、查重和规则精简中的实践经验。

EricEric
2026/11/04
多 Bot 协作实践:一套共用的工作区与规则

多 Bot 协作实践:一套共用的工作区与规则

多个 Bot 各自维护记忆,规则分散、重复且容易冲突。本文以 Grok Bot 为例,介绍如何用一个共用的 Git 工作区统一入口、规则与分工。

EricEric
2026/10/26
夏有木工作室夏有木工作室夏有木工作室

专业软件开发技术伙伴,帮助客户快速构建出高质量的软件产品。

GitHubGitHubEmail
Built with夏有木工作室夏有木工作室夏有木

川公网安备51012202002478号|蜀ICP备2025156031号-1

产品
  • 夏有木进销存
工具
  • 夏有木微信公众号排版
资源
  • 博客
  • 更新日志
公司
  • 关于我们
  • 联系我们
法律
  • Cookie政策
  • 隐私政策
  • 服务条款
© 2026 夏有木工作室 All Rights Reserved.