跳转到内容
HubProxyHubProxy

推荐部署架构

公网服务建议通过反向代理暴露 HubProxy，保障服务器安全。

推荐拓扑

Section titled “推荐拓扑”
用户 → CDN（可选）→ Caddy/Nginx（私网/本机）→ HubProxy:5000
组件 作用
CDN 可选，提供 TLS 与边缘加速
反向代理 终止 TLS、写入真实客户端 IP、隐藏后端端口
HubProxy 处理 Docker/GitHub 代理逻辑

反代部署时的要求

Section titled “反代部署时的要求”

若采用上文推荐拓扑（用户 → 反代 → HubProxy），需满足：

  1. 反代覆盖写 X-Forwarded-For / X-Real-IP（防止用户伪造 IP，勿 append 客户端自带头）
  2. 建议 5000 仅对反代可达（绑定 127.0.0.1 或防火墙限制）
  3. 反代覆盖写 X-Forwarded-Host（防止 .sh 脚本 Host 注入）

各场景对照

Section titled “各场景对照”
部署方式 每用户独立限流 IP 防伪造 推荐度
CDN → 私网反代 → HubProxy ✅ ✅ ⭐⭐⭐
Docker 内 Caddy + HubProxy ✅ ✅ ⭐⭐⭐
本机 Nginx → HubProxy ✅ ✅ ⭐⭐⭐
Cloudflare 直连 HubProxy ❌ 共用 CDN IP ✅ ⚠️
公网直连 0.0.0.0:5000 ✅ ✅ ⚠️ 容易被滥用

下一步

Section titled “下一步”