thibautrey/multivibe

你的服务商。你的硬件。一个 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、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 密钥、追踪、成本/token/延迟统计、项目归因、导出，以及 Sentry 集成 |

MultiVibe 在 /v1 下和根路径下暴露相同的推理路由，以适配期望任一风格的客户端。在随附的 Compose 配置中，公共 :1455 套接字由原生 Rust 边缘直接提供服务；Node.js 仍保留在回环地址 127.0.0.1:1456 上，用于仪表盘 UI、OAuth、静态资源，以及尚未迁移的仪表盘资源路由。Rust 负责仪表盘会话认证、外层管理员访问防护、健康检查、只读 API 密钥与应用策略清单，以及所有公共推理路由。还提供兼容 Ollama 和 LiteLLM 风格发现的端点。

找到你的路径

| 快速开始 | 使用网关 | 运维与扩展 |
| --- | --- | --- |
| 下载 Host | 提供商与入门 | 追踪与项目 |
| 网关快速开始 | API 参考与示例 | 存储与本地模型 |
| 仪表盘导览 | 路由与别名 | 配置 |
| 安装指南 | 插件 API 与迁移 | 开发 · 更多文档 |

⬇️ 下载 MultiVibe Host
MultiVibe Host 是运行完整、安全受限的本地 Host 的最快方式：网关、仪表盘、私有设备身份、提供商代理和托管模型运行时。官方构建版本会一起发布在一个经过验证的版本中。

| 平台 | 官方软件包 | 要求 | 下载 |
| --- | --- | --- | --- |
| macOS | 适用于 Apple Silicon 和 Intel 的已签名并公证的 .dmg | Apple Silicon（arm64）或 Intel（amd64）Mac | 下载最新的 macOS 版本 → |
| Linux | 已签名的原生 Host 归档 | Linux x86_64，配备 NVIDIA GPU，计算能力 7.0+ | 下载最新的 Linux 版本 → |
| Windows | 适用于 amd64 的经过验证的原生 .zip | Windows amd64，配备 NVIDIA GPU，计算能力 7.0+ | 下载最新的 Windows 版本 → |
| Docker / Unraid | GitHub Container Registry 上的加固镜像 | Linux x86_64、Docker 或 Unraid、NVIDIA 容器运行时 | 打开最新的 Docker 版本 → |

macOS 安装

macOS

打开最新版本，并选择适合你的 Mac 的磁盘映像：

- darwin_arm64.dmg 适用于 Apple Silicon（M1 或更新）
- darwin_amd64.dmg 适用于 Intel

打开 DMG，将 MultiVibe Host 拖到 Applications，然后启动它。该应用使用 Developer ID 签名，由 Apple 公证，并从菜单栏运行。其菜单栏标签会在可用时显示 OpenAI 每周和五小时总剩余容量。打开它会显示原生账户概览，包括每个账户的配额窗口、重置时间和健康状况，而不会将账户令牌暴露给界面进程。

Linux 安装

Linux

下载 Linux amd64 版本资产，并在归档被拆分为多个部分时按照 NATIVE-MULTIPART.txt 操作。在重建并解压归档后，运行：

./install.sh

安装程序会在启动 Host 之前验证版本和受支持的 NVIDIA 硬件。它会为当前用户安装，并且不需要 root。在具有用户 systemd 管理器的系统上，它还会启用已签名的自动更新计时器。该计时器每小时检查一次，但更新程序本身会每 10 到 14 小时安排一次网络检查，并带有本地随机偏移。

Windows 安装

Windows

下载 windows_amd64.zip 版本，将其解压到临时目录，然后以当前用户身份运行 PowerShell：

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

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

需要 PowerShell 5.1 或更高版本。Windows 更新程序会验证已签名的源和 ZIP 内容，仅停止可执行文件路径属于受管理安装的 MultiVibe 进程，并且如果新的 Host 未通过健康检查，则恢复上一版本。

Docker 和 Unraid 安装

Docker 和 Unraid

