mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-10 21:20:20 +08:00
fawney19
b5a0070023
新增 crate： - aether-runtime: 服务运行时基础设施（并发门控、分布式并发、指标、队列、优雅关闭、tracing） - aether-cache: 通用 TTL 缓存与命名空间抽象 - aether-data: 数据访问层（PostgreSQL/Redis 后端、repository 模式） - aether-http: HTTP 客户端封装（重试、配置） - aether-testkit: 集成测试工具集（gateway/executor/hub/proxy fixture、等待、负载测试） gateway 扩展： - 引入 audit 模块（shadow 执行审计、决策链路追踪、请求审计 bundle） - 引入 cache 模块（AuthContext 缓存、direct-plan bypass 缓存） - 引入 data 模块（auth/candidates/config/usage/video_tasks 数据访问） - 集成 ConcurrencyGate/DistributedConcurrencyGate 请求门控 - 新增本地 auth 拒绝、过载响应构建器 - 补充 control/auth_cache/video/concurrency 集成测试 aether-proxy 扩展： - AppState 集成 stream_gate / distributed_stream_gate 并发门控 - 新增 ProxyAdmissionError 及准入拒绝流程 - stream_handler 补充门控饱和/不可用场景测试 - 配置与注册客户端逻辑完善 aether-hub 扩展： - main.rs 引入运行时初始化、指标端点、健康检查 - local_relay 重构为 lib.rs 暴露公共接口
aether-proxy
Aether Tunnel 代理节点，部署在海外 VPS 上，通过 WebSocket 隧道为 Aether 实例中转 API 流量。
Tunnel 模式下代理节点无需对外监听端口，仅需出站连接到 Aether 服务器。
安装
Docker Compose 部署
cp .env.example .env
# 编辑 .env 填入 AETHER_PROXY_AETHER_URL 和 AETHER_PROXY_MANAGEMENT_TOKEN
docker compose up -d
下载预编译二进制
| Platform | Download |
|---|---|
| Linux x86_64 | aether-proxy-linux-amd64.tar.gz |
| Linux ARM64 | aether-proxy-linux-arm64.tar.gz |
| macOS x86_64 | aether-proxy-macos-amd64.tar.gz |
| macOS ARM64 | aether-proxy-macos-arm64.tar.gz |
| Windows x86_64 | aether-proxy-windows-amd64.zip |
快速开始
# 1. 首次安装配置（TUI 向导，勾选 Install Service 随系统启动服务）
sudo ./aether-proxy setup
# 2. 日常管理 (勾选 Install Service 作为系统服务的情况下)
aether-proxy status # 看状态
aether-proxy logs # 看日志
sudo aether-proxy start # 启动服务
sudo aether-proxy stop # 停止服务
sudo aether-proxy restart # 重启服务
# 3. 重新配置（改完自动重启服务）
sudo aether-proxy setup
# 4. 彻底卸载
sudo aether-proxy uninstall
完成向导后, 配置自动保存到 aether-proxy.toml，如果启用了 Install Service，将自动注册并启动 systemd 服务。
直接运行
如果不需要安装为系统服务，可以直接运行。缺少必填参数时会自动进入 setup 向导：
./aether-proxy
配置
配置按以下优先级加载（高优先级覆盖低优先级）：
- CLI 参数
- 环境变量（
AETHER_PROXY_*） - 配置文件（
aether-proxy.toml，或通过AETHER_PROXY_CONFIG指定路径）
参数一览
基础配置
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--aether-url |
AETHER_PROXY_AETHER_URL |
必填 | Aether 服务器地址 |
--management-token |
AETHER_PROXY_MANAGEMENT_TOKEN |
必填 | 管理员 Token（ae_xxx 格式） |
--public-ip |
AETHER_PROXY_PUBLIC_IP |
自动检测 | 公网 IP |
--node-name |
AETHER_PROXY_NODE_NAME |
proxy-01 |
节点名称标识 |
--node-region |
AETHER_PROXY_NODE_REGION |
自动检测 | 地区标识 |
--heartbeat-interval |
AETHER_PROXY_HEARTBEAT_INTERVAL |
30 |
心跳间隔（秒） |
--allowed-ports |
AETHER_PROXY_ALLOWED_PORTS |
80,443,8080,8443 |
允许代理的目标端口 |
Tunnel 连接
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--tunnel-connections |
AETHER_PROXY_TUNNEL_CONNECTIONS |
3 |
到 Aether 的连接池大小 |
--tunnel-max-streams |
AETHER_PROXY_TUNNEL_MAX_STREAMS |
自动（硬件估算） | 单连接最大并发 stream 数 |
--tunnel-connect-timeout-secs |
AETHER_PROXY_TUNNEL_CONNECT_TIMEOUT_SECS |
15 |
TCP + TLS 握手超时（秒） |
--tunnel-tcp-keepalive-secs |
AETHER_PROXY_TUNNEL_TCP_KEEPALIVE_SECS |
30 |
TCP keepalive 初始延迟（秒） |
--tunnel-tcp-nodelay |
AETHER_PROXY_TUNNEL_TCP_NODELAY |
true |
禁用 Nagle 算法 |
--tunnel-ping-interval-secs |
AETHER_PROXY_TUNNEL_PING_INTERVAL_SECS |
15 |
WebSocket Ping 频率（秒） |
--tunnel-stale-timeout-secs |
AETHER_PROXY_TUNNEL_STALE_TIMEOUT_SECS |
45 |
无数据断连阈值（秒） |
--tunnel-reconnect-base-ms |
AETHER_PROXY_TUNNEL_RECONNECT_BASE_MS |
500 |
指数退避基础延迟（毫秒） |
--tunnel-reconnect-max-ms |
AETHER_PROXY_TUNNEL_RECONNECT_MAX_MS |
30000 |
指数退避上限（毫秒） |
上游 HTTP 请求
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--upstream-connect-timeout-secs |
AETHER_PROXY_UPSTREAM_CONNECT_TIMEOUT_SECS |
30 |
上游建连超时（秒） |
--upstream-pool-max-idle-per-host |
AETHER_PROXY_UPSTREAM_POOL_MAX_IDLE_PER_HOST |
64 |
每 Host 最大空闲连接数 |
--upstream-pool-idle-timeout-secs |
AETHER_PROXY_UPSTREAM_POOL_IDLE_TIMEOUT_SECS |
300 |
连接池空闲超时（秒） |
--upstream-tcp-keepalive-secs |
AETHER_PROXY_UPSTREAM_TCP_KEEPALIVE_SECS |
60 |
TCP keepalive（秒，0 关闭） |
--upstream-tcp-nodelay |
AETHER_PROXY_UPSTREAM_TCP_NODELAY |
true |
启用 TCP_NODELAY |
Aether API 客户端
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--aether-request-timeout-secs |
AETHER_PROXY_AETHER_REQUEST_TIMEOUT_SECS |
10 |
请求总超时（秒） |
--aether-connect-timeout-secs |
AETHER_PROXY_AETHER_CONNECT_TIMEOUT_SECS |
10 |
建连超时（秒） |
--aether-retry-max-attempts |
AETHER_PROXY_AETHER_RETRY_MAX_ATTEMPTS |
3 |
最大重试次数 |
DNS 与安全
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--dns-cache-ttl-secs |
AETHER_PROXY_DNS_CACHE_TTL_SECS |
60 |
DNS 缓存 TTL（秒） |
--dns-cache-capacity |
AETHER_PROXY_DNS_CACHE_CAPACITY |
1024 |
DNS 缓存容量（条目数） |
日志
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
--log-level |
AETHER_PROXY_LOG_LEVEL |
info |
日志级别 |
--log-json |
AETHER_PROXY_LOG_JSON |
false |
JSON 格式日志 |
多服务器配置
在 aether-proxy.toml 中使用 [[servers]] 配置多个 Aether 服务器：
[[servers]]
aether_url = "https://aether-1.example.com"
management_token = "ae_xxx"
node_name = "jp-proxy-01"
[[servers]]
aether_url = "https://aether-2.example.com"
management_token = "ae_yyy"
node_name = "jp-proxy-02"
发布新版本
推送 proxy-v* 格式的 tag，GitHub Actions 会自动：
- 编译所有平台二进制并发布到 Releases
- 构建 Docker 镜像并推送到 GHCR 和 Docker Hub
- 更新 README 中的下载链接表格
git tag proxy-v0.2.0
git push origin proxy-v0.2.0