HubProxy：一站式 Docker镜像 & GitHub仓库加速神器

简介

在云原生时代， Docker 已经成为开发者的必备工具。然而，由于网络环境的限制，从Docker Hub拉取镜像时经常遇到速度慢、连接超时等问题，严重影响开发效率。今天给大家介绍一个轻量级的解决方案—— HubProxy ，一个基于Go语言开发的多功能代理加速服务。

什么是HubProxy？

HubProxy 是一个自托管的轻量级、高性能多功能代理服务器，专门用于解决 Docker 镜像拉取和 GitHub 文件下载的网络问题。它不仅支持 Docker 镜像加速，还提供 GitHub 文件加速、AI模型库支持等功能，真正实现了"一站式"的网络加速解决方案。

核心功能特性

🐳 Docker镜像加速

多仓库支持：单域名实现Docker Hub、GHCR、Quay等多个镜像仓库加速
流式传输：优化拉取速度，无缓存设计避免磁盘空间占用
离线镜像包：支持批量下载离线镜像包，配备防抖设计

📁 GitHub文件加速

全方位加速：支持GitHub Release、Raw文件下载
API支持：完美支持api.github.com
脚本嵌套：支持脚本嵌套加速等高级功能

🤖 AI模型库支持

Hugging Face加速：支持AI模型下载加速，满足机器学习开发需求

🛡️ 安全与管理

智能限流：IP限流保护，防止滥用
仓库审计：强大的自定义黑白名单系统
镜像搜索：在线搜索Docker镜像功能

技术优势

轻量高效

基于Go语言：单二进制文件运行，启动速度快
资源占用低：初始内存占用约18M，二进制文件仅12M
优雅设计：内置内存清理机制，长期运行稳定

配置简单

零配置启动：内置默认配置，无需额外配置文件
统一配置管理：支持TOML格式配置文件
热更新支持：配置修改后无需重启服务

快速部署

Docker部署（推荐）

docker run -d \--name hubproxy \-p 5000:5000 \--restart always \ghcr.io/sky22333/hubproxy

脚本一键部署

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

这个命令会自动：

检测系统架构（AMD64/ARM64）
从GitHub Releases下载最新版本
自动配置系统服务
保留现有配置（升级时）

效果预览

使用示例

Docker镜像加速

# 原命令docker pull nginx

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

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

GitHub文件加速

# 原链接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

高级配置

HubProxy提供了丰富的配置选项，包括：

限流配置

每个IP每小时请求数限制
可配置的限流周期
白名单IP不受限流限制

安全配置

IP黑白名单支持
仓库级别的访问控制
支持通配符匹配

代理配置

支持SOCKS5/HTTP代理
支持用户名密码认证
灵活的上游代理配置

反向代理配置

为了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}    }}