dsh-vm-sandbox
DiscoveredA plugin for running sandboxes with libkrun, for use with dsh
krun VM sandbox — DeepSeek Harness 的 libkrun microVM 沙盒插件
把 DSH(DeepSeek Harness)的 sandbox 接缝替换为 libkrun microVM 后端:受限命令在 独立内核的轻量 VM 内执行,工作区以同绝对路径双向共享,系统级副作用持久化在 "工作区数据层"(ext4 稀疏盘,guest 内 overlay upper),镜像层只读可复用。
完整设计、实测记录与验证清单见 krun-vm-sandbox-design.md (附录 C = 实测记录;附录 D = 验证 TODO)。
能力一览(2026-11-15)
- Sandbox 接缝:confine 落 VM、fail-closed、EROFS 拒绝方言 + 官方拒绝标记/升级提示 (agent exec2 帧协议做 stdout/stderr 分离——官方拒绝分类只查 stderr)
- 空闲回收:idleStopMs + agent
stat活跃连接探测(run_in_background 长驻子进程与 端口转发连接免回收) /vm人类命令:/vm status、/vm stop [all|<key>|ro|rw]、/vm reset confirm(两段式确认)- 镜像管理:URL / tarball / 目录 / 容器导出导入到
<dataDir>/images/<id>/, manifest +registry.json工作区绑定(boot 解析顺序 = 绑定 → imageRootfs)、 删除保护、Alpine 自动免 root 装包;管理页"镜像 / 工作区绑定"两卡 + 内置已测预设(alpine-minirootfs 3.22、ubuntu-base 24.04) - 侧栏终端:GUI"新建终端"shell 选择器里的
krun项(plugin/bin/krun桥, OSC 7777 resize 直达 guest PTY,会话未运行自动引导) - 网络档按工作区:全局默认 + 工作区绑定覆盖(tsi/none,管理页选择器/
workspaces/networkAPI), 档位变化自动停旧启新;portMap: ["host:guest"]= vsock 应用层转发(宿主绑 127.0.0.1),none档下即"零占用 + 只暴露指定端口"组合 - qcow2 数据层:
dataDiskFormat: 'qcow2'(qemu-img 建盘,guest 内首启格式化) - 诊断 skill:
diagnose-krun-vm-sandbox(全局 skill,排障路径 + 常见失败表) - 会话守护进程:
serve(默认开启,daemon: false回退直 spawn)——跨进程共享会话 (同 dataDir 的 live/headless 共用一 VM)、配置指纹漂移防线、boot 子进程监督、PDEATHSIG 孤儿回收 - 管理页:Settings → "VM sandbox"(环境体检 / 运行会话 / 镜像 / 工作区绑定)+ composer 状态芯片
布局
| 路径 | 内容 |
|---|---|
krun-vm-sandbox-design.md | 设计文档(§1-14 设计;附录 A-D 接口/事实/实测/TODO) |
backend/krun-backend/ | 宿主侧 Rust:probe / boot(每会话一 VM 子进程,PDEATHSIG 绑父)/ exec(agent 客户端,exec2 帧解包)/ serve(会话守护进程:注册表/监督/gc/端口转发监听,协议见 serve.rs) |
backend/guest/dsh-vm-agent/ | guest 内代理(musl static-pie):vsock:42 上的 exec(fork/execve + env 透传)、exec2(stdout/stderr/退出码帧分离)、term(PTY + OSC 7777 resize)、vsock 端口转发中继、stat(活跃连接);全 fd CLOEXEC |
backend/vendor/libkrun/ | git submodule:containers/libkrun stable-1.19.x,锁定 1.19.8 发布点(c4d283c2);path 依赖 src/libkrun,可打补丁 |
plugin/ | @local/dsh-krun-vm 插件:index.js(SandboxProvider + /vm 命令 + 镜像管理路由 + 端口转发监听 + 空闲回收)、diagnose-skill.js(诊断 skill)、terminal-backend.js(persistent-shell 组内注册器)、client.js(设置页四卡 + 预设清单 + 状态芯片)、guest/setup.sh(guest 内三层编排 + 首启格式化)、bin/krun(侧栏终端桥)、bin/krun-backend、guest/dsh-vm-agent{-aarch64,}(构建产物,已忽略) |
m0/ | 可行性尖峰:FFI 探针 / 引导冒烟(koffi 路线已弃用的实证) |
harness/ | 接线工件:krun-overlay.yml(dsh --patch 用)、krun-preset-override.yml(三预设覆写生成物)、krun-overlay-headless-*.yml(headless 验证 overlay) |
scripts/build.sh | 构建并部署二进制到 plugin/(x86_64 + best-effort aarch64 agent) |
构建
依赖:rustup(含 x86_64-unknown-linux-musl target)、libclang(bindgen)、
运行时需要 libkrunfw.so.5(系统安装,或放到 <dataDir>/tools/lib;见下"运行时依赖")。
scripts/build.sh
接线(live profile)
~/.dsh/profiles/web/cordis.patch.yml:
- disable base bundle 的
sandbox行 + insertsandbox-vm(provider 替换,network: none) preset-minimal/preset-standard/preset-ptc三预设覆写(persistent-shell 组内 注册 krun 终端后端;cordis/创造模式未动)。preset 为快照,dsh 更新后用harness/krun-preset-override.yml头部的生成方式重新生成。
验证:dsh --profile web --dump-config;激活冒烟:
dsh headless --patch harness/krun-overlay-headless-test.yml "..."(不占 3080、不动 live 会话;
绝对路径加载插件 + headless 默认模型路由)。
注意:插件代码更新后,live web 实例需重启 dsh(或插件重载)才会加载新代码; 已运行会话的 VM 由 provider disposer 停止,数据层天然落盘恢复。
运行时依赖(全部按「环境变量 → 系统 → PATH → <dataDir> 捆绑」发现,不依赖任何用户目录)
/dev/kvm可写(KVM API v12 实测通过)libkrunfw.so.5:系统包,或放libkrunfw*.tgz到<dataDir>/tools/(激活期自动解包到tools/lib),或POST /api/krun/tools {"path": "<tgz>"}显式安装- e2fsprogs(
mkfs.ext4/mke2fs):发行版默认自带;无则可放提取版到<dataDir>/tools/e2fsprogs(注入KRUN_E2FSPROGS_DIR)或设KRUN_MKE2FS qemu-img(仅dataDiskFormat: qcow2):主机 qemu-utils,或KRUN_QEMU_IMG- guest 镜像:无需预置——首次使用自动自举 Alpine minirootfs 到
<dataDir>/images/; 也可管理页/API 导入,或把遗留 rootfs 目录配到imageRootfs(首次使用自动迁入 dataDir) - 运行期资产目录:默认
~/.dsh/storages/krun-vm(DSH_HOME被尊重),含images/workspaces/tools/logs/run/registry.json;旧默认~/.dsh-krun首次激活自动迁入
Comments
Loading…
Similar plugins
by Thanjinx
dsh插件,增加一个隔离区,完全独立于所有插件,适合做实验
★ 0
MIT
JavaScript
Nov 6, 2026
dsh plugin --profile web add dsh-quarantineby JiamingZang
dsh插件,将dsh的LLM请求路由到本机Qoder CLI,可使用Qoder credits与模型。
★ 4
MIT
TypeScript
Oct 2, 2026
dsh plugin --profile web add @jiamingzang/dsh-llm-qoderby Ye-nile
用 dsh 做的一个提示待办与自动总结的小插件
★ 0
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-to-do-marksby PlusQi
个人 DeepSeek Harness (DSH) 插件集
★ 0
MIT
JavaScript
Sep 10, 2026
dsh plugin --profile web add dsh-pluginsby hddwbd
deepseek Harness 模型代理插件
★ 0
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-plugin-llm-proxyby lionwill
DSH上下文压缩插件
★ 0
MIT
TypeScript
Sep 16, 2026
dsh plugin --profile web add dsh-compactor