mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-02 01:10:23 +08:00
ddeb357c0e
- proxy: 启动时检测旧版配置并自动迁移（delegate_* -> upstream_*、单服务器 -> [[servers]]），备份原文件为 .v1.bak - proxy: 升级后 systemd 重启改为 best-effort，失败不中断升级流程 - provider: max_retries 上限从 10 放宽到 999（前端、后端模型同步调整）
aether-proxy
Aether 正向代理节点，部署在海外 VPS 上，为墙内的 Aether 实例中转 API 流量。
安装
Docker Compose 部署
# 拉取镜像
docker pull ghcr.io/fawney19/aether-proxy:latest
# 或使用 docker compose
cp .env.example .env
# 编辑 .env 填入 AETHER_PROXY_AETHER_URL, MANAGEMENT_TOKEN, HMAC_KEY
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 格式） |
--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 时间戳容差（秒） |
--aether-request-timeout |
AETHER_PROXY_AETHER_REQUEST_TIMEOUT |
10 |
Aether API 请求总超时（秒） |
--aether-connect-timeout |
AETHER_PROXY_AETHER_CONNECT_TIMEOUT |
10 |
Aether API 建连超时（秒） |
--aether-pool-max-idle-per-host |
AETHER_PROXY_AETHER_POOL_MAX_IDLE_PER_HOST |
8 |
Aether API 每 Host 最大空闲连接数 |
--aether-pool-idle-timeout |
AETHER_PROXY_AETHER_POOL_IDLE_TIMEOUT |
90 |
Aether API 连接池空闲超时（秒） |
--aether-tcp-keepalive |
AETHER_PROXY_AETHER_TCP_KEEPALIVE |
60 |
Aether API TCP keepalive（秒，0 关闭） |
--aether-tcp-nodelay |
AETHER_PROXY_AETHER_TCP_NODELAY |
true |
Aether API 启用 TCP_NODELAY |
--aether-http2 |
AETHER_PROXY_AETHER_HTTP2 |
true |
Aether API 启用 HTTP/2 |
--aether-retry-max-attempts |
AETHER_PROXY_AETHER_RETRY_MAX_ATTEMPTS |
3 |
Aether API 最大重试次数（含首次） |
--aether-retry-base-delay-ms |
AETHER_PROXY_AETHER_RETRY_BASE_DELAY_MS |
200 |
Aether API 重试基础延迟（毫秒） |
--aether-retry-max-delay-ms |
AETHER_PROXY_AETHER_RETRY_MAX_DELAY_MS |
2000 |
Aether API 重试最大延迟（毫秒） |
--max-concurrent-connections |
AETHER_PROXY_MAX_CONCURRENT_CONNECTIONS |
自动估算 | 最大并发连接数（默认硬件估算） |
--connect-timeout |
AETHER_PROXY_CONNECT_TIMEOUT |
30 |
CONNECT 上游建连超时（秒） |
--tls-handshake-timeout |
AETHER_PROXY_TLS_HANDSHAKE_TIMEOUT |
10 |
TLS 握手超时（秒） |
--dns-cache-ttl |
AETHER_PROXY_DNS_CACHE_TTL |
60 |
DNS 缓存 TTL（秒） |
--dns-cache-capacity |
AETHER_PROXY_DNS_CACHE_CAPACITY |
1024 |
DNS 缓存容量（条目数） |
--delegate-connect-timeout |
AETHER_PROXY_DELEGATE_CONNECT_TIMEOUT |
30 |
delegate 上游建连超时（秒） |
--delegate-pool-max-idle-per-host |
AETHER_PROXY_DELEGATE_POOL_MAX_IDLE_PER_HOST |
64 |
delegate 每 Host 最大空闲连接数 |
--delegate-pool-idle-timeout |
AETHER_PROXY_DELEGATE_POOL_IDLE_TIMEOUT |
300 |
delegate 连接池空闲超时（秒） |
--delegate-tcp-keepalive |
AETHER_PROXY_DELEGATE_TCP_KEEPALIVE |
60 |
delegate TCP keepalive（秒，0 关闭） |
--delegate-tcp-nodelay |
AETHER_PROXY_DELEGATE_TCP_NODELAY |
true |
delegate 启用 TCP_NODELAY |
--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
- 构建 Docker 镜像并推送到 GHCR 和 Docker Hub
- 更新 README 中的下载链接表格
git tag proxy-v0.1.0
git push origin proxy-v0.1.0