多账户编码网关 thibautrey/multivibe

你的服务商。你的硬件。一个 AI 网关。

免费、自托管的网关，面向编码智能体和 AI 应用。
接入服务商账号，绕开配额限制，用上你偏好的 AI 服务商。

下载 MultiVibe Host ·运行网关 ·探索 API ·参与贡献

当前仪表盘 · 数据来自本地演示实例，均为虚构

✨ 一览

| 单一端点 | 弹性路由 | 你的基础设施 |
| 接入兼容 OpenAI 的客户端、Codex 和 Anthropic Messages 客户端。 | 发现模型、平衡配额余量，在账号之间故障转移。 | 自托管网关，或在支持的硬件上运行完整 Host。 |
| 支持 Responses、Chat Completions、SSE、Realtime 和 WebSocket。 | 添加模型别名、本地/云端策略、预算和延迟任务。 | 管理 API 密钥、查看调用链，跟踪 token、成本和延迟。 |

完整能力与网关架构

| 领域 | MultiVibe 提供什么 |
| 客户端 API | Responses、Chat Completions、Anthropic Messages、models、Realtime WebRTC、基于 WebSocket 的级联 Realtime 语音、SSE，以及基于 WebSocket 的 Responses |
| 服务商 | OpenAI/ChatGPT、GitHub Copilot、Poe、MiniMax、OpenRouter、Abacus.AI、Manus、Kimi、Hugging Face、Mammouth AI、Qwen Coding Plan、Z.AI GLM Coding Plan、Perplexity、Grok Build、OpenCode Zen/Go、Mistral，以及其他已审核或自定义的 API。见服务商设置与配额覆盖。 |
| 账号路由 | 自动发现模型、按配额余量选择、账号/模型屏蔽、重试，以及可选的 Codex 会话亲和 |
| 智能别名 | 条件式 schema-v2 策略、本地/云端候选、容量约束、评分、预算、模拟，以及排队/拒绝兜底 |
| 延迟任务 | 持久化边缘任务、优先级与应用公平性、幂等、轮询/SSE 结果、取消，以及签名 webhook |
| 运维 | 管理后台、生命周期插件、动态应用 API key、追踪、成本/token/延迟统计、项目归属、导出，以及 Sentry 集成 |

MultiVibe 在 /v1 和根路径下暴露同一套推理路由，兼容两种风格的客户端。在随附的 Compose 配置档中，对外的 :1455 socket 由原生 Rust 边缘直接提供服务；Node.js 仍留在回环地址 127.0.0.1:1456，负责仪表盘 UI、OAuth、静态资源，以及尚未迁移的仪表盘资源路由。Rust 接管仪表盘会话认证、外层管理访问守卫、健康检查、只读的 API key 与应用策略清单，以及全部公开推理路由。Ollama 和 LiteLLM 风格的发现兼容端点同样可用。

访问仪表盘请走 :1455，绝不要走 :1456。控制平面端口按设计只留在容器回环地址上，不是第二个入口，所以发布或浏览 1456 会得到连接被拒。边缘在会话认证之后，把每条仪表盘路由反向代理到它。

ADMIN_TOKEN 保护仪表盘，任何超出本机可达范围的主机都必须设置。Compose 默认值（change-me）只是占位符：它生效期间，实例会打印启动警告，管理边界也会接受一个公开已知的值。在 docker-compose.yml 旁边的 .env 里设置 ADMIN_TOKEN；本地覆盖项应放在未纳入版本控制的 docker-compose.override.yml 中。

找到你的路径

| 快速上手 | 使用网关 | 运维与扩展 |
| 下载 Host | 服务商与接入引导 | 追踪与项目 |
| 网关快速上手 | API 参考与示例 | 存储与本地模型 |
| 仪表盘导览 | 路由与别名 | 配置 |
| 安装指南 | 实时语音网关 · 插件 API | 开发 · 更多文档 |

⬇️ 下载 MultiVibe Host

想跑起完整的本地 Host，MultiVibe Host 是最快的路子。它自带安全边界，包含网关、仪表盘、私有设备身份、服务商智能体，以及受管模型运行时。官方构建统一放在同一个经过校验的发布版本里。

