Metapi 桌面版安装教程Mac / Windows 本地私有 AI 网关开机即用【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapiMetapi 桌面版是一个本地私有 AI 网关能把你在 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等中转站上的账号汇聚成一个 API Key、一个入口。桌面版面向个人电脑Mac / Windows 双击安装即可运行无需 Node.js、无需 Docker开机即用10 分钟完成从安装到接入模型的全流程。一、Metapi 桌面版是什么中转站的中转站Metapi 定位是中转站之上的元聚合层Meta-Aggregation Layer解决的核心痛点是痛点Metapi 桌面版怎么解决 每个站点一个 Key下游工具要配一堆统一代理入口模型自动聚合到/v1/* 不知道哪个站用某个模型最便宜智能路由按成本、余额、使用率自动选路 某个站点挂了要手动切换失败通道自动冷却并切换到下一个 余额分散在各处集中看板余额不足自动告警✅ 每天要手动去各站签到自动签到默认每日 08:00奖励自动追踪作为桌面应用它额外做了三件事让本地私有 AI 网关真正开箱即用内置本地服务桌面壳自动拉起后端数据全部存在本机不经过任何第三方托盘常驻关闭窗口后服务仍在后台运行托盘菜单可重新打开窗口、重启后端、打开日志目录开机自启托盘菜单勾选Launch at Login电脑开机即自动拉起网关AI 工具随时可用。桌面端实现入口可参考 src/desktop/main.ts完整部署说明见 docs/deployment.md。二、Mac / Windows 桌面版一键安装步骤安装过程只有三步下载安装包到官方 Releases 发布页下载与你系统匹配的桌面版安装包Mac 注意选择 Intel / Apple Silicon 对应版本Windows 下载对应的桌面安装包。安装并启动双击安装启动 Metapi Desktop。桌面壳会自动启动本地服务并创建数据目录无需手动准备 Node.js 环境。登录管理后台应用启动后会直接打开桌面窗口。首次启动若未额外注入令牌管理员登录令牌默认为change-me-admin-token输入后即可进入后台。⚠️安全提醒默认令牌只适合本机初始调试首次登录后建议立即到「设置」里改成你自己的强密码令牌。安装后需要知道的关键信息项目说明管理界面桌面窗口直接打开无需记端口本地代理地址默认http://127.0.0.1:4000下游客户端直连即可数据目录本机用户数据目录下的data文件夹Windows 常见为%APPDATA%\Metapi\data升级时自动保留日志目录同级的logs文件夹托盘菜单Open Logs Folder可一键打开三、开机自启配置与端口冲突排查3 步配置开机自启关闭窗口让 Metapi 最小化到系统托盘右键托盘图标勾选Launch at Login开机自启重启电脑验证开机后托盘自动出现 Metapi 图标网关即处于可用状态。端口被占用怎么办桌面版默认使用4000端口。如果该端口被其他应用占用设置环境变量METAPI_DESKTOP_SERVER_PORT空闲端口后重启应用或关闭占用 4000 端口的程序再启动 Metapi。日志中会明确打印Dashboard: http://127.0.0.1:4000与Proxy API地址以日志里的实际端口为准。更多环境变量见 docs/configuration.md。四、首次使用三步接入你的上游 AI 站点步骤 1添加站点进入站点管理填写站点名称和 URL平台通常可自动检测new-api/one-api/one-hub/done-hub/veloera/anyrouter/sub2api等检测失败时再手动选择平台或官方预设DeepSeek、Moonshot、MiniMax 等。步骤 2添加连接按站点形态三选一面板型站点new-api、done-hub 等→ 到账号管理填入用户名和访问凭证系统自动登录并拉取余额API Key 型OpenAI / Claude / Gemini 兼容接口、官方预设→ 到API Key 管理填入你的 KeyProvider 原生授权Codex、Claude、Gemini CLI→ 到OAuth 管理完成授权。步骤 3自动发现模型并验证连接成功后系统会自动发现模型并生成路由表无需手动配置。进入路由管理可看到各通道的分配概率还支持创建群组对模型进行匹配重定向。最后验证代理链路把your-proxy-sk-token换成你在后台创建/设置的代理令牌curl -sS http://127.0.0.1:4000/v1/models \ -H Authorization: Bearer your-proxy-sk-token能返回模型列表说明网关已可用。五、接入下游工具一个 Key 打通 Cursor / Claude Code / Open WebUIMetapi 暴露标准OpenAI / Claude 兼容接口下游工具通常只需配置两项配置项值Base URLhttp://127.0.0.1:4000/v1自动补/v1的字段填http://127.0.0.1:4000API Key你的代理令牌PROXY_TOKEN或后台创建的下游 API Key常见客户端示例客户端配置位置CursorSettings → ModelsBase URL 填http://127.0.0.1:4000/v1API Key 填代理令牌Claude CodeANTHROPIC_BASE_URL填http://127.0.0.1:4000勿手动加/v1Key 填代理令牌Open WebUI / Cherry StudioOpenAI API 地址填http://127.0.0.1:4000/v1Key 填代理令牌模型列表由/v1/models自动拉取上游新增模型零配置出现在你的模型列表里。详细接入方式见 docs/client-integration.md。想快速验证某个模型是否可用可直接在模型操练场中交互式对话测试对比不同通道的输出质量。六、常见问题桌面版启动失败、401、模型列表为空桌面版启动失败 / 后端启动失败确认下载的安装包与系统匹配Intel / Apple Silicon、Windows 架构别下错Windows 首次运行出现未知发布者提示时确认安装包来自官方发布渠道打开托盘菜单Open Logs Folder查看最新日志定位原因。下游客户端提示 401 / 403确认用的是代理令牌调用/v1/*而不是管理后台的管理员令牌两者不要混用。/v1/models返回空列表按顺序检查是否添加了站点 → 账号是否unhealthy到账号管理刷新→ 面板型站点是否同步了 Token → 到「设置 → 清除缓存并重建路由」后重试。想 7×24 运行而不是只在个人电脑用桌面版面向单机本地使用服务器长期运行请改用 Docker / Docker Compose 方案参考 docs/deployment.md。更多问题见 docs/faq.md。七、小结使用场景推荐方式个人电脑本地使用、开机即用✅ Metapi 桌面版本教程服务器 / NAS 长期 7×24 运行Docker / Docker Compose二次开发 / 调试源码本地开发Metapi 桌面版把多站点、多 Key、多模型的复杂度收敛成了一个安装、一个 Key、一个入口装好之后你的 Cursor、Claude Code、Open WebUI 等工具只需指向http://127.0.0.1:4000就能无感使用所有上游站点的模型并由智能路由自动选出成本最优的通道。数据全部保存在本机隐私完全可控这就是本地私有 AI 网关的意义。新手完整流程可对照 docs/getting-started.md 逐步操作祝你部署顺利 【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考