项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 7612
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 一键部署平台账号(Railway / Render / DigitalOcean / AWS / GCP 等)
- 持久化请求记录存储:PostgreSQL + S3 兼容存储或持久化磁盘
- 至少一家模型供应商的 API Key(BYOK 自带密钥)
- 若用 DigitalOcean / Heroku / Koyeb,需提前准备外部 S3 兼容存储配置
安装与启动步骤
-
1选择部署平台
优先选 Railway:官方模板已包含 Manifest、PostgreSQL 和 S3 兼容的请求记录存储,是最省事的路径。
-
2点击一键部署
在所选平台打开部署链接,按引导授权仓库并创建应用;AWS/GCP 走对应 CloudFormation 或 DeployStack 模板。
-
3确认存储已就绪
Railway、AWS、GCP、Fly.io 会原生分配存储;Render、Coolify、Easypanel、Docker 需挂载持久卷;DigitalOcean、Heroku、Koyeb 会在安装时要求填写 S3 兼容配置。
-
4填入供应商密钥
部署过程中按提示填入 OpenAI、Anthropic 等供应商的 API Key(BYOK),网关据此路由请求并记录费用。
-
5可选:本地取源码
如需查看部署模板或本地改造,可先克隆仓库;注意旧的 npm 自托管方式已不再支持,请改用 Docker 镜像或官方部署指南。
git clone https://github.com/mnfst/llm-gateway.git
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
S3-compatible storage settings | 是 | DigitalOcean、Heroku、Koyeb 部署时需提供,用于持久化请求记录 | https://s3.amazonaws.com |
模型供应商 API Key | 是 | BYOK 自带密钥,网关用它调用对应模型供应商 | sk-xxxxxxxx |
PostgreSQL 连接 | 是 | 一键部署模板会自动创建,用于存放网关元数据 | postgres://user:pass@host:5432/db |
如何确认成功
部署平台显示服务运行正常,打开平台分配的服务地址能访问网关,并用 OpenAI 兼容接口发一次请求得到模型响应。
常见问题
Q:还能用 npm 方式自托管吗?
A:不能。README 明确说明旧的 npm 自托管路径已不再支持,请改用 Docker 镜像或官方提供的一键部署指南。
Q:哪个平台部署最简单?
A:Railway 是最佳路径,模板已包含 Manifest、PostgreSQL 和 S3 兼容的请求记录存储,基本无需额外配置。
Q:可以横向扩容多实例吗?
A:卷挂载的模板是单实例。若要水平扩容,必须先把请求记录存储换成 S3 兼容存储再扩容。
Q:请求记录存储是必须的吗?
A:是。所有部署路径都要求持久化请求记录存储,只是在各平台上的提供方式不同。
注意事项
- 所有部署路径都需要持久化请求记录存储,缺少存储会导致部署不完整
- 卷挂载模板为单实例,扩容前务必先切换到 S3 兼容存储
- README 未给出具体 Docker 镜像名与本地 docker run 命令,本地部署请以官方部署指南为准
- 项目定位是 OpenAI API 兼容的统一网关,上层 Agent 按一套接口调用即可切换供应商
核心亮点
- 统一 OpenAI 兼容入口,上层 Agent 无需为每家供应商写适配代码
- 支持 BYOK 自带密钥,密钥与路由集中管理,便于多团队共享和权限控制
- 内置成本追踪与可观测,能按调用统计 token 与费用,方便预算治理
不足之处
- 作为网关会引入额外网络跳转,对延迟敏感场景需评估
- 项目处于成长阶段,生态集成与长期稳定性待观察
适用场景
- 多模型混用的 AI Agent 应用,按任务或成本动态切换供应商
- 团队统一管理各家 API Key 并统计各项目模型开销
- 需要兼容 OpenAI SDK 的现有工具快速接入 Anthropic 等模型
替代项目
LiteLLM、Portkey Gateway、OpenRouter
上一篇:LLMLingua
下一篇:latitude-llm
同类项目推荐
mlx-flash
开源
让 Apple 设备跑起超内存大模型,流式加载不卡顿。
Flash weight streaming for MLX: run massive models larger than your RAM on Apple Sil···
FreeToken
开源
在桌面端跑起数据中心级大模型,又快又省资源
FreeToken brings datacenter-scale model serving to your desktop. Run massive models ···
langfuse-mcp
开源
让 AI 代理直接查询 Langfuse 追踪数据,实现自我调试与可观测性。
A Model Context Protocol (MCP) server for Langfuse, enabling AI agents to query Lang···
runanywhere-sdks
开源
本地跑AI,生产级工具包,低延迟高隐私
Production ready toolkit to run AI locally
claude-tap
开源
本地拦截 AI 编程代理流量,可视化调试每个 API 调用
Intercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemini C···
deepmem
开源
5分钟换掉Mem0,检索快2倍成本省10倍
Drop-in AI memory layer with 2x faster retrieval and 10x lower cost. Fully compatibl···
pgvecto.rs
开源
在 Postgres 里实现高性能向量搜索,无需迁移数据库。
Scalable, Low-latency and Hybrid-enabled Vector Search in Postgres. Revolutionize Ve···
tokscale
开源
终端里统一看 AI 编程 token 消耗,参与全球排行。
️ Track token usage across AI coding agents from your terminal. Global leaderboard···
aisix-archived
开源
用 Rust 打造你的 AI 网关,统一管理多模型请求
An open source, Native AI Gateway and LLM proxy built in Rust
