dofastted/vm2api

选用指南

AI 根据 README 整理 · 2026/10/20 09:46:45

使用方式

通过 Docker Compose 部署，提供管理面板和 API 端点，支持 Anthropic 和 OpenAI 兼容协议。

查看 README 依据

curl -sSL https://raw.githubusercontent.com/dofastted/vm2api/main/deploy/install.sh | sudo bash # 以后更新 curl -sSL https://raw.githubusercontent.com/dofastted/vm2api/main/deploy/install.sh | sudo bash -s -- upgrade ``` ARM64（aarch64）主机用同一条命令，脚本自动选择 `-arm64` 控制面镜像并准备 QEMU；实验性支持，见 [docs/ARM64.md](docs/ARM64.md)。 ### 2. 手动 Docker Compose 启动 ```bash mkdir -p /opt/vm2api && cd /opt/vm2api curl -sSLO https://raw.githubusercontent.com/dofastted/vm2api/main/docker-compose.yml curl -sSL -o .env https://raw.githubusercontent.com/dofastted/vm2api/main/.env.example chmod 600 .env

# 按需修改 .env 中的关键变量（VM2API_API_KEY, VM2API_ADMIN_PASSWORD, VM2API_DB_SECRET） docker compose pull && docker compose up -d ``` ### 3. 访问与调用 服务启动后，系统暴露统一服务端口（默认 `8787`）： - **可视化管理面板**：`http://<您的IP>:8787/console`（默认账号：`admin` / 密码：`123456` 或自定义环境变量） - **服务健康探活**：`GET http://<您的IP>:8787/health` - **Anthropic 协议调用**：`POST http://<您的IP>:8787/v1/messages` - **OpenAI 兼容协议**：`POST http://<您的IP>:8787/v1/chat/completions` ```bash # 调用示例（以 Anthropic 原生接口为例） curl -sS http://127.0.0.1:8787/v1/messages \ -H "Authorization: Bearer $VM2API_API_KEY" \ -H "content-type: application/json" \ -d '{

"model": "claude-sonnet-5-5", "max_tokens": 128000, "messages": [{"role": "user", "content": "Hello!"}] }' ``` --- ## 🔌 接口与协议兼容 vm2api 内置全栈自适应网关，原生支持以下所有主流生态： | 协议入口 | 对应标准 | 兼容客户端与场景 | |:---|:---|:---| | `/v1/messages` | Anthropic Messages API | Claude 官方 SDK、Cursor、Continue、LibreChat、Roo Code | | `/v1/chat/completions` | OpenAI Chat API | NextChat、Open WebUI、Lobechat、LangChain、AutoGPT | | `/v1/responses` | OpenAI Responses API | 新一代结构化智能体与高级编码工具生态 | | `/v1/models` | 标准模型列表 API | 按密钥 `group_type` 列出可调度模型：`openai` 仅 GPT，`anthropic` 仅 Claude，`all` 与 master 两者都列 | --- <br/>

部署要求

推荐在 Ubuntu 24.04 LTS 上安装，需要 Docker 环境，支持 ARM64 架构。

查看 README 依据

| **03 网页搜索** | 联网检索与外部工具调用 | **100% 干净** | 准确触发原生 `web_search` 并智能核算真实计费 | | **04 自我认知** | 探测模型系统提示词与底层身份 | **100% 干净** | 表现为纯净 Claude 官方模型能力 | | **05 角色扮演** | 复杂业务指令与预设遵从性 | **100% 干净** | 100% 服从用户设定的 System 与对话角色 | | **06 提示词探取**| 针对底层系统 Prompt 的逆向刺探 | **安全防护** | 0 注入架构天然免疫敏感系统词泄露 | | **07 强制工具** | 客户端指定 `tool_choice` 严格调度 | **100% 干净** | 完美执行客户端自定义函数定义与结构化输出 | > 完整测试套件与详细数据归档请参阅：[docs/benchmarks/README.md](docs/benchmarks/README.md)。 --- ## 🚀 快速开始（生产部署） 推荐在 **Ubuntu 24.04 LTS** 环境使用官方 Docker Compose 一键启动。 ### 1. 一键脚本安装（推荐） ```bash # 生产环境一键拉取并安装

curl -sSL https://raw.githubusercontent.com/dofastted/vm2api/main/deploy/install.sh | sudo bash # 以后更新 curl -sSL https://raw.githubusercontent.com/dofastted/vm2api/main/deploy/install.sh | sudo bash -s -- upgrade ``` ARM64（aarch64）主机用同一条命令，脚本自动选择 `-arm64` 控制面镜像并准备 QEMU；实验性支持，见 [docs/ARM64.md](docs/ARM64.md)。 ### 2. 手动 Docker Compose 启动 ```bash mkdir -p /opt/vm2api && cd /opt/vm2api curl -sSLO https://raw.githubusercontent.com/dofastted/vm2api/main/docker-compose.yml curl -sSL -o .env https://raw.githubusercontent.com/dofastted/vm2api/main/.env.example chmod 600 .env

已知限制

仅供个人学习、技术研究和自建使用，商业用途需获得作者书面授权。

查看 README 依据

<p style="color: #777; font-size: 12px; margin-top: 10px;">特别鸣谢 <b>LINUX DO</b> 等开源技术社区同仁的支持与建议</p> </div> --- ## 📈 Star History [](https://star-history.com/#dofastted/vm2api&Date) --- ## 📜 许可证与免责声明 / License - **个人与非商用**：本仓库遵循 [Noncommercial License](LICENSE)，仅供个人学习、技术研究与个人自建使用。 - **商业使用授权**：任何将本项目用于商业运营（包括对外付费 API、作为转售云服务基础组件、公司内部营利用途等）**必须事先取得作者正式书面授权**。授权联系请洽 [Telegram @VM2API](https://t.me/VM2API)。 - **免责声明**：vm2api 为独立的开源实验项目，与 Anthropic PBC 或 OpenAI 无任何直接关联。相关商标权属均归其对应公司所有。