mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-02 01:10:23 +08:00
73a5325a38
Hub 数据面改为 /local/relay/{node_id} HTTP 端点，Worker 通过本机
HTTP 请求转发 tunnel 帧，不再维护 /worker WebSocket 长连接。
Hub 侧:
- 新增 control_plane.rs: Hub 通过 HTTP 回调 Aether app 处理心跳 ACK 和节点状态变更
- 新增 local_relay.rs: 接收本地 HTTP 请求，在 Hub 内部打开 LocalStream 并透传到 proxy
- 移除 worker_conn.rs 及 Worker WebSocket 处理逻辑
- 简化 protocol.rs: 移除 NODE_STATUS 帧类型，抽取通用 encode_frame/decode_payload
Python 侧:
- 删除 tunnel_manager.py 及其 WebSocket 连接管理器 (HubConnectionManager)
- 简化 hub_transport.py 为 HTTP relay 调用
- 新增 src/api/internal/hub.py 接收 Hub 控制面回调 (heartbeat/node-status)
- hub_config.py 移除 WebSocket 相关配置，改为 HTTP relay URL
- service.py 新增 update_tunnel_status 方法
- 删除 src/api/admin/proxy_tunnel.py (旧管理接口)
- proxy_node 缓存 TTL 从 15s 降至 3s 加速状态感知
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: 额外打latesttag
运行时参数
TUNNEL_HUB_WORKER_IDLE_TIMEOUT：worker 心跳空闲超时，默认60秒TUNNEL_HUB_OUTBOUND_QUEUE_CAPACITY：单连接出站队列容量，默认128；队列打满时会把连接视为拥塞并主动关闭，避免 Hub 内存无限增长
与部署脚本关系
./deploy.sh: 本地构建部署（会本地构建 app/base，并在构建 app 时从 GitHub Release 下载 Hub，可用--hub-tag固定版本）。