虚拟机拟真 + Claude Code。0 提示词注入。

许可：个人学习与非商用自建可用。商用必须先取得书面授权。联系 Telegram @VM2API。全文见 LICENSE。

💬 加入讨论：Telegram @VM2API

• 🧼 0 提示词注入：不再靠改 system / 注入人设去“像官方”。身份在凭证形态上就已经是 Console。
• 🖥️ Docker 或真虚拟机：一槽一台机器。拟真物理机指纹仍在攻克，欢迎方案。
• 📡 全量遥测：目标是 Claude 认为你是一台完全独立的电脑，并且无其余特征。
• 🌐 出口可选：每槽一条远程 SOCKS5，或代理池「添加本地出口」。
• 🎛️ 管理台：GET /console。环境变量 admin 登录，没有用户管理页。
• 🔌 协议口：POST /v1/messages（Anthropic），以及 Chat / Completions / Responses 兼容入口。

IPv6 地址的 SOCKS5 代理出口默认关闭，在管理台 设置 → SOCKS5 → IPv6 代理出口 开启。导入使用 [2001:db8::1]:1080 或 socks5h://user:pass@[2001:db8::1]:1080，不要使用含糊的裸 IPv6 host:port。关闭后不可探测、绑定或运行使用，但可继续导入、编辑、复制记录；已有槽位、绑定和探测历史保留，网络状态显示「IPv6 已关闭」而非代理故障。远端不可达时会提示出口未同步，并在节点恢复连接后重新应用关闭策略。此开关只针对 IPv6 literal 代理地址，不启用 Docker 网桥双栈，不改变 hostname 的 DNS 解析、DNS 或路由策略。

生产就用这条。拉预构建镜像，不在服务器上构建；安装目录任意。

一键安装 / 更新（保留已有非空 .env 字段 / vms/ / data/，不 docker rm 槽）。空密码默认 admin / 123456，登录 http://<ip>:8787/cc#/login。

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
sudo bash /opt/vm2api/deploy/install.sh check

管理台 设置 → 关于 会对照 GitHub Release，并给出同一条命令。

运行形态（不是一个父容器里一堆子进程）：

• Compose 只起 1 个 vm2api 控制面（面板、/v1、调度）
• 每个已启动的槽另起 1 个宿主机容器 kin-<槽>（独立家目录 / 出口 / 指纹 / 遥测）
• 未启动的槽不占容器。docker ps 里其它名字是同机别的项目，不是 vm2api

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
# 空密码默认 admin / 123456；空 API key / DB secret 由入口生成

docker compose pull && docker compose up -d
curl -sS --noproxy '*' http://127.0.0.1:8787/health

镜像自带 bin/kin-{kernel,egress,worker,codex-kernel,cookie-auth} 与 share/wrap-cli，入口写进挂载目录，服务器上不编 Rust/Go/前端。槽位 OS 镜像先 docker pull ghcr.io/dofastted/kin-os-*，拉不到时建槽阶段兜底构建。槽 UID 是 10000+序号，bin/kin-* 必须 755。

改代码自己构建：docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build（一键脚本用 --from-source）。

Docker Desktop（含 WSL2）的 host 网络在 Desktop Linux VM 里，WSL/macOS 的 127.0.0.1:8787 可能连不上。改用：

docker exec vm2api python3 -c 'import urllib.request; print(urllib.request.urlopen("http://127.0.0.1:8787/health").read().decode())'

生产请用 Ubuntu 24.04 + Docker Engine。完整约束：DEPLOY.md · Docker。

1. 克隆并安装

   git clone https://github.com/dofastted/vm2api.git /opt/vm2api
   cd /opt/vm2api
   npm ci
   pnpm -C web install --frozen-lockfile
   npm run build:web

   内核 / 网关：仓内 bin/kin-* 已是 linux amd64。也可本机重编或从 Release 覆盖。

2. 写环境变量和占位槽

   cp docs/deploy/env.example /etc/vm2api.env
   chmod 600 /etc/vm2api.env
   # 必填：VM2API_API_KEY / VM2API_ADMIN_PASSWORD / VM2API_DB_SECRET
   # 自建请把 KIN_*_BIN 指到 /opt/vm2api/bin/
   
   mkdir -p vms data bin
   printf '%s\n' '{ "active_vm": "vm-01" }' > vms/active.json

   还要有 vms/vm-01.json，抄本见 部署说明。没有 vms/active.json 进程会退出。

3. 启动

   set -a && source /etc/vm2api.env && set +a
   node src/server.mjs

   生产用 systemd：docs/deploy/vm2api.service。

启动成功后：

