HubProxy 实战指南构建高效稳定的 Docker 与 GitHub 文件加速服务【免费下载链接】hub-proxy多功能加速服务支持Docker 镜像加速、GitHub 加速、下载离线镜像等功能。轻量级不占用存储空间。项目地址: https://gitcode.com/gh_mirrors/hu/hub-proxyHubProxy 是一款基于 Go 语言开发的高性能多功能代理服务专门解决国内用户访问 Docker 镜像仓库和 GitHub 资源时的速度瓶颈问题。通过自托管部署HubProxy 能够为 Docker 镜像拉取、GitHub 文件下载、Hugging Face 模型获取等多种场景提供稳定高效的加速支持完全摆脱对第三方服务的依赖。 核心关键词与长尾关键词核心关键词Docker 镜像加速、GitHub 文件加速、自托管代理服务、高性能代理长尾关键词Docker 镜像拉取优化配置、GitHub Release 文件下载加速、多仓库统一代理部署 技术架构与核心功能HubProxy 采用模块化设计整个项目结构清晰主要包含以下几个核心模块配置管理模块src/config/config.go - 统一配置管理请求处理模块src/handlers/ - 包含 Docker、GitHub、镜像搜索等处理器工具模块src/utils/ - 访问控制、缓存、限流等工具函数前端界面src/public/ - 提供直观的 Web 操作界面核心功能特性多协议支持全面支持 Docker Registry API v2、GitHub API、Hugging Face 仓库流式传输优化采用流式传输技术大幅提升大文件下载效率智能缓存机制内置 Token 和 Manifest 缓存显著提升重复请求响应速度安全访问控制支持 IP 黑白名单、仓库访问控制、智能限流保护统一配置管理通过 src/config.toml 文件统一管理所有配置项 快速部署实战Docker 一键部署推荐方案对于大多数用户Docker 部署是最简单快捷的方式docker run -d \ --name hubproxy \ -p 5000:5000 \ -v /path/to/config:/etc/hubproxy \ --restart always \ ghcr.io/sky22333/hubproxy这个命令会在后台运行 HubProxy 容器将容器 5000 端口映射到主机挂载配置文件目录实现持久化设置容器自动重启确保服务高可用脚本自动化安装对于无 Docker 环境的服务器可以使用官方安装脚本curl -fsSL https://gitcode.com/gh_mirrors/hu/hub-proxy/raw/main/install.sh | sh脚本会自动检测系统架构amd64/arm64下载对应架构的安装包.deb/.rpm/.apk安装并配置系统服务启动 HubProxy 服务HubProxy 提供直观的 Web 界面支持快速转换 GitHub 文件加速链接和 Docker 镜像加速配置⚙️ 核心配置详解基础服务配置HubProxy 的核心配置文件位于/etc/hubproxy/config.toml主要配置项包括[server] host 0.0.0.0 # 监听地址 port 5000 # 监听端口 fileSize 2147483648 # GitHub 文件大小限制2GB enableH2C false # 是否启用 HTTP/2 多路复用 enableFrontend true # 是否启用前端界面 [rateLimit] requestLimit 500 # 每 IP 每周期请求数 periodHours 3.0 # 限流周期小时安全访问控制配置[security] whiteList [ 127.0.0.1, 192.168.1.0/24 # 内网 IP 段 ] blackList [ 192.168.100.1 # 黑名单 IP ] [access] whiteList [] # 仓库白名单支持通配符 blackList [ baduser/*, # 禁止访问特定用户的所有仓库 */malicious-repo # 禁止访问特定仓库 ]镜像仓库配置HubProxy 支持多种镜像仓库的加速[registries.ghcr.io] upstream ghcr.io authHost ghcr.io/token authType github enabled true [registries.gcr.io] upstream gcr.io authHost gcr.io/v2/token authType google enabled true Docker 镜像加速实战单次镜像加速拉取# 原生 Docker 拉取命令 docker pull nginx:latest # 使用 HubProxy 加速 docker pull yourdomain.com/nginx:latest # GitHub Container Registry 加速 docker pull yourdomain.com/ghcr.io/sky22333/hubproxy:latest全局 Docker 镜像加速配置修改 Docker 配置文件/etc/docker/daemon.json{ registry-mirrors: [ https://yourdomain.com ] }配置完成后重启 Docker 服务sudo systemctl restart docker多仓库加速支持HubProxy 支持以下镜像仓库的加速Docker Hub (docker.io)GitHub Container Registry (ghcr.io)Google Container Registry (gcr.io)Quay.io (quay.io)Kubernetes Registry (registry.k8s.io) GitHub 文件加速实战Release 文件加速原始 GitHub Release 链接https://github.com/kubernetes/kubernetes/releases/download/v1.28.0/kubernetes.tar.gzHubProxy 加速链接https://yourdomain.com/https://github.com/kubernetes/kubernetes/releases/download/v1.28.0/kubernetes.tar.gzRaw 文件加速原始 GitHub Raw 链接https://raw.githubusercontent.com/tensorflow/tensorflow/master/README.mdHubProxy 加速链接https://yourdomain.com/https://raw.githubusercontent.com/tensorflow/tensorflow/master/README.mdGit 仓库克隆加速# 原始克隆命令 git clone https://github.com/sky22333/hubproxy.git # 使用 HubProxy 加速克隆 git clone https://yourdomain.com/https://github.com/sky22333/hubproxy.git 高级配置与优化技巧环境变量覆盖配置HubProxy 支持通过环境变量动态覆盖配置优先级高于配置文件# 修改服务端口 SERVER_PORT8080 hubproxy # 调整文件大小限制 MAX_FILE_SIZE4294967296 hubproxy # 4GB # 自定义限流策略 RATE_LIMIT1000 RATE_PERIOD_HOURS1 hubproxy反向代理配置优化为了确保 IP 限流功能正常工作反向代理需要正确传递客户端真实 IPNginx 配置示例server { listen 80; server_name yourdomain.com; location / { proxy_pass http://127.0.0.1:5000; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Host $host; } }Caddy 配置示例yourdomain.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} } }性能优化配置启用 HTTP/2 多路复用[server] enableH2C true # 提升并发下载性能优化缓存配置[tokenCache] enabled true defaultTTL 30m # 延长缓存时间减少重复认证调整连接池大小 通过环境变量设置 HTTP 客户端连接池参数export HTTP_MAX_IDLE_CONNS100 export HTTP_MAX_IDLE_CONNS_PER_HOST10️ 常见问题排查指南问题 1加速链接无效或返回错误排查步骤检查服务状态sudo systemctl status hubproxy查看服务日志sudo journalctl -u hubproxy -f验证配置文件语法hubproxy --config /etc/hubproxy/config.toml --check检查端口占用netstat -tlnp | grep :5000问题 2Docker 镜像拉取速度慢解决方案确认 Docker 配置正确docker info | grep -A 5 Registry Mirrors测试直接代理访问curl -I https://yourdomain.com/v2/检查网络连接和 DNS 解析问题 3GitHub 文件下载被限制原因分析GitHub API 速率限制文件大小超过配置限制IP 被限流解决方法调整文件大小限制MAX_FILE_SIZE4294967296优化限流策略降低RATE_LIMIT或增加RATE_PERIOD_HOURS使用 GitHub Token 提升 API 限制 监控与维护最佳实践服务监控配置系统服务监控# 实时查看服务状态 sudo systemctl status hubproxy # 查看服务日志 sudo journalctl -u hubproxy -f --since 10 minutes ago性能指标监控 HubProxy 内置了 Prometheus 指标端点默认端口 5000/metrics可以集成到现有的监控系统中。访问日志分析 日志文件位于/var/log/hubproxy.logAlpine或系统日志中可以定期分析访问模式。定期维护任务配置文件备份# 备份配置文件 sudo cp /etc/hubproxy/config.toml /etc/hubproxy/config.toml.backup.$(date %Y%m%d)服务更新# Docker 部署更新 docker pull ghcr.io/sky22333/hubproxy:latest docker stop hubproxy docker rm hubproxy docker run -d --name hubproxy -p 5000:5000 --restart always ghcr.io/sky22333/hubproxy # 安装包更新 curl -fsSL https://gitcode.com/gh_mirrors/hu/hub-proxy/raw/main/install.sh | sh缓存清理# 重启服务清理内存缓存 sudo systemctl restart hubproxy 总结与展望HubProxy 作为一款功能全面的 Docker 与 GitHub 加速代理服务通过简单的部署和配置能够显著提升国内用户访问海外资源的效率。其核心优势在于一体化解决方案单个服务同时支持 Docker、GitHub、Hugging Face 等多种资源加速高性能架构基于 Go 语言开发支持流式传输和智能缓存灵活配置支持配置文件和环境变量双重配置方式安全保障完善的访问控制和限流机制易于维护提供完整的系统服务集成和监控支持随着云原生和开源生态的不断发展HubProxy 将持续优化性能、扩展支持的仓库类型并为用户提供更加稳定高效的加速体验。无论是个人开发者还是企业团队HubProxy 都是解决海外资源访问瓶颈的理想选择。通过本文的实战指南您已经掌握了 HubProxy 的完整部署、配置和优化方法。现在就开始搭建您自己的加速服务告别下载等待的烦恼吧【免费下载链接】hub-proxy多功能加速服务支持Docker 镜像加速、GitHub 加速、下载离线镜像等功能。轻量级不占用存储空间。项目地址: https://gitcode.com/gh_mirrors/hu/hub-proxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考