Aether

一站式 AI 基础设施平台
支持 Claude / OpenAI / Gemini 及其 CLI 客户端的统一接入、格式转换、正/反向代理, 致力于成为用户驱动AI服务的底座

简介 • 部署 • API 文档 • 环境变量 • Q&A

---

简介

Aether 是一个自托管的 AI API 网关，为团队和个人提供多租户管理、智能负载均衡、成本配额控制和健康监控能力。通过统一的 API 入口，可以无缝对接 Claude、OpenAI、Gemini 等主流 AI 服务及其 CLI 工具。

页面预览: https://fawney19.github.io/Aether/

部署

Docker Compose（推荐：预构建镜像）

# 1. 克隆代码
git clone https://github.com/fawney19/Aether.git
cd Aether

# 2. 配置环境变量
cp .env.example .env
# 生成 JWT_SECRET_KEY / ENCRYPTION_KEY, 并填入 .env
./generate_keys.sh
# 编辑 .env 设置 ADMIN_PASSWORD

# 3. 首次部署 / 更新 (从以下部署形态任选其一)
# Postgres + Redis (适用于企业或多人使用)
docker compose pull && docker compose up -d
# Single Node (适用于个人用户或朋友分享)
docker compose -f docker-compose.single-node.yml pull && docker compose -f docker-compose.single-node.yml up -d

一键更新

Docker Compose 部署后，可在部署目录直接执行：

./update.sh

update.sh 会拉取最新 app 镜像并重建 app 容器，数据卷、Postgres、Redis 不会被删除。Single Node 部署也可显式指定：

./update.sh --mode single-node

仓库自带的 Docker Compose 默认把应用日志输出到容器 stdout/stderr，直接用 docker compose logs -f app 查看，避免正式发布镜像切换到非 root 用户后再被宿主机挂载日志目录的权限问题拖垮启动。如果你确实需要文件日志，再显式设置 AETHER_LOG_DESTINATION=file|both，并把一个可写目录挂载到 /opt/aether/logs（或同步覆盖 AETHER_LOG_DIR）。

管理后台右上角“版本信息”会在检测到新版本时显示“立即更新”。正式发布版支持后台内置更新：点击后会下载对应平台的 GitHub Release 包、强制校验 SHA256SUMS、解压到 /opt/aether/releases/<version>，再切换 /opt/aether/current 并退出进程，交给 Docker restart policy / systemd / launchd 拉起新版本。整个过程不需要挂载 Docker socket，也不需要额外 helper 容器。

源码或本地构建版本不会启用后台在线更新，请继续使用源码更新流程。Docker Compose 用户如果希望“容器重建后也保持镜像层面的新版本”，仍建议定期运行 ./update.sh 拉取并重建 app 镜像。服务器访问 GitHub 需要代理时，可设置 AETHER_UPDATE_PROXY_URL，也兼容 UPDATE_PROXY_URL、HTTPS_PROXY、ALL_PROXY、HTTP_PROXY 以及 NO_PROXY。共享出口触发 GitHub API 限流时，可设置只读 AETHER_UPDATE_GITHUB_TOKEN，也兼容 GITHUB_TOKEN / GH_TOKEN。下载总超时默认 600 秒，连续无响应/无数据默认 30 秒，可通过 AETHER_UPDATE_DOWNLOAD_TIMEOUT_SECS 和 AETHER_UPDATE_DOWNLOAD_IDLE_TIMEOUT_SECS 调整。

如果是本地源码构建镜像的部署，继续使用：

./deploy.sh

如果要在本机联调“管理后台在线更新”本身，可启动仓库内置的 release-layout 测试环境：

docker compose -f docker-compose.release-local.yml up -d --build

这套环境会用当前源码构建一个本地测试镜像，但编译为 release 类型，并默认伪装成 v0.7.0，这样后台会按正式发布版逻辑开放“立即更新”。默认监听 http://127.0.0.1:18085，数据目录使用 ./data-release-local；日志默认走 docker logs，不会影响你正在跑的源码构建容器。