上线后：代理池绑出口 → 建 Claude 槽 → 导入 Setup Token → 官方初装 → 再打 /v1。完整步骤：DEPLOY.md。

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","max_tokens":128000,"messages":[{"role":"user","content":"hello"}]}'

用户请求
  → 协议清洗
  → POST /v1/messages
  → 接入 Claude Code 
  → TCP 转发
  → endpoint
  → 透明转发给用户

• 槽位可以是 Docker，也可以是 真虚拟机
• 槽内 Claude Code 原生 subagent，最大 20 并发
• 拟真物理机指纹 仍在攻克。欢迎开 Issue / PR

遥测全量发送。一槽一台机器。身份、遥测、指纹都按单机收敛。

展开说明：docs/技术路线.md

客户端 / Claude Code / 兼容 SDK
        │  Bearer / x-api-key
        ▼
Node 控制面  :8787
  协议清洗 · 调度 · 管理台 /console
        │  cli-hop
        ▼
槽（Docker 或真虚拟机）
  Rust 内核 + Claude Code 原生 subagent（≤20）
        │  SOCKS5 或本地出口
        ▼
Console API endpoint  →  原样回传给调用方

kernel / wrap 只带预编译 ELF。不要提交凭证。

生产推荐：仓库放到 /opt/vm2api，写 .env，docker compose up -d --build。前面可以 nginx 反代 /v1 /api /console /health。本机 Node + systemd 是备选，见 DEPLOY.md。

最少三项，缺 VM2API_API_KEY 或面板密码进程起不来：

VM2API_API_KEY=         # master key，/v1 + 面板 + /admin
VM2API_ADMIN_PASSWORD=  # 管理台登录
VM2API_DB_SECRET=       # 库加密

VM2API_* 优先，没有再读 KIN_*。完整表和 nginx 抄本：DEPLOY.md · env.example

当前发布：v1.3.14

git tag -a v1.3.14 -m "vm2api v1.3.14"
git push origin v1.3.14

v* tag 会触发 Release 工作流，再挂一份 linux amd64 ELF。仓内 bin/ 已可直接部署。步骤：BUILD.md

1. 进程立刻退出，提示 VM2API_API_KEY not set 或读不到 JSON？
   Compose 写仓库 .env；本机 Node 写 /etc/vm2api.env，再准备 vms/active.json。抄本在 DEPLOY.md。

2. /console 是空白或 404？
   Compose 镜像里已带 web/dist。本机 Node 先 npm run build:web。静态页更新不必重启 Node。

3. 槽建好了但不调度？
   先绑出口（远程 SOCKS5 或管理台 添加本地出口），再导入 Setup Token。没凭证是 no_credential，不会入池。

4. Debian 12 上内核起不来？
   优先 Ubuntu 24.04。过旧的 glibc 跑不了当前 wrap / Claude kernel。

5. 还要不要跑 Go hop / kin-worker 当推理？
   不要。hop 服务端已删除。kin-worker 不带参数会退出，只接受 telemetry。

6. 密钥写进 git 了怎么办？
   立刻轮换 VM2API_*、Setup Token、面板密码。不要把密钥贴到 Issue。

7. Compose 起来了但建不了槽 / egress network missing？
   bin/kin-* 为 755、挂了 docker.sock、控制面容器名与 VM2API_CONTAINER_NAME 一致（自省宿主路径用）。先添加本地出口再启动槽——首次启动会自动补一个本机出口 px-local。

8. exec: "/usr/local/bin/kin-kernel": permission denied？
   chmod 755 bin/kin-kernel bin/kin-egress bin/kin-worker bin/kin-codex-kernel。不要用 700。

9. 本机 curl 127.0.0.1:8787 失败，容器却是 healthy？
   Docker Desktop 的 network_mode: host 不在 WSL/macOS localhost。用 docker exec vm2api … 探活，或改 Ubuntu + Docker Engine。

10. docker ps 怎么这么多容器？
    vm2api 只要 vm2api + 每个已启动槽一个 kin-*。postgres / newapi / hermes 等同机其它栈，不是本项目子进程。不能把多槽塞进一个容器当多进程，否则指纹/遥测糊成一台。

Telegram 群组：t.me/VM2API（@VM2API）

开源维护需要时间。扫码进群或支持一下，谢谢。

感谢 liunx do 论坛支持。

欢迎 Issue / PR。提交前请勿带上 .env、槽 JSON 里的票、或 Release 二进制。

开源版仅覆盖个人学习、研究与非商用自建，须保留 LICENSE 全文。

商用必须先取得书面授权（对外收费、作为付费服务、公司生产营收、收费再分发等）。未授权商用禁止。申请：Telegram @VM2API。

vm2api 不是 Anthropic 官方项目，与其无关联。Claude、Claude Code、Anthropic 等均为其权利人的商标。