HuggingFace-docker-ghrc加速下载法
国内镜像加速地址整理
Hugging Face 加速
- 镜像站：
hf-mirror.com - 使用方法：将
huggingface.co替换为hf-mirror.com
示例：
原地址：https://huggingface.co/bartowski/Qwen2.5-Coder-14B-Instruct-GGUF/blob/main/Qwen2.5-Coder-14B-Instruct-Q4_K_M.gguf
加速后：https://hf-mirror.com/bartowski/Qwen2.5-Coder-14B-Instruct-GGUF/blob/main/Qwen2.5-Coder-14B-Instruct-Q4_K_M.ggufGitHub 加速
Git Clone 加速
- 使用
ghfast.top前缀
示例：
git clone https://ghfast.top/https://github.com/kijai/ComfyUI-KJNodes.git通用 GitHub 镜像源
https://gh-proxy.com/https://mirror.ghproxy.com/https://ghgo.xyz/
示例（下载 Release 文件）：
原地址：https://github.com/sdbds/SageAttention-for-windows/releases/download/torch2100%2Bcu130/sageattention-2.2.0+cu130torch2.10.0-cp311-cp311-win_amd64.whl.whl
加速后：https://ghfast.top/https://github.com/sdbds/SageAttention-for-windows/releases/download/torch2100%2Bcu130/sageattention-2.2.0+cu130torch2.10.0-cp311-cp311-win_amd64.whl.whlDocker 镜像加速
Docker Hub 加速
- 镜像站：
docker.1ms.run
使用方式：
# 正常搜索（需配置镜像）
docker search nginx
# 直接拉取时替换地址
docker pull docker.1ms.run/library/nginx:latestGitHub Container Registry (ghcr.io) 加速
- 镜像站：
ghcr.1ms.run
示例：
docker pull ghcr.1ms.run/luzifer/ots:latest说明：
- 以上镜像站均为第三方提供的国内加速服务，使用时请遵守相关服务条款
- 部分地址可能需要根据实际网络环境选择最佳镜像源
- 建议在需要加速的场景下临时替换使用
docker.io和ghcr.io核心区别一览
| 特性 | docker.io (Docker Hub) | ghcr.io (GitHub Container Registry) |
|---|---|---|
| 运营主体 | Docker Inc. | GitHub (微软) |
| 镜像地址 | docker.io 或省略 (如 ubuntu:latest) | ghcr.io (必须完整写出) |
| 认证方式 | Docker ID 账号密码 | GitHub 个人访问令牌 (PAT) |
| 与代码的关联 | 独立，需手动关联 | 无缝集成，可直接关联到GitHub仓库 |
| 拉取速率限制 | 较严格，匿名用户限制多 | 对公共镜像无硬性拉取限制 |
| 镜像保留策略 | 长期不活跃的免费镜像可能被删除 | 无镜像过期策略，只要仓库存在，镜像就保留 |
| 国内拉取速度 | 有众多国内镜像加速器可用 | 普遍反馈速度较慢，尤其是在某些地区 |
详细解读
1. 认证与权限：账号 vs 令牌
使用 Docker Hub 通常只需注册一个 Docker ID 并用 docker login 登录。而使用 GHCR 则必须使用 GitHub 个人访问令牌 (Personal Access Token, PAT) 作为密码登录 。这个令牌需要在 GitHub 设置中生成，并至少勾选 write:packages 权限才能推送镜像 。
2. 仓库地址与命名
docker.io：这是 Docker 官方的默认仓库。当你执行docker pull ubuntu时，Docker 会自动补全为docker.io/library/ubuntu。ghcr.io：命名空间通常包含你的 GitHub 用户名或组织名，例如ghcr.io/你的用户名/你的镜像名:标签。
3. 使用场景建议
什么时候优先选择
docker.io？- 拉取官方基础镜像，如
python,node,nginx等。 - 在国内服务器或网络环境下，因为可以方便地配置镜像加速器，拉取速度会快很多 。
- 拉取官方基础镜像，如
什么时候优先选择
ghcr.io？- 你的代码和 CI/CD 流程都放在 GitHub 上，希望实现 从代码提交到镜像构建推送的全自动化 。
- 你的项目对拉取速率有较高要求，或者担心在 Docker Hub 上免费镜像因长期不活跃而被删除 。
- 出于供应链安全考虑，希望将镜像与代码存放在同一个生态系统内，减少外部依赖 。
4. 一个特别的关注点：拉取速度
这是两者一个重要的实际体验差异。Docker Hub 在国内通常可以找到很多镜像加速器来提升速度。但根据大量用户反馈，从国内或某些地区拉取 ghcr.io 上的镜像，速度可能会非常慢，这甚至成为了一个普遍现象 。如果你的服务器位于国内，在选择使用 GHCR 时需要特别注意这一点。
总结
docker.io：像一个公共图书馆，藏书最多（官方镜像最全），去的人也多（使用广泛），但会有一些访问限制，且在国内有“分馆”（镜像加速器）。ghcr.io：像一个私人会所，与你的 GitHub 代码库深度绑定，环境更私密、策略更宽松（速率限制少），但在国内访问可能会不太顺畅。