简介

GitHub Container Registry（ghcr.io）是 GitHub 官方的容器镜像仓库，大量开源项目、AI 项目、K8s 组件（如 Tailscale、Open WebUI、K3s）都将镜像托管于此。镜像地址格式为：

1

ghcr.io/<用户|组织>/<镜像>:<tag>

例如 ghcr.io/open-webui/open-webui:main。由于网络原因，国内直接 docker pull ghcr.io/xxx 经常超时、连接被拒或拉取极慢。

易错点：ghcr.io ≠ gcr.io。前者归属 GitHub，后者归属谷歌云，加速源不可混用。

登录 ghcr.io

私有镜像或避免匿名限流时，需先登录：

1

docker login ghcr.io -u <用户名>

密码使用 GitHub Personal Access Token（PAT），需勾选 read:packages 权限。也可脚本化登录：

1

echo "<your-token>" | docker login ghcr.io -u <用户名> --password-stdin

官方源拉取

1

docker pull ghcr.io/org/image:tag

若网络受限阻塞，请改用下方加速方案。

加速方案

以下加速源可用性请以 容器镜像加速器监控（1Panel） 实时状态为准（2026-07-19 监控的健康 ghcr 源：ghcr.1ms.run、ghcr.m.ixdev.cn、ghcr.m.daocloud.io、ghcr.dockerproxy.net、xxx-ghcr.xuanyuan.run）。

方案一：前缀替换（临时、最简单）

适合单次下载、不想改全局配置。规则：将原地址中的 ghcr.io 替换为加速域名即可。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 原生慢速命令（国内大概率超时）
docker pull ghcr.io/open-webui/open-webui:main

# 南京大学开源镜像站（高校公益源，稳定）
docker pull ghcr.nju.edu.cn/open-webui/open-webui:main

# 毫秒镜像（免费公开，延迟低）
docker pull ghcr.1ms.run/open-webui/open-webui:main

# DaoCloud 公共加速
docker pull ghcr.m.daocloud.io/open-webui/open-webui:main

优点：零配置、即用即走；缺点：每次拉取都要手动改前缀，不适合长期批量部署。南京大学镜像源用法详见 知乎实记 与 过客博客。

Dockerfile 中同理，将 FROM ghcr.io/... 改为：

1

FROM ghcr.nju.edu.cn/open-webui/open-webui:main

方案二：Docker 全局永久加速（单机服务器、1Panel 首选）

修改 Docker 守护进程配置，全局代理所有 ghcr.io 请求，之后直接用原生 docker pull ghcr.io/xxx 即可自动走加速通道。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://ghcr.1ms.run",
    "https://ghcr.nju.edu.cn",
    "https://ghcr.m.daocloud.io"
  ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

校验是否生效：

1

docker info

输出中能看到上面配置的加速地址即为成功。使用 1Panel 面板的用户，可在「容器 → Docker 配置 → 镜像加速器」处填入 https://ghcr.1ms.run,https://ghcr.nju.edu.cn 后保存重启。参考 烙馍网 2026 ghcr 加速教程。

方案三：containerd / K8s 集群加速（k3s、容器集群必看）

K8s、k3s 默认使用 containerd 而非 Docker，改 Docker 配置无效，需为 ghcr.io 单独配置域名分流。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 创建 ghcr 专属分流目录
mkdir -p /etc/containerd/certs.d/ghcr.io

# 写入加速路由规则
tee /etc/containerd/certs.d/ghcr.io/hosts.toml << 'EOF'
server = "https://ghcr.io"

[host."https://ghcr.1ms.run"]
  capabilities = ["pull", "resolve"]
EOF

# 重启 containerd 生效
systemctl restart containerd

原理：containerd 访问 ghcr.io 时自动转发至国内加速节点，集群 YAML 中无需修改镜像地址。完整配置模板见 Hugh-yw/Mirror-acceleration。

方案四：自建 Harbor 反向代理（企业内网生产环境）

多节点内网集群或开发团队，公共加速源不稳定时，推荐自建 Harbor 私有仓库并开启「镜像代理缓存」：

  1. Harbor 新建仓库，类型选择「代理」；
  2. 远端仓库填写 https://ghcr.io；
  3. 内网节点统一拉取 Harbor 缓存镜像，一次拉取、全网复用。

优势：可控性最高、带宽最优，适合公司生产 K8s 集群长期使用。

关键避坑：registry-mirrors 对 ghcr 不生效

daemon.json 里的 registry-mirrors 只对 Docker Hub（docker.io）生效。对于 ghcr.io 等非 Docker Hub 的 Registry，Docker 客户端不会查询 registry-mirrors，而是直接向官方域名发起请求。

典型现象（构建日志仍走官方源，耗时极长）：

1
2

#21 [backend] FROM ghcr.io/astral-sh/uv:0.9.26@sha256:9a23023b...
#21 sha256:5b10ebfb... 14.68MB / 23.02MB 631.4s

正确做法：在命令或 Dockerfile 中显式替换域名（见方案一、方案二），或在 containerd 中做域名分流（方案三）。详见 轩辕镜像 ghcr 教程 FAQ。

若仅需加速 Docker Hub，可参考 腾讯云 2026 Docker 镜像源清单 配置通用镜像，例如一键脚本 bash <(wget -qO- https://xuanyuan.cloud/docker.sh)。

跨平台配置说明

  • Linux：如上编辑 /etc/docker/daemon.json 后 systemctl restart docker。
  • macOS（Docker Desktop）：顶栏 Docker 图标 → Settings → Docker Engine，在 registry-mirrors 数组中加入加速地址，点击 Apply & Restart。
  • Windows（Docker Desktop）：右下角右键 Docker 图标 → Settings → Docker Engine，将加速地址加入 registry-mirrors 数组，点击 Apply 生效。

结束语

以上方案整理自网络及 1Panel 镜像监控状态。镜像加速源多由社区或第三方提供，可能随时失效或限速，建议定期核对可用性并优先选择高校公益源（如南京大学）或合规企业源。

参考引用