如果这套容器在 prepare-update 时访问 GitHub 失败，而你本机是通过代理出网，请在 .env 里把 AETHER_UPDATE_PROXY_URL 写成宿主机地址，例如 http://host.docker.internal:7890；容器内的 127.0.0.1 指向容器自身，不是宿主机。

如果想重置这套联调环境（包括 /opt/aether/current 和已下载的历史版本），执行：

docker compose -f docker-compose.release-local.yml down -v

可选变量：

• AETHER_RELEASE_LOCAL_VERSION：本地联调镜像对外声明的当前版本，默认 v0.7.0
• AETHER_RELEASE_LOCAL_PORT：本地联调端口，默认 18085
• LOCAL_RELEASE_APP_IMAGE：本地联调镜像名，默认 aether-app:release-local

一键安装（默认 Single Node：Linux systemd / macOS launchd + SQLite）

git clone https://github.com/fawney19/Aether.git
cd Aether
curl -fsSL https://raw.githubusercontent.com/fawney19/Aether/main/install.sh | sudo bash

本地开发

依赖 Docker、Rust toolchain、Node.js 和 make。

make dev

make dev 会同时启动后端 aether-gateway 和前端 frontend 的 Vite dev server。需要单独启动时可使用 make dev-backend 或 make dev-frontend。 Postgres / Redis 本地依赖未就绪时，make dev 会自动执行 docker compose up -d postgres redis。

Aether Tunnel (可选)

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

• Docker Compose 部署或下载预编译二进制直接运行
• 提供 macOS/Linux 与 Windows 一键脚本，自动下载最新 tunnel-v* 制品并向现有 aether-tunnel.toml 追加 [[servers]]
• 通过 aether-tunnel setup 完成交互式配置，自动注册为系统服务
• 详细文档见 apps/aether-tunnel/README.md

API 文档

• Embeddings: OpenAI compatible POST /v1/embeddings
• Rerank: OpenAI/Jina compatible POST /v1/rerank

环境变量

• APP_PORT：aether-gateway 唯一监听端口，固定绑定 0.0.0.0:${APP_PORT}
• DATABASE_URL：数据库连接串；SQLite 例如 sqlite:///opt/aether/data/aether.db，Postgres 例如 postgresql://postgres:aether@postgres:5432/aether
• REDIS_URL：Redis 连接串；仅 Postgres + Redis 的 Docker Compose 部署需要配置
• AETHER_RUNTIME_BACKEND=memory|redis：运行时缓存/协调后端。SQLite 默认用 memory，不会连接 Redis
• AETHER_GATEWAY_AUTO_PREPARE_DATABASE：常规启动前自动执行挂起的 schema migration 和 backfill；仓库自带的 docker-compose.yml 默认开启
• JWT_SECRET_KEY / ENCRYPTION_KEY：认证和敏感数据加密所需密钥
• API_KEY_PREFIX：用户和管理员新建 API Key 时使用的前缀，默认 sk
• ADMIN_USERNAME / ADMIN_PASSWORD / ADMIN_EMAIL：首次启动时自举首个本地管理员；install.sh 会提示输入管理员密码
• CORS_ORIGINS / CORS_ALLOW_CREDENTIALS：前端跨域来源控制；如果要跨域带登录 Cookie，CORS_ORIGINS 不能写 *
• RUST_LOG：Rust 日志过滤，例如 aether_gateway=info、aether_gateway=debug,sqlx=warn
• Docker Compose 的 DB_PASSWORD / REDIS_PASSWORD 默认使用 aether

---

许可证

本项目采用 Aether 非商业开源许可证。允许个人学习、教育研究、非盈利组织及企业内部非盈利性质的使用；禁止用于盈利目的。商业使用请联系获取商业许可。

联系作者

    

Star History