bifrost

环境要求

• Docker（使用 Docker 方式运行网关）
• Node.js / npx（使用本地 npx 方式运行网关）
• 本机 8080 端口可用（默认服务端口）
• 用于配置的浏览器（访问内置 Web UI）

安装与启动步骤

1. 1Docker 启动网关

   README 推荐的生产可用方式，映射 8080 端口后即可运行，零配置启动。

   docker run -p 8080:8080 maximhq/bifrost

   复制

2. 2或用 npx 本地运行

   没有 Docker 时可改用 npm 的 npx 直接拉取运行 @maximhq/bifrost 包。

   npx -y @maximhq/bifrost

   复制

3. 3挂载数据卷持久化

   生产部署时把本地 data 目录挂载到容器 /app/data，避免配置与数据随容器丢失。

   docker run -p 8080:8080 -v $(pwd)/data:/app/data maximhq/bifrost

   复制

4. 4打开 Web UI 配置

   网关启动后打开内置 Web 界面，在界面里完成多模型供应商的配置与管理。

   open http://localhost:8080

   复制

5. 5发起首次 API 调用

   通过 OpenAI 兼容接口调用网关，README 中的 curl 示例被截断，完整命令请参考官方文档。

如何确认成功

浏览器访问 http://localhost:8080，能看到 Bifrost 内置 Web UI 界面即表示启动成功。

常见问题

注意事项

• 使用 npx 方式需要本机已安装 Node.js 环境。
• 生产环境建议使用 Docker 并挂载数据卷（-v $(pwd)/data:/app/data）。
• README 中第三步的 curl 调用示例内容不完整，实际请求命令请以官方文档为准。
• 企业级功能（自适应负载均衡、集群模式、护栏、MCP 网关）需企业版部署支持。