Files
Aether/aether-hub
fawney19 0564893c4f refactor: Hub二进制改为Docker构建时下载,优化部署流程与worker初始化
- Dockerfile: 移除COPY预编译二进制,改为构建时通过HUB_TAG从GitHub Release下载
- CI: 移除artifact上传/下载步骤,通过build-args传递Hub tag
- deploy.sh: 重构参数解析,支持--hub-tag指定版本,跟踪tag变化触发重建
- build.sh: 新增--image模式支持构建并推送Hub Docker镜像
- hub.rs: worker连接时同步所有节点在线状态,避免状态不一致
- proxy_nodes: 启动时主动建立Hub worker连接,消除懒连接窗口期
- docker-compose.yml: app镜像支持APP_IMAGE环境变量配置
- README: 更新部署文档,推荐本地构建方式
2026-03-02 11:24:14 +08:00
..

aether-hub

aether-hub 是 Tunnel Hub 服务,负责在 proxy 与 worker 之间路由帧。

快速命令

1) 构建并上传 Hub 二进制(推荐生产)

cd aether-hub
./build.sh --upload hub-v0.1.0

说明:

  • 默认会构建 amd64 + arm64 两个二进制并上传到 GitHub Release。
  • 如只需单架构,可先 ./build.sh amd64./build.sh arm64

2) 部署端指定 Hub 版本并构建

cd /path/to/Aether
./deploy.sh --hub-tag hub-v0.1.0

不指定 --hub-tag 时,./deploy.sh 会自动解析最新 hub-v* release并在构建 app 镜像时从 GitHub Release 下载对应架构的 Hub 二进制。

3) 镜像模式(可选,调试/实验用)

仅本地加载镜像(单平台):

cd aether-hub
BUILDKIT_PROGRESS=plain ./build.sh --image --tag local-test --platforms linux/amd64 --load

build.sh 模式说明

  • 默认是 binary 模式(cross 构建二进制)。
  • --upload <hub-vX.Y.Z> 会把构建产物上传到 GitHub Release。
  • --image 后进入镜像模式(docker buildx,可选)。

常用参数:

  • --tag <tag>: 镜像 tag
  • --image-name <name>: 镜像名(默认 ghcr.io/fawney19/aether-hub
  • --platforms <list>: 例如 linux/amd64,linux/arm64
  • --push: 推送镜像
  • --load: 加载到本地 Docker单平台
  • --latest: 额外打 latest tag

与部署脚本关系

  • ./deploy.sh: 本地构建部署(会本地构建 app/base并在构建 app 时从 GitHub Release 下载 Hub可用 --hub-tag 固定版本)。