Files
Aether/aether-hub
fawney19 d0df52ce35 fix(hub): worker 断连时向 proxy 端发送 STREAM_ERROR 防止流阻塞
将 unregister_worker 中的 stream 清理逻辑提取为 cancel_streams_for_worker
方法,与 cancel_streams_for_proxy 形成对称设计。worker 断连时主动通知
proxy 端终止相关 stream,防止 proxy 的 stream handler 永久阻塞等待请求体。
添加单元测试覆盖该场景。
2026-03-17 17:29:12 +08:00
..

aether-hub

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

已集成在Docker镜像中, 无需单独部署。

部署端指定 Hub 版本并构建

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

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

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

运行时参数

  • TUNNEL_HUB_WORKER_IDLE_TIMEOUTworker 心跳空闲超时,默认 60
  • TUNNEL_HUB_OUTBOUND_QUEUE_CAPACITY:单连接出站队列容量,默认 128;队列打满时会把连接视为拥塞并主动关闭,避免 Hub 内存无限增长

与部署脚本关系

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