??引言??
如果你經常被 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 發布頁）
總結
HubProxy 以簡潔的設計解決了開發者高頻痛點：輕量（18MB 內存）、開箱即用、功能覆蓋全面。相比搭建 Nexus 或 Artifactory 等重型倉庫，它更適合個人或小團隊快速構建專屬加速服務。如果你正被網絡問題拖慢效率，花 5 分鐘部署它，可能帶來意想不到的順暢體驗。
項目地址：https://github.com/sky22333/hubproxy
往期回顧：
🔥【開源項目】初中生開源神作！BiliTools 能下8K視頻、高質量音頻，支持AI總結的全能工具
🔥【開源項目】拆解機器學習全流程：一份GitHub手冊的工程實踐指南
🔥【開源項目】網絡診斷告別命令行！NetSonar：開源多協議網絡診斷利器
