当前位置：首页 > web >正文

【开源项目】轻量加速利器 HubProxy 自建 Docker、GitHub 下载加速服务

web 2025/8/1 1:13:28

引言
如果你经常被 Docker 镜像拉取、GitHub 文件下载的龟速折磨，又不想依赖第三方加速服务（担心稳定性或隐私），今天分享的 HubProxy 可能正是你需要的。这个开源工具用一行命令就能部署，以极低资源消耗（内存 18MB）提供多场景加速，实测效果显著。下面从功能到部署，带你快速上手。

在这里插入图片描述

一、HubProxy 能做什么？

Docker 镜像加速
支持 Docker Hub、GitHub Container Registry (GHCR)、Quay.io 等主流仓库。只需在原始镜像名前拼接你的代理域名，例如：
```
# 加速 Docker Hub 官方镜像
docker pull yourdomain.com/nginx# 加速 GHCR 镜像
docker pull yourdomain.com/ghcr.io/sky22333/hubproxy
```
原理：通过流式传输优化拉取流程，无需缓存镜像，节省磁盘空间。

GitHub 文件加速
解决 Releases/Raw 文件下载慢的问题：

# 原始链接
https://github.com/user/repo/releases/download/v1.0.0/file.tar.gz# 加速链接（域名后直接拼接原链接）
https://yourdomain.com/https://github.com/.../file.tar.gz

支持嵌套脚本加速（如 curl | bash 中的 GitHub 链接）。

离线镜像包下载
点击即可流式下载镜像的离线包（.tar），适用于内网或无 Docker 环境：
```
# 通过代理域名 + 镜像名生成离线包链接
https://yourdomain.com/v2/library/nginx/tags/latest?format=tar
```
防抖设计避免重复请求。
其他实用功能
- Hugging Face 模型加速：AI 开发者无需额外配置，直接代理下载链接
- 镜像搜索：直接网页搜索 Docker 官方镜像信息
- 安全审计：IP 限流、黑白名单、仓库访问日志（防止滥用）

二、为什么选择自建？

隐私可控：所有流量经过自己的服务器，避免第三方记录
灵活定制：支持自定义限流规则、上游代理（如走公司内网代理）
资源占用极低：单二进制文件（12MB），内存占用稳定在 18MB 左右
无厂商绑定：避免公共加速服务突然停用或限速

三、快速部署指南

方案 1：Docker 部署（推荐）

docker run -d \--name hubproxy \-p 5000:5000 \          # 暴露 5000 端口--restart always \ghcr.io/sky22333/hubproxy

验证：访问 http://服务器IP:5000 出现加速服务页面即成功。

方案 2：一键脚本安装（物理机/虚拟机）

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

脚本自动完成：

检测系统架构（AMD64/ARM64）
下载最新二进制文件
配置 systemd 服务（开机自启）
日志目录 /var/log/hubproxy

四、进阶配置示例

配置文件路径：/opt/hubproxy/config.toml（安装后自动生成）

# 限制每个 IP 每小时 1000 次请求
[ratelimit]  
requests_per_hour = 1000  # 配置上游代理（如服务器本身需科学上网）
[proxy]  
upstream = "socks5://192.168.1.100:1080"  # 设置 IP 白名单（绕过限流）
[security]  
whitelist = ["192.168.1.0/24"]  # 禁止访问某 Docker 镜像（支持通配符）
[registries_audit]  
docker_blacklist = ["library/redis*"]

反向代理配置（Caddy 示例）：
若用 Nginx/Caddy 转发流量，需传递真实 IP 以保证限流生效：

example.com {reverse_proxy {to 127.0.0.1:5000header_up X-Real-IP {remote}header_up X-Forwarded-For {remote}header_up X-Forwarded-Proto {scheme}}
}

五、实测效果与避坑

速度对比：北京测试节点拉取 nginx:latest，未加速平均 200KB/s，加速后提升至 8MB/s（依赖服务器带宽）
稳定性建议：
- 部署服务器优先选 海外节点（如香港、新加坡）
- 避免代理大文件下载（易触发 GitHub 限流）
- 定期更新（项目迭代较快，关注 GitHub 发布页）