vm2api
完全隔离的虚拟机级 AI 订阅转 API 生产网关
Next-Generation Fully Isolated VM-Level AI Subscription-to-API Gateway
🇨🇳 简体中文 | 🇬🇧 English | 入门文档 | CHANGELOG | 技术路线 | 部署指南
部署安装 · 近期更新 · 功能特性 · 界面预览 · 交流与支持
[!NOTE]
vm2api 专为高可靠 AI 订阅转化为生产级标准 API 设计。摒弃传统的简单 HTTP 逆向与易被封禁的公用代理方案，采用全隔离虚拟机/容器环境 + 官方真实客户端进程常驻 + 真实硬件指纹拟真 + 单槽单独立网络出口 + 进槽前封控拦截，实现真正稳定、长效、高并发的订阅转 API 基础设施。
❤️ 赞助商 / Sponsors
赞助商（ProxyLane）：AI 账号专用的原生静态住宅 IP，Scamalytics 低欺诈评分，每个 IP 独享，不限流量，$3.90 起。一个槽位绑一个 IP：把 SOCKS5 host:port:user:pass 粘贴到「代理池」→「添加代理」即可。首次购买优惠码 VM2API30 享 7 折。详见 ProxyLane。
🇨🇳 简体中文
目录
为什么选择 vm2api？
- 订阅转标准 API：Anthropic / OpenAI 订阅与可选 API 直连（
api 类密钥）统一入口。
- 虚拟机级拟真：官方 Claude Code 真实进程、硬件指纹、单槽单出口，而非简单 HTTP 逆向。
- 生产可运维：进槽前封控、多 VPS 集群、租户与密钥体系；升级以各版本 CHANGELOG 为准。
💡 项目概览
在当今大模型服务中，直接使用第三方逆向脚本或共享代理极易触发风控导致封号、降权与服务中断。vm2api 是业界领先的虚拟机级 API 转换中继系统：
- 支持平台：全面支持 Anthropic (Claude Pro / Team / Enterprise / Max) 以及 OpenAI (ChatGPT / Codex) 订阅转标准 API；另支持在管理台配置 Anthropic / OpenAI 官方 API 端点，用
api 类密钥直连上游（不占用 OAuth / Codex 槽位）。
- 真实载体：Anthropic 采用官方客户端在隔离 VM / 容器内运行真实系统进程，而非第三方伪造 HTTP 模拟。
- 全链路拟真：从物理机硬件指纹（SMBIOS、MAC、Machine-ID）到独立 SOCKS5 / 本地网络出口，全方位还原真实开发者电脑环境。
- 极简集成：向上游输出标准 OpenAI
/v1/chat/completions、/v1/responses 与 Anthropic /v1/messages 兼容接口，任何支持标准 API 的前端、Agent 或应用均可无缝接入。
🆕 近期更新
对照 1.4.053（main 当前版本）。下列为 1.4.038–1.4.053 已上线、调用方或管理员能直接感知的变化摘要；完整条目见 CHANGELOG.md，操作说明见 入门文档。下文升级概述不能替代逐版说明，具体以各版本 CHANGELOG 的升级注意为准。
- 内容脱敏（可选）：设置 →「脱敏」页（
/console/#/settings/redaction）可配置凭据、个人信息与自定义规则；默认关闭。启用需本机 bin/kin-redact，helper 未就绪时不能保存为开启，请求也不会回落明文。
- API 直连：管理台 API 配置统一到
#/api；api 类密钥按端点协议调度上游，不经 OAuth / Codex 槽位。Anthropic 端点可单独开关「风控前置审查」。
- 协议与计费：官方 Claude Code 透传、缓存断点 TTL 与
max_tokens 默认值（如 Haiku 5.5 为 100K）与面板一致；GPT Image 模型可在 Chat / Responses 路径出图；第三方计费限制类上游错误写入拒答缓存（refusal_guard）。
- 封控与配额：决策模型支持多组 URL / Key；托管密钥可
GET /v1/me/quota 与 GET /v1/me/usage；租户可看用量统计，虚拟机只读（无代理与重新授权）。
- 面板与运维：按角色隐藏无权页面；槽位官方登录执行
claude auth login；平滑停机时 /health 返回 503 shutting_down；控制面升级多为更新镜像并重启（多数版本不必 wrap-cli/sync 或换 payload，勿覆盖 routing.json、vms/、data/、.env）。
- 集群：支持运行中 / 冷迁移 Linux KVM 槽与内存扩容，见 槽位迁移说明。
功能特性
涵盖防封、拟真与生产运维相关能力（九大支柱）：
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）。命中即返回错误，不选槽、不打上游。顺序不能调：
| 顺序 | 关 | 拦住什么 | 结果 |
|---|
| 1 | 蒸馏 | 收割模板、题目指纹、套取思维链的结构。OpenAI 平台模型不扫。默认再跳过官方 Claude Code 和 0 注入。 | 403，封 device |
| 2 | 硬正则 | 色情、破解、破限和自定义正则。蒸馏类正则跟蒸馏总开关：关掉硬正则仍拦这些短语，关掉蒸馏才放行；官方客户端和 0 注入仍扫，OpenAI 不扫。 | 403 |
| 3 | 拒答缓存 | 上游已经拒过的精确正文、近似正文，以及被封的 device。硬正则和决策模型自己的拦截不写入这张缓存。 | 400，不可重试，不是登录失效 |
| 4 | 决策模型 | 安全模型逐题打分，低于阈值才拦。打分失败默认放行，并在「放行出站」里标出来。 | 403 |
| 5 | 放行出站 | 前面都没拦。上游自己的拒答单独列出，用来看漏拦。 | 进入槽位 |
每关可看今日命中和拦截流水。点开一条对正文；误伤就收这道关，不要删槽。判定记在请求日志里。这一版之前的旧日志没有判定，显示为「未经关卡」。
细则：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 容器。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
