vm2api

完全隔离的虚拟机级 AI 订阅转 API 生产网关

Next-Generation Fully Isolated VM-Level AI Subscription-to-API Gateway

🇨🇳 简体中文 • 🇬🇧 English • 🗺️ 技术路线 • 🚀 部署指南 • 📊 干净度基准 • ☕ 支持捐赠

---

• 💡 项目概览
• 🛡️ 九大核心特性（特色防封与拟真矩阵）
  • 0️⃣ 独家 0 提示词注入机制 & 改写引擎
  • 1️⃣ 真实拟真物理机环境
  • 2️⃣ 官方 Claude Code 真实进程转发
  • 3️⃣ 智能前置拦截与“蒸馏拦截”
  • 4️⃣ 完整的隔离网络环境（1 VM = 1 独立网络出口）
  • 5️⃣ 前置协议清洗与多协议统一结构化
  • 6️⃣ 官方遥测（Telemetry）可控开关
  • 7️⃣ 分布式集群系统（多 VPS 跨机舰队管理）
  • 8️⃣ 完整的企业级 API 密钥与配额管理
• 📊 干净度基准评测（Benchmarks）
• 🚀 快速开始（生产部署）
• 🔌 接口与协议兼容
• 💬 交流与赞助支持
• 📜 许可证与免责声明

在当今大模型服务中，直接使用第三方逆向脚本或共享代理极易触发风控导致封号、降权与服务中断。vm2api 是业界领先的虚拟机级 API 转换中继系统：

• 支持平台：全面支持 Anthropic (Claude Pro / Team / Enterprise / Max) 以及 OpenAI (ChatGPT / Codex) 订阅转标准 API。
• 真实载体：Anthropic 采用官方客户端在隔离 VM / 容器内运行真实系统进程，而非第三方伪造 HTTP 模拟。
• 全链路拟真：从物理机硬件指纹（SMBIOS、MAC、Machine-ID）到独立 SOCKS5 / 本地网络出口，全方位还原真实开发者电脑环境。
• 极简集成：向上游输出标准 OpenAI /v1/chat/completions、/v1/responses 与 Anthropic /v1/messages 兼容接口，任何支持标准 API 的前端、Agent 或应用均可无缝接入。

• 无感透传，告别 System 篡改：传统中继依赖向 Prompt 注入大段系统人设与假装指令，不仅消耗高昂 Token，还极易引发模型“自我认知混乱”并被上游识别封号。vm2api 身份在凭证层即对齐官方形态，做到真正 0 提示词注入（Zero Prompt Injection）。
• 改写引擎与模板定制：提供从 zero（完全零注入）、official、official_full 到自定义改写模板的灵活切换，满足特殊上下文场景需求。
• 提供公开 Benchmarks：随仓库公开提供干净度测试套件与判定报告，杜绝官方内置工具及泄露痕迹，供所有人测试与对比检验。

• 消除云主机与多开痕迹：不仅是普通 Docker 容器，更可支持真虚拟机（KVM / QEMU）。
• 全套物理硬件指纹拟真：针对上游平台的设备探测，深度拟真真实物理机的硬件特征，涵盖独立 SMBIOS 信息、网卡 MAC 地址、CPU 拓扑、系统序列号、时区与真实的 /etc/machine-id。

• 官方原版二进制常驻守护：每一个 VM / 容器槽位内部均运行 Anthropic 原版 Claude Code 二进制程序，通过内核级 Unix Domain Socket 与协议路由总线通信，完全继承官方客户端签名与合规信誉，杜绝第三方逆向 HTTP 模拟带来的指纹泄露与封禁风险。
• 原生多路 Subagent 高并发调度：单槽位原生支持多达 20 路 Subagent 会话并发交互。会话上下文在槽位内部原生隔离与状态持久化，享受官方客户端热缓存（Prompt Caching）加速与极致响应速度。
• 5h / 7d 官方用量窗口智能对齐：控制面实时对齐 Anthropic 官方 5 小时滚动窗口与 7 天硬限消耗，精确计算重置倒计时（精确到分钟级）。支持设置水位报警阈值，额度逼近硬限时自动熔断并将流量平滑降级调度至空闲槽位。
• 全生命周期槽位状态机与健康监控：实时追踪槽位调度状态（在池调度、5h/7d 冷却保护、调用关闭、凭证失效）。支持优先级分级路由（高优先级 VIP 槽位专属调度）、单槽独立成本流水统计与一键额度全槽健康探测。

_{线上生产环境实机运行脱敏截图：Claude / GPT 多槽位舰队状态、20 路并发承载、5h/7d 官方配额窗口追踪与实时成本流水}

• 反逆向与蒸馏提权拦截：自动识别并拦截针对大模型的知识蒸馏（Model Distillation）、思维链逆向抓取（CoT Extraction）及恶意提示词攻击，不消耗官方额度。
• 上游 AUP / Refusal 智能阻断卫士：
  • 实时捕获并分析官方请求与响应中的违规特征（Anthropic AUP 政策风险 / stop_reason=refusal / content_filter）。
  • 违规特征落库形成智能防护指纹，在网关入口处直接予以拦截，彻底阻断违规请求触碰官方账号，从根本上杜绝因敏感 Prompt 导致的账号封禁。

