mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-02 01:10:23 +08:00
71ae1a2307
- aether-hub: unbounded channel 改为 bounded channel (BoundedOutbound)，队列满时标记拥塞并主动关闭连接，防止内存无限增长 - aether-hub: worker idle timeout 从命令行参数改为基于心跳的 liveness 检测，默认 60 秒 - aether-hub: 新增 ConnConfig 统一管理连接配置，新增 outbound_queue_capacity 参数 - hub_transport: 新增事件循环 watchdog，检测 lag 超过阈值时临时降级暂停新流 - gunicorn_conf: 启用 faulthandler，worker abort 时自动 dump 全部线程栈用于诊断 - health/endpoint_checker/recording: 同步 DB 操作移至 asyncio.to_thread，避免阻塞事件循环 - Dockerfile: 移除 --worker-idle-timeout 0 命令行参数，改由环境变量和默认值控制
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# aether-hub
|
||
|
||
`aether-hub` 是 Tunnel Hub 服务，负责在 proxy 与 worker 之间路由帧。
|
||
|
||
已集成在Docker镜像中, 无需单独部署。
|
||
|
||
## 部署端指定 Hub 版本并构建
|
||
|
||
```bash
|
||
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_TIMEOUT`：worker 心跳空闲超时，默认 `60` 秒
|
||
- `TUNNEL_HUB_OUTBOUND_QUEUE_CAPACITY`：单连接出站队列容量，默认 `128`；队列打满时会把连接视为拥塞并主动关闭，避免 Hub 内存无限增长
|
||
|
||
## 与部署脚本关系
|
||
|
||
- `./deploy.sh`: 本地构建部署（会本地构建 app/base，并在构建 app 时从 GitHub Release 下载 Hub，可用 `--hub-tag` 固定版本）。
|