aimod-cc/Agent2API

项目介绍

Agent2API 是一个自托管网关，把多个 AI 服务商收敛到一个 base URL 后面。它提供 OpenAI Chat / Responses / Images 与 Anthropic Messages 接口，统一模型目录，并支持模型映射、账号优先级、负载均衡、会话亲和和故障转移。在此之上，它还管理本地 Agent 客户端的连接配置：可导入已有设置、预览写入内容，并在网关和自定义服务之间切换。

面板层负责账号与运维：凭证维护、出口代理选择、按服务商窗口执行的定时签到、网关密钥，以及请求量、成功率、Token 用量、缓存命中率和 365 天热力图的请求报表。分发形式包括桌面应用（Windows/macOS/Linux）、无界面服务器包（Windows/Linux）和 amd64/arm64 的 Docker 镜像，另有移动端 PWA 视图。

快速使用

按部署环境选择一种形态。Docker 方式：

docker run -d --name agent2api --restart unless-stopped -p 3065:3065 -v ./data:/data aimodcc/agent2api:latest

Linux 服务器包解压后执行 sudo bash install.sh 注册为系统服务；Windows Server 包在管理员 PowerShell 中运行 install-service.ps1。其余产物（.exe、.dmg、.deb、.AppImage、服务器压缩包、APK/IPA）见最新发布页，完整的安装、升级、卸载与排障流程在安装部署文档。

启动后打开面板 http://127.0.0.1:3065/（服务器或 Docker 形式用主机 IP），注册管理员账号，添加自定义服务商和账号，再到「网关密钥」页创建密钥。客户端可配置为 http://127.0.0.1:3065/v1 并使用该密钥，或在 Agent 页面套用连接配置。连通性检查命令为 curl http://127.0.0.1:3065/health。未配置密钥时，模型请求会被默认拒绝。

移动端访问网关地址下的 /m，可添加到主屏幕作为 PWA 使用。

使用约束

• 额外服务商实现以插件形式单独安装和更新，不随主程序打包；没有插件时只支持自定义服务商。
• 面板登录可选人工验证，网关密钥按范围授权，客户端必须使用面板签发的密钥，不能直接匿名调用。
• 账号凭证在本地数据库中加密，但导出文件、备份和密钥文件仍可能包含敏感数据，需要自行妥善保管。
• 从源码构建桌面端需要 Rust >= 1.77 和 Tauri 2 工具链；macOS 的 .dmg 只能在 macOS 上构建，Windows 构建需要 WebView2 运行时。Node.js >= 18.17 仅用于构建脚本，桌面应用运行时不依赖 Node。
• 采用 AGPL-3.0 许可，修改后通过网络提供服务时需向用户提供对应源码。项目明确不保证可用性、稳定性或安全性。

HotRepo 点评

在 2026-11-13 的 Rust 日榜上，该项目单日新增 56 星、最好名次为第 10，仓库累计 2,218 星、585 Fork。这条快照说明它当天进入了 Rust 语言榜前列，但站内没有全语言日榜名次记录，且只有一条快照，无法据此判断趋势。相比单纯的链接页，README 给出的核心差异点——接管现有 Agent 客户端配置并让多个服务商共用一个端点——是具体可核查的能力，配合 AGPL-3.0 许可与 Docker、服务器包分发，自托管是它的主要使用路径。