Metapi 进阶指南：打造 AI 中转聚合网关的“元管理层”

如果你手中握有多个 New API、One API、OneHub 或 AnyRouter 的账号，你一定体会过那种“余额分散、模型混乱、手动切换”的痛苦。Metapi 并非另一个简单的 AI 中转站，它是位于所有中转站之上的元聚合层（Meta-Aggregation Layer）。它能将你所有的上游站点汇聚成一个统一的 API 入口，并提供智能路由、自动签到、成本优化等极客功能。

Metapi 彻底解决了开发者在多站点管理时的心智负担。通过它，你只需要管理一个 PROXY_TOKEN，即可让下游工具（如 Cursor、Open WebUI、Claude Code）无感调用所有关联站点的最优质模型。

简介

Metapi 是一个基于 Fastify 与 React 18 构建的高性能 AI 聚合网关。它通过自动化手段，解决了多站点余额监控难、模型定价不透明以及上游通道不稳定的核心痛点。它不仅是一个代理转发器，更是一个带有“智能大脑”的资源调度器。

架构

核心功能

• 统一代理网关 🌐：支持 OpenAI 与 Claude 格式的双向转换，完美适配 SSE 流式传输。
• 智能路由引擎 🧠：基于成本 (40%)、余额 (30%)、使用率 (30%) 自动计算最优路径。
• 自动故障转移 🔄：某个站点挂了？Metapi 会自动将其放入 10 分钟“冷却期”并无感切到备用通道。
• 全自动模型发现 🔍：无需手动添加，自动同步上游站点的最新模型列表，实现零配置上线。
• 多渠道告警通知 🔔：支持 Webhook、Bark、Telegram、Server酱等，余额不足及时提醒。
• 自动化日常运维 ✅：内置 Cron 定时任务，支持多站点自动签到领额度，省心省力。

视觉辅助

特性分类	技术细节 / 优势	推荐指数
架构设计	单 Docker 镜像 + 内置 SQLite，迁移备份极易 📦	⭐⭐⭐⭐⭐
路由逻辑	实测成本优先 + 加权随机概率分配，兼顾稳定与低价 ⚖️	⭐⭐⭐⭐⭐
状态追踪	具备 Healthy / Degraded / Disabled 四级状态机管理 🏥	⭐⭐⭐⭐
隐私安全	所有凭证本地加密存储，不经过任何第三方服务器 🔒	⭐⭐⭐⭐⭐

---

准备工作

在部署 Metapi 前，请确保你已经准备好：

1. 基础设施：一台已安装 Docker 与 Docker Compose 的 Linux 服务器（1核1G即可）。
2. 管理信息：
   • AUTH_TOKEN：管理员后台登录令牌（必设）。
   • PROXY_TOKEN：下游客户端调用的 Bearer Token（必设）。
3. 上游账号：准备好你各个中转站的 API 地址与令牌。

---

部署步骤

Metapi 提供了多种部署方案，确保初学者到高级用户都能快速上手。

1. Docker 命令行部署 (极速方案)

适合希望快速验证功能的场景。

docker run -d --name metapi -p 4000:4000 \
  -e AUTH_TOKEN=your-admin-token \
  -e PROXY_TOKEN=your-proxy-sk-token \
  -v ./data:/app/data \
  --restart unless-stopped \
  1467078763/metapi:latest

2. Docker Compose 部署 (推荐方案)

通过配置文件管理环境参数，更适合生产环境。创建 docker-compose.yml：

version: '3'
services:
  metapi:
    image: 1467078763/metapi:latest
    container_name: metapi
    restart: unless-stopped
    ports:
      - "4000:4000"
    environment:
      - AUTH_TOKEN=your-strong-admin-token
      - PROXY_TOKEN=sk-metapi-your-key
      - TZ=Asia/Shanghai
      - CHECKIN_CRON=0 8 * * * # 每天早上8点自动签到
      - BALANCE_REFRESH_CRON=0 * * * * # 每小时刷新一次余额
    volumes:
      - ./data:/app/data

启动命令：docker-compose up -d

3. Nginx 反向代理配置 (进阶)

为了让 SSE（流式输出）正常工作，必须在 Nginx 中关闭缓存与缓冲：

location / {
    proxy_pass http://127.0.0.1:4000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    
    # 核心：支持流式传输
    proxy_buffering off;
    proxy_cache off;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    chunked_transfer_encoding off;
}

4. 客户端接入示例

• Cursor: 设置 -> Models -> OpenAI API Key 填入 PROXY_TOKEN，Base URL 填入 https://your-domain.com/v1。
• Open WebUI: 设置 -> Connections -> OpenAI API URL 填入 https://your-domain.com/v1。

---

总结评价

Metapi 是目前市场上少有的、专门针对“中转站聚合”这一细分需求做出极致优化的工具。

• 优点：
  • 智能路由决策：不再盲目使用某个 Key，而是基于成本动态计算，真正帮你省钱。
  • 架构极简：Node.js + SQLite 的组合让它在资源极其有限的机器上也能流畅运行。
  • 体验丝滑：自动格式转换让原本只支持 OpenAI 格式的站点也能顺畅供应 Claude 客户端。
• 缺点：
  • 配置深度：智能路由的权重因子（Cost vs Balance）虽然可以微调，但对新手可能有一定的理解门槛。
  • 单一镜像：目前仅支持单机 SQLite，对于极大流量的集群部署尚需扩展。

适用建议：如果你手里有超过 3 个中转站账号，或者正在为 Cursor 的多模型切换感到头疼，Metapi 是你的不二之选。

---

项目地址

资源项	链接地址
GitHub 仓库	https://github.com/cita-777/metapi
在线文档	https://metapi.cita777.me/