HubProxy：两条命令自建 GitHub 文件加速服务
【免费下载链接】hub-proxy多功能加速服务，支持Docker 镜像加速、GitHub 加速、下载离线镜像等功能。轻量级，不占用存储空间。项目地址: https://gitcode.com/gh_mirrors/hu/hub-proxy
下载 Release 慢如蜗牛，git clone 半天转圈，Raw 文件直接超时。多半不是项目的锅，是线路的锅。HubProxy 是一个自托管的 GitHub 文件加速服务，把它架在一台海外带宽好的服务器上，域名指过去，Release 包、Raw 文件、仓库克隆就都走你自己的线路，适合经常要拉 GitHub 资源的开发者和运维。
什么人会遇上 GitHub 文件加速需求
最常见的场景是办公室网络或公共带宽上：几个 MB 的 Release 包拉半个钟，进度条卡死报超时；git clone 一个中型仓库，卡在 "Resolving" 上不动；直接看源码文件，raw.githubusercontent.com 偶尔超时。碰到这些情况，GitHub Release 下载慢就是常态而不是意外。
HubProxy 接管三类资源：Release 资产、Raw 文件（blob 页面链接也会自动转成 raw），以及仓库克隆。它顺带支持 Docker 镜像和 Hugging Face 模型文件，有需要可以一起加。
🐳 自托管加速服务部署：Docker 还是安装脚本
有 Docker 环境，一条命令：
docker run -d \ --name hubproxy \ -p 5000:5000 \ --restart always \ ghcr.io/sky22333/hubproxy适合已经在跑 Docker 的服务器。跑完监听 5000 端口，进程挂了自动拉起。
没有 Docker，用安装脚本：
curl -fsSL https://raw.githubusercontent.com/sky22333/hubproxy/main/install.sh | sh适合只有 apt、dnf 或 apk 的裸机系统。脚本自动识别架构（amd64/arm64），装对应安装包并注册 systemd 服务，配置文件落在 /etc/hubproxy/config.toml。
部署完用curl http://127.0.0.1:5000/ready验证，有响应就通了。
📦 加速链接怎么拼：一条规则覆盖三类资源
规则只有一句：把原 GitHub 链接原样拼在你的 HubProxy 域名后面。
以 Release 包为例：
原链接： https://github.com/owner/repo/releases/download/v1.0.0/app.tar.gz 加速链接： https://yourdomain.com/https://github.com/owner/repo/releases/download/v1.0.0/app.tar.gzyourdomain.com 换成你的实际域名。Raw 文件同理，只换原链接。git clone 也一样：
git clone https://yourdomain.com/https://github.com/owner/repo.git关键配置：文件大小上限、限流、白名单与端口
配置文件是 /etc/hubproxy/config.toml，最常动的四项：
- fileSize：文件体积上限，默认 2GB，超过直接返回 413。调低防止单个大文件吃满带宽，也可用环境变量 MAX_FILE_SIZE 临时覆盖。
- rateLimit：单 IP 请求额度，默认 3 小时 500 次，改 requestLimit 和 periodHours 就是调额度和周期。
- security.whiteList：IP 白名单，名单里的 IP 跳过限流。把办公出口 IP 加进去，同事批量拉包不会被拦。
- server.port：监听端口，默认 5000，环境变量 SERVER_PORT 优先。
还有一点：套在 Nginx 或 Caddy 后面时，把 X-Real-IP 和 X-Forwarded-For 传进去，否则限流会把所有用户当成同一个 IP。
排查指南：链接失效、看日志、更新
- 链接返回 403 或"无效输入"：先
curl http://127.0.0.1:5000/ready确认服务活着，再检查原链接前是不是漏了域名、有没有拼错。支持的地址是 github.com 的 releases/raw/blob、api.github.com 和 gist。 - 看日志：脚本安装用
journalctl -u hubproxy -f实时跟踪，systemctl status hubproxy看状态。 - 更新：Docker 用户重新拉镜像后
docker restart hubproxy；脚本装的直接重跑安装脚本装最新版。
HubProxy 本身是单个 Go 二进制，不占多少磁盘和内存，个人和小团队架在自己的服务器上正合适。边界也说清楚：加速效果取决于你这台服务器的带宽，它不是免费 CDN；对公网开放前，把限流和白名单配好。
【免费下载链接】hub-proxy多功能加速服务，支持Docker 镜像加速、GitHub 加速、下载离线镜像等功能。轻量级，不占用存储空间。项目地址: https://gitcode.com/gh_mirrors/hu/hub-proxy
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