| 平台 | 官方安装包 | 环境要求 | 下载 |
| macOS | 已签名并公证的 .dmg，支持 Apple Silicon 与 Intel | Apple Silicon（arm64）或 Intel（amd64）Mac | 下载最新 macOS 版本 → |
| Linux | 已签名的原生 Host 归档包 | Linux x86_64 | 下载最新 Linux 版本 → |
| Windows | 已校验的原生 .zip，适用于 amd64 | Windows amd64 | 下载最新 Windows 版本 → |
| Docker / Unraid | GitHub Container Registry 上的加固镜像 | Linux x86_64，Docker 或 Unraid | 打开最新 Docker 版本 → |

macOS 安装

macOS

打开最新版本，按你的 Mac 选对应的磁盘映像：

- Apple Silicon（M1 及更新机型）选 darwin_arm64.dmg
- Intel 选 darwin_amd64.dmg

打开 DMG，把 MultiVibe Host 拖进 Applications，然后启动。应用用 Developer ID 签名，经 Apple 公证，从菜单栏运行。菜单栏标签跟随最近用过的服务商，并显示该服务商的剩余容量：按订阅计费时显示配额窗口，按量计费时显示以原币种计的剩余预付额度。点开后会弹出原生账户概览，列出每个账户的配额窗口、余额、重置时间和健康状态，全程不把账户 token 暴露给界面进程。

Linux 安装

Linux

下载 Linux amd64 发布资产；如果归档被拆成多个部分，按 NATIVE-MULTIPART.txt 的说明操作。重建并解压归档后，运行：

./install.sh

安装器在启动 Host 之前会校验发布包。它为当前用户安装，不需要 root 权限。系统如果有用户级 systemd 管理器，安装器还会启用带签名的自动更新定时器。定时器每小时检查一次，但更新器本身每 10 到 14 小时安排一次网络检查，并带本地随机偏移。

Windows 安装

Windows

下载 windows_amd64.zip 发布包，解压到临时目录，然后以当前用户身份运行 PowerShell：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

安装器在改动机器之前会校验完整包。它要求 Windows amd64，无需管理员权限即可安装，并注册当前用户的开始菜单快捷方式、登录项、multivibe:// 协议处理器和计划更新任务。原生 Win32 托盘菜单可以启动和停止 Host，并打开本地仪表盘。应用文件放在 %LOCALAPPDATA%\Programs\MultiVibe Host 下；私有状态和日志保留在 %LOCALAPPDATA%\MultiVibe 下。

需要 PowerShell 5.1 或更高版本。Windows 更新器会校验带签名的 feed 和 ZIP 内容，只停止可执行文件路径属于受管安装的 MultiVibe 进程；新 Host 未通过健康检查时，它会恢复上一版本。

Docker 和 Unraid 安装

Docker 和 Unraid

当前 Host 发布工作流会把同一份经过校验的 Linux 包发布到 GHCR，同时提供不可变版本和滚动的 latest 标签：

docker pull ghcr.io/thibautrey/multivibe-host:latest

要获得可复现的部署，请使用对应的 latest GitHub release 中显示的版本化标签或不可变摘要。Docker Hub、Homebrew、NAS 和 Windows 的其他分发包记录在 distribution guide 中。这些渠道需要先完成发布和平台验证，才能对外宣称可用。

Unraid 请参阅 installation and Community Applications submission guide。模板可用于手动安装；公开商店列表仍需 Community Applications 接受。

Docker Compose 和 Unraid 的配置记录在 Provider Host container 中。

更新与发布校验

原生 macOS、Linux 和 Windows 安装会检查经过认证的发布 feed，并且，默认情况下，在机器本地时间凌晨 02:00–06:00 之间，自动下载并安装符合条件的稳定版本，无需确认。每次安装会在 02:00 到 05:00 之间随机选一个开始时间，分散下载流量。错过时间窗口或 Host 繁忙时，顺延到之后的某个夜晚，唤醒或重启后也一样。下载和安装要求连续 30 分钟没有请求、WebSocket 轮次或作业；安装会在排空后重新检查活动。无法识别的活动按失败关闭处理。显式下载/安装操作不受夜间计划限制，但安装仍需要静默期。更新器会排空新工作，等待活动请求和模型操作结束，用内置的 Ed25519 信任根校验归档，暂存替换版本，并在重启后的 Host 未通过健康检查时恢复上一版本。仪表盘和 macOS 菜单栏可在自动安装、自动下载和仅通知三种模式之间切换。

