Bifrost
自托管 Bifrost AI 网关 — OpenAI 兼容 API + 控制台，锁定 v2.0.0，SQLite，无额外服务。
Bifrost
Bifrost 是开源 AI 网关。本模板按官方 runtime contract（镜像 v2.0.0）部署：单个 Go 进程、SQLite 落在 /app/data，控制台和推理共用同一个 HTTP 端口。
包含服务：
- bifrost —
maximhq/bifrost:v2.0.0（API、控制台、SQLite 配置库、SQLite 日志库）
不需要 PostgreSQL、Redis 或额外 worker。OSS 的 SQLite 只支持单副本。
资源建议
镜像约 87 MB。个人或小团队 0.5–1 vCPU、512 MB–1 GB RAM 即可。
配置
需要填写网关域名。控制台鉴权开箱即开（用户名 admin，密码自动生成）。到 bifrost 服务的 env 里查看 BIFROST_ADMIN_PASSWORD 和 BIFROST_VIRTUAL_KEY。
可选上游 key（OPENAI_API_KEY、ANTHROPIC_API_KEY、OPENROUTER_API_KEY、DEEPSEEK_API_KEY）通过 config.json 的 env.* 引用注入。留空也可以，之后在控制台补。Gemini、Azure、Bedrock、Groq、Ollama 等可在 UI 里加，不用重新部署。
BIFROST_ENCRYPTION_KEY 会自动生成，重启后不要改。改了会导致已加密的配置读不出来。
首次登录
打开网关域名，使用：
- 用户名：
admin - 密码：env 里的
BIFROST_ADMIN_PASSWORD
然后可在控制台继续加虚拟 Key、预算或其它供应商。
快速测试
/health 返回 200，且至少配置了一个上游 key 之后：
curl --fail-with-body --max-time 60 \
-X POST https://<your-domain>/v1/chat/completions \
-H "Authorization: Bearer <BIFROST_VIRTUAL_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"Hello"}]}'
管理员 Basic Auth 也可以：-u admin:<BIFROST_ADMIN_PASSWORD>。
对接 OpenAI SDK / GapSeek 的 OPENAI_BASE_URL：
https://<your-domain>/openai
OPENAI_API_KEY 填 BIFROST_VIRTUAL_KEY。模型名是 provider/model，例如 openai/gpt-4o-mini、anthropic/claude-sonnet-4-5、openrouter/deepseek/deepseek-chat。
本模板范围
| 需求 | 本模板 |
|---|---|
OpenAI 兼容 /v1 + /openai | 已包含 |
| 内置控制台 | 已包含（同一域名） |
| 故障转移 / 负载均衡 / 虚拟 Key | 已包含（在 UI 配置） |
| 语义缓存、MCP、更多供应商 | 在控制台添加 |
| 多副本 / HA | 不包含；需要 Bifrost Enterprise + PostgreSQL |
不要把未鉴权的网关暴露到公网。推理请求默认需要虚拟 Key（或管理员 Basic Auth），除非你在 Security 里关掉 inference 鉴权。
版本
镜像按 digest 锁定 maximhq/bifrost:v2.0.0（拉取日期 2026-09-03）。
参考
- 安装: https://docs.getbifrost.ai/quickstart/gateway/setting-up
- Runtime contract: https://docs.getbifrost.ai/deployment-guides/runtime-contract
- config.json: https://docs.getbifrost.ai/deployment-guides/config-json
- GitHub: https://github.com/maximhq/bifrost
- License: Apache-2.0