快速开始

HubProxy 提供 Docker 镜像与系统安装包两种主流部署方式。

Docker 部署（推荐）

docker run -d \
  --name hubproxy \
  -p 5000:5000 \
  --restart always \
  -v /path/to/config.toml:/app/config.toml:ro \
  ghcr.io/sky22333/hubproxy

自动识别系统与架构，从 GitHub Releases 下载 .deb、.rpm 或 .apk：

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

安装完成后服务会自动启动，配置文件位于 /etc/hubproxy/config.toml。

curl http://127.0.0.1:5000/ready   # 本地健康检查

正常响应示例：

{
  "ready": true,
  "service": "hubproxy",
  "version": "v1.x.x",
  "start_time_unix": 1710000000,
  "uptime_sec": 42.5,
  "uptime_human": "42秒"
}

验证通过后，建议尽快为 HubProxy 配置自有域名 + 反向代理 + HTTPS（如 Caddy / Nginx），客户端通过 https://example.com 访问，而不是长期使用裸 http://IP:5000。详见推荐部署架构与反向代理配置。