manifestdotbuild/manifest

Manifest

什么是Manifest？

Manifest是个人AI代理（如OpenClaw、Hermes或任何支持OpenAI兼容HTTP API的工具）的智能模型路由器。它位于您的代理和LLM提供商之间，对每个请求进行评分，并将其路由到能够处理该请求的最便宜模型。简单问题分配给快速、低成本的模型，复杂问题分配给更专业的模型。无需额外操作即可节省成本。

• 将请求路由到合适模型：最高节省70%成本
• 自动回退：若模型请求失败，自动切换到下一个模型
• 设置限制：避免超出预算
• 自托管：您的请求、提供商和数据完全由您掌控

目录

• 支持的提供商
• Manifest与OpenRouter对比
• 安装
  • 选项1：快速启动安装脚本（推荐）
  • 选项2：Docker Compose（手动）
  • 选项3：Docker Run（自带PostgreSQL）
  • 验证镜像签名
  • 自定义端口
• 镜像标签
• 升级
• 备份与持久化
• 环境变量
• 链接

支持的提供商

支持300+模型，涵盖OpenAI、Anthropic、Google Gemini、DeepSeek、xAI、Mistral、Qwen、MiniMax、Kimi、Amazon Nova、Z.ai、OpenRouter、Ollama以及任何支持OpenAI兼容API的提供商。通过API密钥连接，或在支持的情况下复用现有付费订阅（如*** Plus/Pro、Claude Max/Pro、GLM Coding Plan等）。

Manifest与OpenRouter对比

安装

以下三种安装方式，按从简单到手动的顺序排列。所有方式最终都会在http://localhost:3001%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%9C%A8%E6%AD%A4%E6%B3%A8%E5%86%8C%E8%B4%A6%E5%8F%B7%E3%80%82%E5%88%9B%E5%BB%BA%E7%9A%84%E7%AC%AC%E4%B8%80%E4%B8%AA%E8%B4%A6%E5%8F%B7%E5%B0%86%E6%88%90%E4%B8%BA%E7%AE%A1%E7%90%86%E5%91%98%EF%BC%8C%E6%97%A0%E9%A2%84%E8%AE%BE%E6%BC%94%E7%A4%BA%E5%87%AD%E6%8D%AE%E3%80%82

网络绑定注意事项：默认的compose文件将端口3001绑定到127.0.0.1，因此控制台仅可在主机上访问，无法通过局域网访问。如需暴露到局域网外，请参见自定义端口。

选项1：快速启动安装脚本（推荐）

单命令安装。安装程序会下载compose文件、生成密钥并启动服务。启动过程约需30秒。

