HubProxy 自己搭建Docker 和 GitHub 加速代理服务

# HubProxy

🚀 **Docker 和 GitHub 加速代理服务器**

## ✨ 特性

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

## 🚀 快速开始

### Docker部署（推荐）
“`
docker run -d \
–name hubproxy \
-p 5000:5000 \
–restart always \
ghcr.io/sky22333/hubproxy
“`

### 一键脚本安装

“`bash
curl -fsSL https://raw.githubusercontent.com/sky22333/hubproxy/main/install.sh | sudo bash
“`

支持单个二进制文件直接启动，无需其他配置，内置默认配置，支持所有功能。

这个脚本会：
– 🔍 自动检测系统架构（AMD64/ARM64）
– 📥 从 GitHub Releases 下载最新版本
– ⚙️ 自动配置系统服务
– 🔄 保留现有配置（升级时）

## 📖 使用方法

### Docker 镜像加速

“`bash
# 原命令
docker pull nginx

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

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

# 符合Docker Registry API v2标准的仓库都支持
“`

当然也支持配置为全局镜像加速，在主机上新建（或编辑）`/etc/docker/daemon.json`

在 `”registry-mirrors”` 中加入域名：

“`json
{
“registry-mirrors”: [
“https://yourdomain.com”
]
}
“`

若已设置其他加速地址，直接并列添加后保存，再执行 `sudo systemctl restart docker` 重启docker服务让配置生效。

### GitHub 文件加速

“`bash
# 原链接
https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz

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

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

## ⚙️ 配置

容器内的配置文件位于 `/root/config.toml`

脚本部署配置文件位于 `/opt/hubproxy/config.toml`

为了IP限流能够正常运行，反向代理需要传递IP头用来获取访客真实IP，以caddy为例：
“`
example.com {
reverse_proxy {
to 127.0.0.1:5000
header_up X-Real-IP {remote}
header_up X-Forwarded-For {remote}
header_up X-Forwarded-Proto {scheme}
}
}
“`
cloudflare CDN：
“`
example.com {
reverse_proxy 127.0.0.1:5000 {
header_up X-Forwarded-For {http.request.header.CF-Connecting-IP}
header_up X-Real-IP {http.request.header.CF-Connecting-IP}
header_up X-Forwarded-Proto https
header_up X-Forwarded-Host {host}
}
}
“`

> 对于使用nginx反代的用户，Github加速提示`无效输入`的问题可以参见[issues/62](https://github.com/sky22333/hubproxy/issues/62#issuecomment-3219572440)

## ⚠️ 免责声明

– 本程序仅供学习交流使用，请勿用于非法用途
– 使用本程序需遵守当地法律法规
– 作者不对使用者的任何行为承担责任

—

## 界面预览




## Star 趋势
[](https://starchart.cc/sky22333/hubproxy)