• 绝不共享 IP 资源：系统严格要求每一个 VM / KVM 槽位必须且只能绑定一条独立的网络出口才能启动运行（支持专用独立 SOCKS5 代理、高匿出口池或独立本地出站网络）。
• 彻底告别关联连带封号：账号之间绝对网络物理隔离，即便单条代理波动或单个账号受限，绝不殃及集群内的其它账号。
• 安全自定义 DoH 解析：支持配置企业级自定义 HTTPS DoH（DNS-over-HTTPS）上游解析，全程代理加密传输，防止 DNS 劫持与 ISP 侧特征分析。

• 入站多协议通吃：客户端可以使用 Anthropic 原生协议（/v1/messages）、OpenAI 标准格式（/v1/chat/completions）或新版 /v1/responses 格式发起请求。
• 深度清洗与官方对齐：控制面在毫秒级内完成协议清洗与规范化，纠正非法角色、清理脏工具参数、补齐结构化要求，最终向 VM 内部官方进程交付符合官方客户端完全规范的纯净载荷。

• 全量遥测模拟：目标是让官方服务判定每一个槽位都是一台完全独立、在真实开发中活跃运行的电脑。
• 细粒度自主可控：控制面提供全量遥测开关配置，可根据部署策略自主选择启用、隔离或特定遥测行为，既保留官方客户端信誉特征，又确保隐私边界。

• SSH 极简跨机纳管：主控面通过原生 SSH 链接全球多台 VPS 节点，无需在远端节点繁琐部署复杂 Agent。
• 远程 Docker 统一编排：直接跨机调度与管理各节点的容器与网络，槽位支持在集群节点自由放置与负载均衡。
• 内置安全 Web 终端：基于 WebSocket + xterm 的一次性安全 Ticket 运维终端，直接在控制台一键直连管理远端槽位与 Docker 容器。

• 多层级密钥体系：拥有主控制 Master Key 以及针对团队或租户的多级 API Key，密钥入库采用 HMAC 索引与高强度加密。
• 官方配额窗口精确对齐：对齐官方 5h / 7d 动态用量窗口与硬限保护，支持槽位独立配额覆盖，提供自动熔断、故障降级与空闲负载平衡。
• 实时审计与成本统计：提供精确到 TTFT（首 Token 延迟）、真实 Prompt / Completion / 缓存命中 Token 的详尽流水与可视化图表分析。

vm2api 严格遵循行业最严苛的纯净度基准。入站请求不泄露官方 CLI 身份、不外漏任何未授权的系统提示词与内部内置工具。

完整测试套件与详细数据归档请参阅：docs/benchmarks/README.md。

推荐在 Ubuntu 24.04 LTS 环境使用官方 Docker Compose 一键启动。

# 生产环境一键拉取并安装
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

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

服务启动后，系统暴露统一服务端口（默认 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

# 调用示例（以 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 内置全栈自适应网关，原生支持以下所有主流生态：

• 💡 Overview
• 🛡️ 9 Core Pillars (Anti-Ban & Emulation Matrix)
  • 0️⃣ Zero Prompt Injection Engine
  • 1️⃣ Physical Hardware Fingerprint Emulation
  • 2️⃣ Official Claude Code Native Process Forwarding
  • 3️⃣ Pre-Interception & "Anti-Distillation" Shield
  • 4️⃣ Completely Isolated Network (1 VM = 1 Egress)
  • 5️⃣ Deep Protocol Cleansing & Multi-Inbound Structuring
  • 6️⃣ Configurable Official Telemetry
  • 7️⃣ Multi-VPS Cluster Management
  • 8️⃣ Enterprise API Key & Quota Management
• 📊 Cleanliness Benchmarks
• 🚀 Quick Start (Production Setup)
• 💬 Community & Sponsorship
• 📜 License & Compliance

Traditional methods of converting AI subscriptions into API endpoints via simple reverse proxies frequently result in immediate account suspensions, stealth downgrades, and token corruption. vm2api is an enterprise-grade virtual machine gateway designed for ultra-reliable subscription-to-API infrastructure:

• Universal Support: Seamlessly converts Anthropic (Claude Pro / Team / Enterprise / Max) and OpenAI (ChatGPT / Codex) subscriptions into robust standard APIs.
• Genuine Client Process: Runs the authentic official Claude Code CLI system process inside an isolated VM / container instance instead of fragile HTTP emulation.
• High-Fidelity Emulation: From physical SMBIOS, NIC MAC, and Machine-ID to dedicated per-slot network egress and smart upstream AUP guards.
• Standard Compatibility: Provides drop-in replacements for Anthropic /v1/messages and OpenAI /v1/chat/completions / /v1/responses.

