Files
Aether/aether-proxy
fawney19 519ad67eb1 refactor: 代理节点架构重构与功能增强
aether-proxy:
- 重构 main.rs,拆分为 app/state/hardware/net 模块
- setup.rs 拆分为 setup/tui.rs + setup/service.rs,支持 systemd 服务管理子命令
- 新增 delegate 端点,支持后端通过代理节点转发请求而非传统 CONNECT 代理
- 注册时上报硬件信息(CPU/内存/fd_limit)和估算最大并发数
- 心跳上报活跃连接数,支持远程下发 node_name 配置
- HTTP 转发时剥离 X-Forwarded-* 等敏感头部
- 切换到 rustls-tls,降低日志级别减少噪音

后端:
- 从 http_client.py 提取代理相关逻辑至 proxy_node/resolver.py
- 从 routes.py 提取业务逻辑至 proxy_node/service.py
- handler 支持 delegate 模式(通过代理节点 HTTP 端点转发而非 CONNECT 隧道)
- ProxyNode 模型新增 hardware_info 和 estimated_max_concurrency 字段

前端:
- 新增 HardwareTooltip 组件展示节点硬件信息
- 远程配置支持下发 node_name
2026-02-08 13:33:08 +08:00
..

aether-proxy

Aether 正向代理节点,部署在海外 VPS 上,为墙内的 Aether 实例中转 API 流量。

安装

下载预编译二进制

GitHub Releases 页面下载对应平台的预编译文件,无需安装 Rust 环境。

快速开始

# 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

配置

配置按以下优先级加载(高优先级覆盖低优先级):

  1. CLI 参数
  2. 环境变量(AETHER_PROXY_*
  3. 配置文件(aether-proxy.toml,或通过 AETHER_PROXY_CONFIG 指定路径)

参数一览

参数 环境变量 默认值 说明
--aether-url AETHER_PROXY_AETHER_URL 必填 Aether 服务器地址
--management-token AETHER_PROXY_MANAGEMENT_TOKEN 必填 管理员 Tokenae_xxx 格式)
--hmac-key AETHER_PROXY_HMAC_KEY 必填 HMAC 密钥,需与 Aether 端一致
--listen-port AETHER_PROXY_LISTEN_PORT 18080 监听端口
--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 允许代理的目标端口
--timestamp-tolerance AETHER_PROXY_TIMESTAMP_TOLERANCE 300 HMAC 时间戳容差(秒)
--log-level AETHER_PROXY_LOG_LEVEL info 日志级别
--log-json AETHER_PROXY_LOG_JSON false JSON 格式日志
--enable-tls AETHER_PROXY_ENABLE_TLS true 启用 TLS
--tls-cert AETHER_PROXY_TLS_CERT aether-proxy-cert.pem TLS 证书路径
--tls-key AETHER_PROXY_TLS_KEY aether-proxy-key.pem TLS 私钥路径

发布新版本

推送 proxy-v* 格式的 tagGitHub Actions 会自动编译所有平台并发布到 Releases

git tag proxy-v0.1.0
git push origin proxy-v0.1.0