bash
bash <(curl -sSL https://raw.githubusercontent.com/mnfst/manifest/main/docker/install.sh)

bash
curl -sSLO https://raw.githubusercontent.com/mnfst/manifest/main/docker/install.sh

bash
less install.sh

bash
bash install.sh

可用标志：--dir <路径>指定安装目录，--dry-run预览安装过程，--yes跳过确认提示。

选项2：Docker Compose（手动）

与安装脚本流程相同，但需手动操作，以便在启动前编辑配置。

1. 将compose文件和环境变量模板下载到同一目录：

bash
curl -O https://raw.githubusercontent.com/mnfst/manifest/main/docker/docker-compose.yml
curl -O https://raw.githubusercontent.com/mnfst/manifest/main/docker/.env.example
cp .env.example .env

2. 用编辑器打开.env，将BETTER_AUTH_SECRET设置为随机字符串。可通过以下命令生成：

bash
openssl rand -hex 32

（可选：如需使用更强的数据库密码，需同时在.env中设置POSTGRES_PASSWORD和DATABASE_URL，两者必须一致，且密码中的特殊字符需在URL中进行百分比编码。）

3. 启动服务：

bash
docker compose up -d

启动过程约需30秒。

4. 打开http://localhost:3001%E5%B9%B6%E6%B3%A8%E5%86%8C%E8%B4%A6%E5%8F%B7%E3%80%82%E5%88%9B%E5%BB%BA%E7%9A%84%E7%AC%AC%E4%B8%80%E4%B8%AA%E8%B4%A6%E5%8F%B7%E5%B0%86%E6%88%90%E4%B8%BA%E7%AE%A1%E7%90%86%E5%91%98%E3%80%82

停止服务：

bash
docker compose down       # 保留数据
docker compose down -v    # 删除所有数据

选项3：Docker Run（自带PostgreSQL）

如果您已运行PostgreSQL，将user、pass和host替换为实际数据库凭据，然后在终端运行以下命令：

bash
docker run -d \
  -p 3001:3001 \
  -e DATABASE_URL=postgresql://user:pass@host:5432/manifest \
  -e BETTER_AUTH_SECRET=$(openssl rand -hex 32) \
  -e BETTER_AUTH_URL=http://localhost:3001 \
  -e AUTO_MIGRATE=true \
  manifestdotbuild/manifest

powershell
$secret = -join ((48..57 + 97..122) | Get-Random -Count 64 | ForEach-Object { [char]$_ })

docker run -d `
  -p 3001:3001 `
  -e DATABASE_URL=postgresql://user:pass@host:5432/manifest `
  -e BETTER_AUTH_SECRET=$secret `
  -e BETTER_AUTH_URL=http://localhost:3001 `
  -e AUTO_MIGRATE=true `
  manifestdotbuild/manifest

cmd
docker run -d ^
  -p 3001:3001 ^
  -e DATABASE_URL=postgresql://user:pass@host:5432/manifest ^
  -e BETTER_AUTH_SECRET=<您的64字符密钥> ^
  -e BETTER_AUTH_URL=http://localhost:3001 ^
  -e AUTO_MIGRATE=true ^
  manifestdotbuild/manifest

AUTO_MIGRATE=true会在首次启动时运行数据库迁移。然后打开http://localhost:3001%E5%B9%B6%E6%B3%A8%E5%86%8C%E8%B4%A6%E5%8F%B7%E3%80%82%E5%88%9B%E5%BB%BA%E7%9A%84%E7%AC%AC%E4%B8%80%E4%B8%AA%E8%B4%A6%E5%8F%B7%E5%B0%86%E6%88%90%E4%B8%BA%E7%AE%A1%E7%90%86%E5%91%98%E3%80%82

验证镜像签名

发布的镜像使用cosign无密钥签名（Sigstore）。拉取前可验证：

bash
cosign verify manifestdotbuild/manifest:<version> \
  --certificate-identity-regexp="^https://github.com/mnfst/manifest/" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com"

自定义端口

若端口3001被占用，需同时修改端口映射和BETTER_AUTH_URL：

bash
docker run -d \
  -p 8080:3001 \
  -e BETTER_AUTH_URL=http://localhost:8080 \
  ...

或在docker-compose.yml中：

yaml
ports:
  - '127.0.0.1:8080:3001'

并在.env中：

env
BETTER_AUTH_URL=http://localhost:8080

暴露到局域网

默认compose文件仅将端口3001绑定到127.0.0.1，控制台仅可从主机访问，无法从局域网其他机器访问。如需暴露到局域网：

1. 编辑docker-compose.yml，将ports行从"127.0.0.1:3001:3001"改为"3001:3001"。
2. 在.env中，将BETTER_AUTH_URL设置为访问控制台的主机地址，例如http://192.168.1.20:3001或https://manifest.mydomain.com。该地址必须与浏览器中的URL匹配，否则Better Auth会因“无效源”拒绝登录。
3. 运行docker compose up -d应用更改。

若登录页面显示“无效源”，说明BETTER_AUTH_URL与访问控制台的URL不匹配，主机和端口都需一致。

镜像标签

每个版本发布时包含以下标签：

• {major}.{minor}.{patch} - 完全固定版本（如5.46.0）
• {major}.{minor} - 次版本内的最新补丁（如5.46）
• {major} - 主版本内的最新次版本+补丁（如5）
• latest - 最新稳定版本
• sha-<short> - 精确提交版本（用于回滚）

镜像支持linux/amd64和linux/arm64架构。

升级

Manifest每次发布都会更新镜像。如需升级现有compose安装：

bash
docker compose pull
docker compose up -d

数据库迁移会在启动时自动运行，无需手动操作。pgdata卷中的数据在升级过程中会保留。若需控制主版本升级时机，可在docker-compose.yml中固定主版本标签（如manifestdotbuild/manifest:5）。

备份与持久化

所有状态存储在postgres服务中挂载于/var/lib/postgresql/data的pgdata命名卷中。Manifest容器中无其他状态数据。

备份（在主机上，服务运行时）：

bash
docker compose exec -T postgres pg_dump -U manifest manifest > manifest-backup-$(date +%F).sql

恢复到新服务：

bash
docker compose up -d postgres
cat manifest-backup-2026-04-12.sql | docker compose exec -T postgres psql -U manifest manifest
docker compose up -d

手动列出/删除卷：

bash
docker volume ls | grep pgdata
docker compose down -v    # ⚠ 销毁所有数据

环境变量

完整环境变量参考：https://github.com/mnfst/manifest

链接

• https://github.com/mnfst/manifest
• 官网
• 文档

• ---

许可证

https://github.com/mnfst/manifest/blob/main/LICENSE