one-api-pro

统一管理多模型，精准控成本，高可用部署一步到位

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署基础设施 🍴 复刻 13 🐛 待处理 4 👀 关注 1

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 932

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类基础设施

开发团队modelbus

官网地址http://one-api.pro

GitHubhttps://github.com/modelbus/one-api-pro

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

主要语言Go

技术栈/模型one-api,one-api-pro,oneapi,openai

GitHub 星标★ 932

上线时间2026-07-24 00:00:00

代码更新2026-10-31

仓库体积23.6 MB

本站数据更新2026-11-10

维护状态较活跃

收录时间2026-08-09

浏览次数5

项目介绍

One Api Pro 是基于开源项目 one-api 深度重构的企业级 AI API 网关。它解决的是企业在使用多个 AI 模型平台时面临的接口不统一、成本分散、权限混乱和高可用部署难等问题。核心能力包括：提供统一的 OpenAI 兼容接口，聚合 30+ 主流模型平台；基于 Vue 3 + Arco Design 开发全新管理后台，支持可视化仪表盘、令牌精细管控、套餐订阅体系（按 Token / 按次计费 + 周期限频）；采用去中心化多活集群架构，节点独立 MySQL + Redis，通过应用层事件同步数据互信；支持精确成本核算（Prompt / Completion / Cached 独立定价）；内置四级权限体系。面向需要统一管理多模型、关注成本监控与企业级高可用部署的开发者和团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 932

技术标签

openai

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 15 分钟部署方式：本地安装 6 步

环境要求

Go 编译环境（README 使用 go build 构建后端二进制）
多机部署需要 MySQL（SQLite 不适用，需用 SQL_DSN 共用同一数据库）
多机部署的从机需各自安装独立的 Redis 实例
可访问 localhost 的浏览器用于登录管理后台

安装与启动步骤

1获取源码

克隆仓库并进入项目目录，后续前端与后端构建、启动都在该目录下进行。
```
git clone https://github.com/modelbus/one-api-pro.git
cd one-api-pro
```
2构建后端二进制

README 明确要求后端构建必须在前端构建之后执行，以便嵌入最新前端资源，在项目根目录生成 one-api-pro。
```
go build -ldflags "-s -w" -o one-api-pro
```
3赋权并启动服务

给二进制加可执行权限后启动，默认监听 3000 端口，日志输出到 ./logs 目录。
```
chmod u+x one-api-pro
./one-api-pro --port 3000 --log-dir ./logs
```
4登录管理后台

浏览器打开 http://localhost:3000，用默认账号 root / 123456 登录，再在控制台内继续配置。
5按需自定义配置

One Api Pro 开箱即用，可通过环境变量或命令行参数进一步定制；不确定含义时可先删掉该项取值查看应用内提示。
6多机与集群部署

多机部署需各主机同一 SESSION_SECRET、同一 MySQL；从机设 NODE_TYPE=slave 并配置独立 Redis。

关键配置

配置项	必填	说明	示例
`SESSION_SECRET`	是	多机部署时每台主机必须设置为相同的值	`your-session-secret-xxxxxxxx`
`SQL_DSN`	是	所有主机共用同一个 MySQL 数据库，SQLite 不可用	`root:123456@tcp(127.0.0.1:3306)/one-api-pro`
`NODE_TYPE`	否	从机设为 slave，主机默认 master	`slave`
`SYNC_FREQUENCY`	否	各主机定期从数据库同步配置的频率	`60`
`FRONTEND_BASE_URL`	否	从机可将页面请求重定向到主机	`http://master.one-api.pro`
`REDIS_CONN_STRING`	否	从机各自独立的 Redis 连接串，支持 Sentinel/集群	`redis://127.0.0.1:6379`

如何确认成功

浏览器访问 http://localhost:3000 能打开管理后台，并用 root / 123456 成功登录。

常见问题

Q：默认账号密码是多少？

A：默认账号 root、密码 123456，登录地址 http://localhost:3000，生产环境请登录后立即修改。

Q：多台机器能共用一个 MySQL 实例吗？

A：去中心化集群模式不行，每个节点必须使用独立 MySQL 实例，因为 auto_increment_offset 是实例级变量。

Q：多机部署可以用 SQLite 吗？

A：不可以，多机部署需设置 SQL_DSN 让所有主机共享同一个 MySQL 数据库。

Q：不知道某个配置项的含义怎么办？

A：可临时删除该配置的值，应用内会给出对应提示；也可查阅官方文档 http://doc.one-api.pro/。

注意事项

后端构建必须在在前端构建之后执行，否则二进制中嵌入的前端资源不是最新的。
root / 123456 仅为初始默认账号，正式使用前务必修改密码并设置 SESSION_SECRET。
从机建议安装独立 Redis 并设置 REDIS_CONN_STRING，缓存命中时可不访问数据库以降低延迟。
更完整的生产部署与 API 说明请参考官方文档与在线 Demo：http://doc.one-api.pro/ 、http://demo.one-api.pro