GitHub Container Registry（ghcr.io）镜像拉取与加速配置教程
教程简介
适用场景
1官方源拉取
使用仓库官方域名直接拉取镜像。
2轩辕专属域名拉取
使用轩辕镜像加速拉取 GHCR（ghcr.io） 需先开通专属域名。点击下方「显示专属域名」按钮获取对应前缀，再替换下方命令中的专属域名。 专属域名是什么？如何开启？ →
格式 ***.xuanyuan.run
将 ***-ghcr.xuanyuan.run 替换为你的 GHCR 专属域名
3常见问题：配置了 daemon.json 仍然很慢？
Q：为什么 daemon.json 已配置 ***-ghcr.xuanyuan.run，拉取 ghcr.io/astral-sh/uv:0.9.26 依然很慢？
不少用户在 Windows、Linux 或 macOS 上执行 docker compose build、docker build 或 docker pull 时， 已在 daemon.json 的 registry-mirrors 中加入轩辕专属域名， 但构建日志仍显示从 ghcr.io 拉取且耗时很长。
典型现象（构建日志仍走官方源）：
#21 [backend] FROM ghcr.io/astral-sh/uv:0.9.26@sha256:9a23023b... #21 sha256:5b10ebfb... 14.68MB / 23.02MB 631.4s
A：daemon.json 中的镜像加速仅对 docker.io 生效，ghcr.io 需显式使用专属域名
registry-mirrors 只作用于 docker.io（Docker Hub 官方仓库）。对于 ghcr.io 等非 Docker Hub 的 Registry，Docker 客户端不会查询 registry-mirrors，而是直接向官方域名发起请求。
例如执行以下命令时，Docker 不会自动走镜像加速：
Dockerfile 中写 FROM ghcr.io/... 时同理——构建阶段仍会访问官方源。
正确做法：在命令或 Dockerfile 中显式使用轩辕专属域名
将官方域名替换为专属域名后再拉取或构建。点击上方「显示专属域名」按钮即可查看：
Dockerfile 示例：
将 ***-ghcr.xuanyuan.run 替换为你的专属域名。点击上方「显示专属域名」按钮即可查看。了解更多 registry-mirrors 原理 →
