Aether/aether-proxy

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	必填	管理员 Token（ae_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* 格式的 tag，GitHub Actions 会自动编译所有平台并发布到 Releases：

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