GitHub热门项目！HubProxy：Docker+GitHub加速神器，一个服务搞定所有镜像拉取！

朋友们！Docker镜像拉取太慢？GitHub下载不了？#

做开发的朋友应该都遇到过这种情况：拉取Docker镜像半天不动，GitHub Release下载超时，Hugging Face模型下载失败…换了各种免费加速服务，要么不稳定，要么限流。好家伙，今天给大家介绍一个神器——HubProxy！一个服务搞定Docker镜像加速、GitHub文件加速、离线镜像下载，完全自托管，再也不用担心依赖第三方服务了！

📚 项目介绍#

HubProxy 是一个轻量级、高性能的多功能代理服务，基于Go语言开发，单二进制文件运行，资源占用极低。它提供Docker镜像加速、GitHub文件加速、离线镜像下载、在线搜索Docker镜像等功能，支持Docker Hub、GHCR、Quay等多个镜像仓库，是开发人员必备的加速工具！

核心特点#

🐳 Docker镜像加速：支持Docker Hub、GHCR、Quay、gcr.io、registry.k8s.io等多个镜像仓库，流式传输优化拉取速度
📁 GitHub文件加速：加速GitHub Release、Raw文件下载，支持api.github.com，脚本嵌套加速
📦 离线镜像包：支持下载离线镜像包，流式传输加防抖设计，方便离线部署
🤖 AI模型库支持：支持Hugging Face模型下载加速，训练大模型不再愁
🛡️ 智能限流：IP限流保护，防止滥用，支持白名单和黑名单
🔍 镜像搜索：在线搜索Docker镜像，快速找到需要的镜像
⚡ 轻量高效：基于Go语言，单二进制文件运行，资源占用低
🔧 统一配置：统一配置管理，便于维护
🛡️ 完全自托管：避免依赖免费第三方服务的不稳定性
🚀 多服务统一加速：单个程序即可统一加速Docker、GitHub、Hugging Face等多种服务

🚀 部署方式#

方式一：Docker部署（推荐）#

1
docker run -d \
2
  --name hubproxy \
3
  -p 5000:5000 \
4
  --restart always \
5
  ghcr.io/sky22333/hubproxy

方式二：Docker Compose#

1
version: '3.8'
2
services:
3
  hubproxy:
4
    image: ghcr.io/sky22333/hubproxy
5
    container_name: hubproxy
6
    ports:
7
      - "5000:5000"
8
    environment:
9
      - SERVER_PORT=5000
10
      - ENABLE_FRONTEND=true
11
      - IP_WHITELIST=127.0.0.1,192.168.1.0/24
12
    volumes:
13
      - ./config:/etc/hubproxy
14
    restart: always

方式三：脚本安装#

自动识别系统与架构，从GitHub Releases下载对应的安装包：

1
curl -fsSL https://raw.githubusercontent.com/sky22333/hubproxy/main/install.sh | sh

安装完成后，服务会自动启动。

🎯 使用指南#

Docker镜像加速#

方式一：直接使用加速地址

1
# 原命令
2
docker pull nginx
3

4
# 使用加速
5
docker pull yourdomain.com/nginx
6

7
# GHCR加速
8
docker pull yourdomain.com/ghcr.io/sky22333/hubproxy

方式二：配置为全局镜像加速

编辑 /etc/docker/daemon.json 文件：

1
{
2
  "registry-mirrors": [
3
    "https://yourdomain.com"
4
  ]
5
}

保存后重启Docker服务：

1
sudo systemctl restart docker

GitHub文件加速#

1
# 原链接
2
https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz
3

4
# 加速链接
5
https://yourdomain.com/https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz
6

7
# 加速下载仓库
8
git clone https://yourdomain.com/https://github.com/sky22333/hubproxy.git

Hugging Face模型加速#

1
# 原链接
2
https://huggingface.co/user/model/resolve/main/model.bin
3

4
# 加速链接
5
https://yourdomain.com/https://huggingface.co/user/model/resolve/main/model.bin

离线镜像下载#

1
# 下载单个镜像
2
curl -X POST http://yourdomain.com/api/download \
3
  -H "Content-Type: application/json" \
4
  -d '{"images": ["nginx:latest", "ubuntu:22.04"]}'
5

6
# 下载多个镜像
7
curl -X POST http://yourdomain.com/api/download \
8
  -H "Content-Type: application/json" \
9
  -d '{"images": ["ghcr.io/sky22333/hubproxy:latest", "redis:alpine"]}'

镜像搜索#

1
# 搜索镜像
2
curl http://yourdomain.com/api/search?q=nginx
3

4
# 搜索结果示例
5
{
6
  "results": [
7
    {
8
      "name": "nginx",
9
      "description": "Official build of Nginx.",
10
      "stars": 18000,
11
      "pulls": 1000000000
12
    }
13
  ]
14
}

📊 对比其他方案#

功能	HubProxy	免费第三方加速	Cloudflare Workers
Docker镜像加速	✅ 多仓库支持	✅ 部分支持	❌
GitHub文件加速	✅	✅	✅
离线镜像下载	✅	❌	❌
AI模型加速	✅	❌	❌
智能限流	✅	❌	❌
仓库审计	✅	❌	❌
完全自托管	✅	❌	❌
稳定性	✅ 自建可控	❌ 不稳定	⚠️ 限流

💡 使用场景#

开发团队：统一加速服务#

在团队中部署一个HubProxy服务，所有成员共享使用。无需每个人都配置不同的加速地址，统一管理，方便维护。同时智能限流保护服务不被滥用。

CI/CD流水线：加速构建过程#

在CI/CD流水线中使用HubProxy加速Docker镜像拉取和GitHub资源下载，大幅缩短构建时间，提升开发效率。

离线部署：下载离线镜像包#

在无法访问外网的环境中，可以先使用HubProxy下载离线镜像包，然后传输到目标环境进行部署。

AI训练：加速模型下载#

训练大模型时，从Hugging Face下载模型文件经常失败。使用HubProxy加速下载，提高下载成功率。

个人开发者：摆脱加速依赖#

作为个人开发者，不再依赖不稳定的免费第三方加速服务，自己部署一个稳定可靠的加速服务。

📝 我的使用感受#

部署HubProxy后，我再也没有遇到过Docker镜像拉取失败的问题了！以前拉取ghcr.io的镜像经常超时，现在秒速完成。GitHub Release下载也快了很多，特别是下载大文件的时候。

最让我惊喜的是离线镜像下载功能，有时候需要在没有外网的环境部署，这个功能简直太实用了！

配置也很简单，一行Docker命令就能启动，默认配置已经很好用了。如果需要自定义，修改config.toml文件即可。

🎯 总结#

HubProxy是一款非常强大的加速代理服务，完全免费、开源。Docker镜像加速、GitHub文件加速、离线镜像下载、AI模型加速…一个服务搞定所有加速需求！如果你是开发人员、运维人员，或者经常遇到镜像拉取慢、文件下载失败的问题，HubProxy绝对值得一试！

📌 项目资源#

GitHub地址: https://github.com/sky22333/hubproxy

Docker镜像: ghcr.io/sky22333/hubproxy

推荐阅读:

如果您觉得这篇文章有帮助，请为小王点点推荐，谢谢！🌹