DOCKER HUB · MIRROR GUIDE

让镜像拉取,
简单一点。

用一个地址访问 Docker Hub 公开镜像。可以直接拉取,也可以把它设为 Docker 的默认镜像加速地址。

免登录使用只读 · 公开镜像广州服务器实测通过 · 2026.11.03
镜像加速地址https://dk.igzx.cc

01先拉一个镜像试试

已安装并启动 Docker?无需修改配置,先在终端执行下面的命令。Windows 使用 PowerShell,macOS 和 Linux 使用终端。

直接拉取 · 所有系统通用
docker pull dk.igzx.cc/library/alpine:latest

看到 Pull complete 和 Downloaded newer image,或 Image is up to date,就表示成功。

Docker 官方镜像

加上 library/,例如 dk.igzx.cc/library/nginx:latest。

其他公开镜像

保留作者和仓库名,格式为 dk.igzx.cc/作者名/镜像名:标签。

直接拉取后的本地名称带有域名前缀。运行时也使用完整名称,例如 docker run --rm dk.igzx.cc/library/alpine:latest echo OK。

02设为默认镜像加速地址

配置后,日常仍可使用 docker pull nginx:latest,无需每次手动添加域名。请选择你的系统。

Docker Desktop · Windows

  1. 启动 Docker Desktop,使用 Linux containers 模式。
  2. 点击右上角齿轮 Settings,进入 Docker Engine。
  3. 在现有 JSON 配置中添加或修改 registry-mirrors。下面是最小配置示例:
Docker Engine · JSON
{
  "registry-mirrors": ["https://dk.igzx.cc"]
}

保留已有的其他配置,只合并这个字段;如果已经有 registry-mirrors,就编辑原来的数组,不要重复添加同名字段。JSON 不支持注释或末尾多余的逗号。

  1. 点击 Apply & restart,等待 Docker 启动完成。
  2. 打开 PowerShell,执行下方“验证与检查”中的命令。

如果你是在 WSL 内单独安装 Docker Engine,而非使用 Docker Desktop,请按 Linux 方法配置。此服务面向 Docker Hub 镜像,不是 Microsoft 容器仓库 mcr.microsoft.com 的加速器。

03验证与检查

重启完成后,先确认配置被 Docker 读取,再尝试正常拉取。

PowerShell / Terminal · 检查配置
docker info --format '{{json .RegistryConfig.Mirrors}}'
docker pull alpine:latest

第一条输出应包含 https://dk.igzx.cc。默认拉取可能在镜像失败时回退到 Docker Hub;若想明确验证本服务,请使用第一节带域名的直接拉取命令。

2026 年 11 月 3 日,已在广州腾讯云服务器完成 Alpine 镜像全量拉取与解压;当时 Docker 和终端均未配置出站代理。此记录不代表所有运营商或未来时段的可用性。

04使用前,你可能还想知道

本地不能访问 Google,为什么仍可能用得上?

你的 Docker 只连接 dk.igzx.cc,Cloudflare 再访问上游。镜像层也由本域名转发,不会把客户端下载地址重定向到 Google。服务优先请求 Google 官方 Docker Hub 缓存,缓存未命中时尝试 Docker Hub;无需在本地配置 mirror.gcr.io。

支持哪些镜像?需要登录吗?

免登录,只支持 Docker Hub 的公开镜像拉取,不支持私有镜像、推送、仓库搜索或标签列表。不代理 ghcr.io、quay.io、mcr.microsoft.com 等其他仓库。某些未缓存或较冷门的镜像仍可能受到上游限流影响。

出现 429、TOOMANYREQUESTS 怎么办?

这是上游拉取限流。等待后再试,或使用已经拉到本地的镜像。代理不能保证覆盖所有镜像,也不能消除 Docker Hub 的拉取限制。

连接超时,或者配置后仍然拉取失败?

先确认 Docker 正在运行,再执行带 dk.igzx.cc 前缀的直接拉取命令。若直接拉取成功而默认拉取失败,检查 Docker Engine 的配置是否保存、重启,以及当前 Docker context 是否指向另一台机器。若直接拉取也失败,可能是当前网络或上游连接波动,可稍后重试。不要通过关闭 HTTPS 证书验证来解决问题。

Docker build / Buildx 为什么可能没有使用这个地址?

独立的 BuildKit builder 可能有自己的镜像源设置,不一定继承 Docker Engine 的 registry-mirrors。请按 Docker 官方 BuildKit 文档单独配置;本页步骤主要用于 Docker Engine 的 docker pull。

如何撤销配置?

从 registry-mirrors 数组中移除 https://dk.igzx.cc,保留其余配置,保存后重启 Docker。无需删除已经下载的镜像。