容器永远拿不到 Docker socket，也永远不会自我替换。对于通用 Docker Compose，请从经过校验的 Linux 归档安装宿主机侧更新器。Unraid 用户可以使用平台的自动应用更新机制，配合已发布的 latest 标签。

[!NOTE]
如果 GHCR 报告找不到包，说明还没有带标签的 Host 版本完成 Docker 发布。请改用官方原生版本，或从本仓库构建，不要安装未经验证的第三方镜像。

[!TIP]
原生归档包含签名校验和、SBOM 和 GitHub 构建来源证明。在共享或生产基础设施上部署 Host 之前，请先阅读校验与安装指南。

📚 文档

GitHub wiki 包含用户指南、API 参考、配置、架构和历史报告。

- 快速开始
- 仪表盘
- 服务商与接入引导
- API 参考
- 插件 API 参考与迁移指南 — 沙箱、设置、模型服务、私有 SQLite 存储、补全遥测和虚拟路由
- 路由与别名
- 配置
- 本地开发

🤝 参与贡献

欢迎聚焦的 pull request 和 issue。UI 改动请附上改动前后的说明和截图。行为改动请补充或更新测试，并报告你运行过的校验命令。

👥 贡献者

感谢每一位帮助改进 MultiVibe 的人。这个展示页由 GitHub 的贡献者图表生成，会自动更新。

查看全部贡献者及其提交。

📄 许可证

本仓库的源代码，包括 MultiVibe Core 及其可审计的服务商宿主智能体，均按 Apache License 2.0 授权。该许可证包含明确的专利授权，允许在其条款下查看、修改和再分发。它不授予对托管服务 multivibe.cloud、服务账号、凭据、客户数据的访问权，也不授予 Apache-2.0 第 6 条之外的 Pleiades Solutions 商标使用权。

⭐ Star 历史

查看公开的 Star 历史。

GitHub Actions 中的 AI 发布说明

Host（v）和 Core 源码（source-v）发布会在发布前生成说明。请配置以下仓库 Settings → Secrets and variables → Actions 条目：

| 类型 | 名称 | 值 |
| Variable | RELEASE_NOTES_API_BASE_URL | 兼容 OpenAI 的 API 基础 URL，包含其 API 前缀，例如 https://api.openai.com/v1 |
| Variable | RELEASE_NOTES_MODEL | 该端点支持的模型 ID |
| Secret | RELEASE_NOTES_API_KEY | 该端点的 API 密钥 |

生成器调用 POST /chat/completions。它会把已提交的发布消息、GitHub 的 PR 变更日志、diff 统计和有界代码补丁发送给配置的服务商。密钥只在生成说明这一步可用，构建任务永远拿不到。不会记录任何服务商响应体或凭据。请配置一个 GitHub runner 能访问、且允许处理本仓库代码的端点。

基线是同一标签族中更早发布的最高版本，且其提交是新版本的祖先。稳定版排除预发布版；预发布版可以与更早的预发布版比较。草稿、未来版本和当前版本均被排除。首次发布使用其已提交的历史。完整的 GitHub 变更日志和比较链接仍保留在 AI 摘要下方。输入有界，被截断时会标注；生成的摘要可能省略细节。

下载链接由实际发布文件拼装，包括分卷归档和重建说明。不支持或未构建的目标会被省略。现有的容器安装说明仍保留在 Host 说明中。缺少 AI 配置、超时、响应无效或任何其他说明生成失败，都会产生 CI 警告，但不会让发布任务失败。这个可选步骤有三分钟超时。失败时，Host 发布使用 GitHub 原本生成的说明加上容器说明；源码发布使用其原本的静态发布说明。失败或不完整的 notes 文件永远不会发布。

运行 node --test scripts/generate-release-notes.test.mjs 即可校验，无需 API key。两个发布工作流都会把 release-notes.md 写到签名资产目录之外，再传给 gh release create --notes-file。