让镜像拉取,
简单一点。
用一个地址访问 Docker Hub 公开镜像。可以直接拉取,也可以把它设为 Docker 的默认镜像加速地址。
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
- 启动 Docker Desktop,使用 Linux containers 模式。
- 点击右上角齿轮 Settings,进入 Docker Engine。
- 在现有 JSON 配置中添加或修改
registry-mirrors。下面是最小配置示例:
{
"registry-mirrors": ["https://dk.igzx.cc"]
}保留已有的其他配置,只合并这个字段;如果已经有 registry-mirrors,就编辑原来的数组,不要重复添加同名字段。JSON 不支持注释或末尾多余的逗号。
- 点击 Apply & restart,等待 Docker 启动完成。
- 打开 PowerShell,执行下方“验证与检查”中的命令。
如果你是在 WSL 内单独安装 Docker Engine,而非使用 Docker Desktop,请按 Linux 方法配置。此服务面向 Docker Hub 镜像,不是 Microsoft 容器仓库 mcr.microsoft.com 的加速器。
Docker Desktop · macOS
- 启动 Docker Desktop,点击菜单栏 Docker 图标或窗口中的齿轮,打开 Settings。
- 进入 Docker Engine。
- 在现有 JSON 中合并下面的字段:
{
"registry-mirrors": ["https://dk.igzx.cc"]
}保留现有其他设置;已有 registry-mirrors 时修改原数组。不要直接用最小示例覆盖整份配置。
- 点击 Apply & restart。
- 等待 Docker 启动完成,在“终端”中执行下方验证命令。
适用于 Intel 和 Apple Silicon。Docker 会按镜像支持情况选择对应架构;镜像加速不会让不支持 ARM 的镜像自动兼容 ARM。本步骤针对 Docker Desktop,不适用于 Colima 或其他独立运行环境。
Docker Engine · Linux
以下适用于常见的系统级 Docker Engine 和 systemd 环境。
- 创建配置目录,并备份已有配置:
sudo mkdir -p /etc/docker
if [ -f /etc/docker/daemon.json ]; then
sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak.$(date +%Y%m%d%H%M%S)
fi
sudo nano /etc/docker/daemon.json- 在文件中添加或合并下面的字段,然后保存退出。使用 nano 时,按 Ctrl+O、回车保存,再按 Ctrl+X 退出。
{
"registry-mirrors": ["https://dk.igzx.cc"]
}已有文件时保留其他配置。重启 Docker 可能影响正在运行的容器,请安排合适时间。
- 校验配置,通过后再重启:
sudo dockerd --validate --config-file=/etc/docker/daemon.json && sudo systemctl restart docker无 nano 时可使用其他文本编辑器。Rootless Docker 默认配置为 ~/.config/docker/daemon.json,或 $XDG_CONFIG_HOME/docker/daemon.json;重启使用 systemctl --user restart docker。Rootless 环境不要修改系统级配置。
03验证与检查
重启完成后,先确认配置被 Docker 读取,再尝试正常拉取。
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。无需删除已经下载的镜像。