当前 Host 发布工作流会将相同的已验证 Linux 捆绑包发布到 GHCR，同时作为不可变版本和滚动 latest 标签：

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

对于可复现的部署，请使用匹配的最新 GitHub 发布中显示的版本化标签或不可变摘要。其他 Docker Hub、Homebrew、NAS 和 Windows 分发包记录在分发指南中。这些渠道在被宣传为可用之前需要发布和平台验证。

对于 Unraid，请参阅安装和 Community Applications 提交指南。该模板可用于手动安装；公开商店列表仍需要 Community Applications 接受。

Docker Compose 和 Unraid 设置记录在
Provider Host 容器中。

更新和发布验证

原生 macOS、Linux 和 Windows 安装会检查经过身份验证的发布源，并且默认情况下，在夜间（机器本地时间 02:00–06:00）下载并安装符合条件的稳定版本，无需确认。每个安装会持久保留一个 02:00 到 05:00 之间的随机开始时间，以分散下载流量。错过的窗口和繁忙的 Host 会推迟到之后的夜间，包括在唤醒或重启之后。下载和安装需要 30 分钟内没有请求、WebSocket 轮次或作业；安装会在排空后重新检查活动。未知活动会按失败关闭处理。显式下载/安装操作会绕过夜间计划，但安装仍需要静默期。更新程序会排空新工作，等待活动请求和模型操作，使用嵌入式 Ed25519 信任根验证归档，暂存替换文件，并且如果重启后的 Host 未通过健康检查，则恢复上一版本。仪表板和 macOS 菜单栏可以在自动安装、自动下载和仅通知模式之间切换。
容器永远不会接收 Docker socket，也永远不会自我替换。对于
通用 Docker Compose，请从经过验证的 Linux
归档安装主机端更新器。Unraid 用户可以使用该平台的自动应用程序更新
机制，并使用已发布的 latest 标签。

[!NOTE]
如果 GHCR 报告未找到该软件包，则说明尚未完成任何带有
Docker 发布功能的已标记 Host 版本。请改用官方原生版本，或从此仓库
构建，而不要安装未经验证的第三方镜像。

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

📚 文档

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

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

🤝 贡献

欢迎提交聚焦的拉取请求和问题。对于 UI 更改，请包含
更改前后的描述和截图。对于行为更改，请添加或更新
测试，并报告你运行的验证命令。

👥 贡献者

感谢所有帮助改进 MultiVibe 的人。此画廊由
GitHub 的贡献者图生成，并会自动更新。

查看所有贡献者及其提交。

📄 许可证

此仓库中的源代码，包括 MultiVibe Core 及其可审计的
provider-host agent，均根据 Apache License 2.0 授权。该
许可证包含明确的专利授权，并允许根据其条款进行检查、修改
和再分发。它不授予对托管
multivibe.cloud 服务、服务账户、凭据、客户数据或
Pleiades Solutions 商标的访问权，超出 Apache-2.0 第 6 节的范围。

⭐ 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 变更日志、差异统计信息以及有界代码补丁发送到配置的提供商。该密钥仅对说明步骤可用，绝不会提供给构建作业。
不会记录任何提供商响应正文或凭据。请配置一个可从 GitHub runner 访问、且被允许处理此仓库代码的端点。

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

下载链接根据实际发布文件组装，包括多部分归档和重建说明。不支持/未构建的目标会被省略。
现有的容器安装说明保留在 Host 说明中。缺少 AI 配置、超时、无效响应或任何其他说明生成失败都会产生 CI 警告，但不会导致发布作业失败。该可选步骤有三分钟超时。失败时，Host 发布使用原始的 GitHub 生成说明加上容器说明；源码发布使用其原始的静态发布描述。失败或不完整的说明文件绝不会被发布。

运行 node --test scripts/generate-release-notes.test.mjs 可在没有 API 密钥的情况下进行验证。两个发布工作流都会将 release-notes.md 写入已签名资产文件夹之外，并将其传递给 gh release create --notes-file。