[!NOTE] vm2api 专为高可靠 AI 订阅转化为生产级标准 API 设计。摒弃传统的简单 HTTP 逆向与易被封禁的公用代理方案，采用全隔离虚拟机/容器环境 + 官方真实客户端进程常驻 + 真实硬件指纹拟真 + 单槽单独立网络出口 + 进槽前封控拦截，实现真正稳定、长效、高并发的订阅转 API 基础设施。

---

🇨🇳 简体中文

目录

• 💡 项目概览
• 🆕 近期更新
• 🛡️ 九大核心特性（特色防封与拟真矩阵）
  • 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 或应用均可无缝接入。

🆕 近期更新

对照 1.3.133。自 1.3.122 起，调用方能直接碰到的变化如下。明细和升级注意见 CHANGELOG.md，操作说明见 入门文档。

• 遥测只认种子里的 telemetry_disabled === false。虚拟机页的遥测开关与这项一致，默认开时显示为开；非必要流量和 DNT 跟着它走，不能单独拨。
• 入门文档放在控制台左上角 GitHub 右侧，打开 vm2api.fkcodex.com/zh。
• 封控拦截收成管理台「风险审计」。进槽前按蒸馏 → 硬正则 → 拒答缓存 → 决策模型依次拦，过关才出站。见 下文 与 docs/RISK.md。
• 本地代理是槽位所在 VPS 的出口，不是控制面自己的网卡。集群节点上，控制面代发的换票、刷新、测试对话和地理检测也从该节点出去；节点没连上就失败，不改走控制面直连。
• 模型页改为卡片矩阵。claude-haiku-5-5 的默认上下文、max_tokens 和输出上限是 100K；已经改过的管理员值不会被重置。
• 托管密钥可以限定平台（全部 / Anthropic / OpenAI）和勾选的槽。打到范围外返回 403。
• 流空闲默认 180 秒，在「重试与切号」里改。长工具参数可打开流式下发，避免静默超时。

---

🛡️ 九大核心特性（特色防封与拟真矩阵）

0️⃣ 独家 0 提示词注入机制 & 改写引擎

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

1️⃣ 真实拟真物理机环境

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

2️⃣ 官方 Claude Code 真实进程转发 & 槽位管理

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

---

3️⃣ 封控拦截与风险审计

进槽之前，/v1 和 count_tokens 先过管理台「风险审计」（/console/#/risk）。命中即返回错误，不选槽、不打上游。顺序不能调：

每关可看今日命中和拦截流水。点开一条对正文；误伤就收这道关，不要删槽。判定记在请求日志里。这一版之前的旧日志没有判定，显示为「未经关卡」。

细则：docs/RISK.md。

4️⃣ 完整的隔离网络环境（1 VM = 1 独立网络出口）

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

5️⃣ 前置协议清洗与多协议统一结构化

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

---

6️⃣ 官方遥测（Telemetry）可控开关

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

7️⃣ 分布式集群系统（多 VPS 跨机舰队管理）

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

8️⃣ 完整的企业级 API 密钥与配额管理

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

---

📊 干净度基准评测（Benchmarks）

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

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

---

🚀 快速开始（生产部署）

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

1. 一键脚本安装（推荐）

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

2. 手动 Docker Compose 启动

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

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

---

🇬🇧 English

Table of Contents

• 💡 Overview
• 🆕 Recent changes
• 🛡️ 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-hop risk gates
  • 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

---

💡 Overview

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 pre-hop risk gates.
• Standard Compatibility: Provides drop-in replacements for Anthropic /v1/messages and OpenAI /v1/chat/completions / /v1/responses.

Recent changes (1.3.133)

Since 1.3.122, the caller-visible changes are:

• Telemetry reads only telemetry_disabled === false. The VM switch matches that bit and is on for the default; nonessential traffic and DNT follow it.
• Intro docs sit to the right of GitHub in the console sidebar and open vm2api.fkcodex.com/zh.
• Risk gates run before a slot is chosen: distill, hard regex, refusal cache, decision model, then egress. See below and docs/RISK.md.
• Local proxy is the VPS that owns the slot. On a cluster node, ticket refresh, test chat, and geo also leave through that node. A disconnected node fails instead of falling back to the control plane.
• Models are a card matrix. Haiku 5.5 defaults to a 100K context and output cap; an admin override is kept.
• Keys can be limited to Anthropic or OpenAI and to selected slots. A call outside that scope returns 403.
• Stream idle defaults to 180 seconds under retry settings. Long tool arguments can be streamed.

Details: CHANGELOG.md. Guide: vm2api.fkcodex.com/zh.

---

🛡️ 9 Core Pillars (Anti-Ban & Emulation Matrix)

0️⃣ Zero Prompt Injection Engine

• 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.

1️⃣ Physical Hardware Fingerprint Emulation

• 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.

2️⃣ Official Claude Code Native Process Forwarding & Slot Management

• 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.

3️⃣ Pre-hop risk gates

/v1 and count_tokens pass the console Risk page (/console/#/risk) before any slot is chosen. A hit returns an error and does not spend upstream quota. The order is fixed:

Open a hit and read the body. A false positive means tighten that gate, not delete the slot. Requests from before this recording show as unchecked. Full rules: docs/RISK.md.

4️⃣ Completely Isolated Network (1 VM = 1 Egress)

• 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.

5️⃣ Deep Protocol Cleansing & Multi-Inbound Structuring

• 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.

6️⃣ Configurable Official Telemetry

• 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.

7️⃣ Multi-VPS Cluster Management

• 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).

8️⃣ Enterprise API Key & Quota Management

• 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.

---

📊 Cleanliness Benchmarks

---

🚀 Quick Start (Production Setup)

# 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

---

🐞 问题反馈 / Issue Reporting

提交 Issue 前请阅读 ISSUE_GUIDE.md，按“版本 → 复现路线 → 环境（VPS / 代理）→ VM 与请求日志 → 源码定位（可选）→ 脱敏”收集信息，再用 Bug 报告表单 提交。

Before opening an issue, follow ISSUE_GUIDE.md: version, reproduction steps, host/proxy environment, VM and request logs, optional source pointers — and redact all secrets.

---

💬 交流与赞助支持 / Community & Sponsorship

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

---

📈 Star History

---

📜 许可证与免责声明 / License

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