项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1335
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Docker 与 Docker Compose(推荐用 docker compose 部署)
- Python 3.11(仅本地模式需要,Docker 模式无需本机 Python)
- Git(用于克隆仓库)
- Linux 环境且具备 sudo 权限(使用交互式安装脚本时)
安装与启动步骤
-
1克隆仓库
把项目源码拉到本地并进入项目目录。
git clone https://github.com/yukkcat/gemini-business2api.git cd gemini-business2api -
2复制环境变量文件
从示例文件生成实际使用的 .env,后续在其中填写密钥。
cp .env.example .env -
3填写环境变量
编辑 .env,至少设置 ADMIN_KEY(后台管理密钥)、服务端口与 DATABASE_URL。
-
4启动 2API 主服务
用 Docker Compose 启动主服务与管理后台,会暴露 7860 端口并挂载 ./data。
docker compose up -d -
5按需启动刷新 worker
refresh-worker 默认不启动,需要账号刷新能力时用 refresh profile 拉起。
docker compose --profile refresh up -d -
6或使用安装脚本
不想手动操作时,可执行官方交互式脚本,按提示选择 Docker/Python、端口、ADMIN_KEY 等。
curl -fsSL https://raw.githubusercontent.com/yukkcat/gemini-business2api/main/deploy/install.sh | sudo bash
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
ADMIN_KEY | 是 | 管理后台登录密钥,安装脚本中会提示填写 | admin-xxxxxxxx |
DATABASE_URL | 否 | 数据库连接地址,安装脚本中会提示填写 | |
服务端口 | 否 | 对外服务端口,docker 结构默认暴露 7860 | 7860 |
如何确认成功
容器启动后访问 http://localhost:7860 可打开管理后台,并能用 ADMIN_KEY 登录即成功。
常见问题
Q:refresh-worker 是必须启动的吗?
A:不是。默认不启动,只有需要账号刷新能力时,才通过 docker compose --profile refresh up -d 或安装脚本 --with-refresh 启用。
Q:安装脚本里的 --with-refresh 是什么意思?
A:它只是把“是否启用 refresh-worker”这一选项默认预设为开启,并不代表另一套独立安装流程。
Q:还能用项目里的注册机吗?
A:不能。自 v0.3.0 起注册机、注册流程已从主线移除,主仓库只保留 2API 主服务、管理后台和可选 refresh-worker。
Q:如何固定安装某个正式版本?
A:把脚本地址中的 main 换成版本号标签即可,例如 v0.3.3。
注意事项
- 自 v0.3.0 起主线只保留 2API 主服务、管理后台和可选 refresh-worker,注册与刷新执行链路已拆出。
- 服务通过 ./data 目录持久化数据,docker-compose 中主服务与 refresh-worker 读取同一个 ./data。
- 当前稳定版本为 v0.3.3,许可证为 CNC-1.0,使用前请确认授权范围。
核心亮点
- 多账户轮询负载均衡,提升请求吞吐和稳定性
- 支持图像/视频生成及文件解析,扩展多模态应用场景
- API 兼容 OpenAI 格式,可无缝接入现有 ChatGPT 工具链
不足之处
- 依赖 Gemini 商业版账号,非免费使用
- 文档/社区待观察
适用场景
- 将现有 OpenAI 应用迁移到 Gemini 以降低成本
- 需要多模态生成能力(图像/视频)的统一 API 网关
- 多账号管理避免单点限流,保障服务高可用
替代项目
one-api、new-api、LiteLLM
上一篇:XMem
同类项目推荐
uccl
开源
让 GPU 通信快如闪电,训练推理不再等数据
UCCL is an efficient communication library for GPUs, covering collectives, P2P (e.g.···
mlplatform-workshop
开源
用示例代码快速搭建机器学习平台骨架
Example code for a basic ML Platform based on Pulumi, FastAPI, DVC, MLFlow and more
helix-db
开源
用对象存储构建图+向量数据库,低成本搞定复杂关联与语义搜索
HelixDB is an OLTP graph database with native vector and full-text search built in R···
llmops
开源
用 TypeScript 快速搭建可插拔的 LLM 应用运维工具链
A pluggable LLMOps toolkit for TypeScript applications.
janas
开源
纯 C 写的本地推理引擎,小内存也能跑超大模型
37 tok/s from Qwen3-Next-80B (48 GB) on a 32 GB laptop, 24 without drafts vs 2.8 for···
ramalama
开源
像拉容器镜像一样拉取并运行AI模型,本地推理一键搞定。
RamaLama is an open-source developer tool that simplifies the local serving of AI mo···
Recall
开源
切换 AI 助手,不丢历史记忆,本地搜索所有编码会话
Switch agents. Keep the history. Local-first search across your AI coding sessions.
gateway
开源
一个 API 接入 1600+ 模型,内置安全护栏,AI 应用开发提速。
A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI G···
OlliteRT
开源
把安卓手机变成本地 OpenAI 接口推理服务器
Turn your Android phone into an OpenAI-compatible LLM inference server - Fully local···
