exe-dev

用途

exe.dev VM Management 技能用于在 exe.dev 平台上管理持久虚拟机（VM）。它面向需要通过 SSH 命令创建、配置和共享 exe.dev 虚拟机的场景，例如托管应用、运行开发环境或对外提供 HTTP 服务。

主要能力

该技能封装了一组通过 ssh exe.dev 执行的命令，覆盖以下操作：

• 列出虚拟机：ssh exe.dev ls --json
• 创建虚拟机：ssh exe.dev new
• 将虚拟机设为公开：ssh exe.dev share set-public <vm>
• 修改代理端口：ssh exe.dev share port <vm> <port>
• 添加共享用户：ssh exe.dev share add <vm> <email>
• 生成分享链接：ssh exe.dev share add-link <vm>

使用方式

访问地址

• 虚拟机：https://<vmname>.exe.xyz/
• Shelley agent：https://<vmname>.exe.xyz:9999/
• VSCode：vscode://vscode-remote/ssh-remote+<vmname>.exe.xyz/home/exedev

代理配置

默认端口从 Dockerfile 的 EXPOSE 指令自动选择，可通过 ssh exe.dev share port <vmname> <port> 修改。端口 3000-9999 可通过 https://vmname.exe.xyz:<port>/ 访问。

认证请求头

当用户通过 exe.dev 认证时，请求中会包含：

• X-ExeDev-UserID — 用户标识
• X-ExeDev-Email — 用户邮箱

测试时可用 mitmproxy 注入请求头：

mitmdump --mode reverse:http://localhost:8000 --listen-port 3000 \
  --set modify_headers='/~q/X-ExeDev-Email/user@example.com'

自定义域名

• 子域名：CNAME app.example.com → vmname.exe.xyz
• 顶级域名：ALIAS example.com → exe.xyz，并 CNAME www → vmname.exe.xyz

适用场景

适用于需要在 exe.dev 上托管服务、配置 HTTP 代理、共享虚拟机访问权限或绑定自定义域名的用户。

限制

该技能由 clawdbot 根据 exe.dev 的 markdown 文档自动构建，尚未经过测试，使用时需谨慎。完整文档（包括定价、Shelley agent 设置、SSH 密钥配置和 FAQ）参见 references/exe-dev-vm-service.md。