SuperAPI AI 工具集

openqemu

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:OpenSandbox 是一个运行 QEMU 虚拟机的云端沙箱环境,用于在隔离的 Linux 环境中运行代码、测试命令和操作文件。

配置:使用前需设置环境变量 OPENSANDBOX_API_URL(默认 http://localhost:8080)和 OPENSANDBOX_API_KEY。所有请求需带 -H 'X-API-Key: $API_KEY' 与 -H 'Content-Type: application/json'。

主要能力:创建沙箱(POST /api/sandboxes,返回 sandboxID、status、token);执行命令(POST /api/sandboxes/{ID}/exec/run,同步返回 exitCode、stdout、stderr);创建长连接 exec 会话;读写文件(GET/PUT /files,PUT 用 application/octet-stream);列目录(/files/list);列出与销毁沙箱;休眠与唤醒(hibernate 保存状态到 S3 并停止计费,wake 约 520ms 恢复,保留 workspace 与 rootfs);检查点与分叉(POST /checkpoints 创建 qcow2 快照,POST /from-checkpoint/{id} 分叉新沙箱);运行时资源扩缩(PUT /limits,memoryMB 自动换算 CPU,1 vCPU 对应 1GB RAM)。沙箱内部可通过 169.254.169.254 访问状态、限额、扩缩和元数据接口。

使用方式:先创建沙箱并保存 sandboxID,建议 timeout 设为 3600;用 exec/run 执行命令,注意命令字段为 cmd、参数为 args,可传 envs 与 cwd;完成后销毁或等待 1 小时空闲超时。

适用场景:需要隔离环境运行代码、验证命令、临时文件操作与可复现快照分叉的任务。

限制:默认超时为 300 秒;cgroup 默认 pids.max=128、memory.max 为 VM 内存 90%、cpu.max 为 vCPU 80%;/tmp 为 tmpfs,休眠唤醒后丢失,/workspace 与 rootfs 变更保留;分叉需等待状态变为 running 再执行命令。其余收费、平台等细节资料未提供。