• No System Prompt Tampering: Unlike ordinary proxies that tamper with the system prompt and poison model identity, vm2api aligns credentials at the protocol layer as a genuine Console client.
• Customizable Layouts: Switch effortlessly between zero (pure zero-injection), official, official_full, and tailored templates.
• Transparent Benchmarks: Built-in benchmark suite guarantees no leaking of internal CLI tools or hidden instructions.

• Eradicate Virtual Machine Artifacts: Supports containerized slots as well as genuine KVM/QEMU hypervisor nodes.
• Comprehensive Hardware Spoofing: Simulates realistic hardware traits including SMBIOS identifiers, NIC MAC addresses, CPU architectures, system serials, and distinct /etc/machine-id.

• Authentic Official Binary Daemon: Every VM / container slot runs the authentic, official Claude Code binary daemon inside an isolated hypervisor sandbox. Requests are relayed via kernel-level Unix Domain Sockets, completely eliminating heuristic fingerprint leakage caused by custom reverse proxies.
• Native 20-Subagent Concurrency per Slot: Each slot natively orchestrates up to 20 concurrent subagent threads with isolated conversation states and official prompt caching reuse.
• 5h / 7d Upstream Quota Alignment: Automatically aligns with Anthropic's rolling 5-hour and 7-day budget windows, calculating reset deadlines down to the minute. Integrates dynamic circuit breakers to gracefully divert traffic when a slot approaches its capacity limit.
• Full Slot Lifecycle & Health Observability: Visual real-time tracking of slot states (In-Pool, Cooldown Guard, Suspended, Token Expired), multi-tier priority routing, and real-time per-slot financial cost accounting.

_{Production live dashboard: Multi-slot fleet status, 20-concurrency subagent scheduling, 5h/7d quota window telemetry, and cost accounting (sanitized).}

• Reverse-Extraction & Distillation Prevention: Automatically drops requests attempting model distillation or Chain-of-Thought scraping before upstream credits are consumed.
• Upstream AUP & Refusal Guard: Real-time detection and caching of upstream AUP violations and stop_reason=refusal patterns. Dangerous prompts are quarantined and blocked at the gateway entry, safeguarding accounts from termination.

• Zero Cross-Account Contamination: Every VM slot is strictly bound to its own dedicated SOCKS5 proxy or local egress gateway.
• No Shared Egress: Prevents cascade bans caused by multiple accounts sharing the same outbound IP.
• Custom HTTPS DoH: Supports custom DNS-over-HTTPS resolvers for stealthy and encrypted queries.

• Multi-Protocol Inbound: Connect with Anthropic Messages API, OpenAI Chat format, or modern Responses API.
• Structural Rectification: Normalizes invalid role sequences, corrects schema parameters, and translates inputs into clean payloads conforming to official client specifications.

• Single-Machine Telemetry: Accurately simulates the telemetry signatures of a standalone physical workstation.
• Granular Control: Operators can toggle and adjust telemetry forwarding based on operational privacy policies.

• Agentless SSH Node Fleet: Connect and orchestrate multiple remote VPS hosts through lightweight, secure SSH connections.
• Remote Docker Bridge: Effortlessly deploy, monitor, and place slot containers across different physical machines with built-in interactive web terminals (xterm).

• Multi-Tenant Security: Master key architecture with secondary HMAC-indexed tenant tokens.
• Official Quota Alignment: Accurately tracks 5h/7d rolling budget windows, enforces rate limits (RPM/TPM), and provides seamless failover.
• Comprehensive Telemetry & Observability: Real-time tracking of TTFT, genuine token consumption, SLA, and failure classifications.

# Recommended one-line installation on Ubuntu 24.04 LTS
curl -sSL https://raw.githubusercontent.com/dofastted/vm2api/main/deploy/install.sh | sudo bash

After deployment, access:

• Management Console: http://<YOUR_IP>:8787/console
• Health Check: http://<YOUR_IP>:8787/health
• API Endpoint: POST http://<YOUR_IP>:8787/v1/messages

开源与持续维护离不开社区大家的支持与反馈。如果您觉得 vm2api 为您的业务或学习带来了实质帮助，欢迎扫码加入官方 Telegram 交流群或请作者喝杯咖啡！

💬 官方 Telegram 交流群 实时讨论 · 体验交流 · 版本一手推送

☕ 支持与赞助项目 请作者喝杯咖啡 · 助力持续迭代演进

特别鸣谢 LINUX DO 等开源技术社区同仁的支持与建议

• 个人与非商用：本仓库遵循 Noncommercial License，仅供个人学习、技术研究与个人自建使用。
• 商业使用授权：任何将本项目用于商业运营（包括对外付费 API、作为转售云服务基础组件、公司内部营利用途等）必须事先取得作者正式书面授权。授权联系请洽 Telegram @VM2API。
• 免责声明：vm2api 为独立的开源实验项目，与 Anthropic PBC 或 OpenAI 无任何直接关联。相关商标权属均归其对应公司所有。