摘要
1) 一句话总结
该项目是一个持续更新的国内可用 Docker 镜像源汇总仓库，提供公共加速节点、环境配置指南以及自建代理教程，以解决国内拉取容器镜像受阻的问题。
2) 核心要点
- 项目背景与热度：旨在应对 2024 年中旬起国内 Docker 镜像站大面积下架的问题，目前在 GitHub 拥有超过 7300 颗 Star。
- 可用源与失效追踪：收录并定期测试国内仍可用的公益及云厂商（如 DaoCloud、腾讯云、阿里云等）镜像源，同时记录已关停或封锁的失效节点。
- 多仓库支持：除 DockerHub 外，还提供 gcr.io、quay.io、ghcr.io、k8s.gcr.io 等其他常用容器镜像仓库的加速资源。
- 自建方案汇总：收集了基于 Cloudflare Workers、Nginx、CNCF Distribution 以及 KSpeeder、hubproxy、Xget 等开源工具的自建镜像代理与缓存教程。
- 全局配置指南：提供针对 Docker (
/etc/docker/daemon.json) 和 containerd (/etc/containerd/config.toml) 的 registry mirror 配置文件修改示例。 - 直接拉取方式：支持在
docker pull命令中直接将官方域名前缀替换为代理站点的域名进行拉取。
3) 风险与不足
- 镜像完整性限制：部分公益镜像站仅提供基础镜像或白名单镜像，可能无法拉取到某些特定镜像。
- 网络访问限制：部分云厂商（如腾讯云）镜像仅支持内网访问加速；部分节点（如 1panel 节点）限制仅限中国地区访问。
- 资源滥用风险：许多代理站点由网友自费搭建，资源有限，若未合理控制请求频率和流量，可能导致节点因滥用而关停。
功能与定位
该项目是一个持续更新的 DockerHub 国内镜像加速源汇总仓库。由于 2024 年中旬起国内多个常用 Docker 镜像站（含高校及云服务商节点）因监管要求相继下架，该项目旨在为国内开发者提供当前仍可用的 Docker 镜像拉取替代方案、配置指南以及自建加速服务的教程。
典型使用场景
- 国内开发者在拉取 Docker 官方镜像遇到网络阻断或速度过慢时，寻找可用的替代加速节点。
- 运维人员为服务器配置 Docker 或 containerd 的全局镜像加速源。
- 开发者希望利用云服务（如 Cloudflare）或海外服务器自建专属的 Docker 镜像代理与缓存服务。
核心功能
- 可用镜像源列表：收录并定期测试国内仍可访问的 DockerHub 镜像站，包括公益服务节点以及云厂商节点（如 DaoCloud、腾讯云、阿里云等）。
- 失效源追踪：记录已关停、被封锁或下线的镜像仓库地址，帮助开发者排查网络拉取失败的原因。
- 环境配置指南：提供针对 Docker daemon 和 containerd 的 registry mirror 配置文件修改示例。
- 自建方案与工具汇总：收集了大量自建 DockerHub 加速服务的教程与开源项目，涵盖基于 Cloudflare Workers、Nginx、CNCF Distribution 以及各类轻量级开源代理工具（如 KSpeeder、hubproxy、Xget 等）的部署方案。
- 多仓库加速支持：除了 DockerHub，还涉及 gcr.io、quay.io、ghcr.io、k8s.gcr.io 等其他常用容器镜像仓库的加速资源。
特色与差异点
- 时效性强：项目维护活跃，明确标注亲测可用的更新时间，及时剔除失效链接以保证高可用性。
- 方案全面：不仅提供现成的公共加速源，还授人以渔，汇总了丰富的自建代理方案，满足不同动手能力和隐私需求的用户。
- 社区认可度高：在 GitHub 上拥有超过 7300 颗 Star，是国内开发者解决容器镜像拉取难题的重要参考指南。
使用方式概览
- 全局配置：通过修改系统的
/etc/docker/daemon.json或/etc/containerd/config.toml文件，将获取到的可用镜像加速器地址加入镜像列表，重载并重启对应服务即可全局生效。 - 直接拉取：在
docker pull命令中，直接将官方域名前缀替换为代理站点的域名进行拉取（例如docker pull <代理域名>/library/<镜像名>）。
限制与注意事项
- 镜像完整性限制：部分公益镜像站仅提供基础镜像或白名单镜像，若某个地址无法拉取所需镜像，需尝试切换其他节点。
- 访问限制：部分云厂商镜像（如腾讯云）仅支持内网访问加速，不支持外网调用；部分节点（如 1panel 提供的节点）限制仅限中国地区访问。
- 合理使用：许多代理站点由热心网友自费搭建，资源有限，使用者需合理控制请求频率和流量，避免滥用导致节点关停。
- 合规边界：本仓库仅做项目信息归档，不复述可操作细节、命令、脚本片段或下载镜像直链。