microsandbox

microsandbox 是一个本地优先的 microVM 运行时与库，用于在快速、隔离的微型虚拟机中运行不受信任的工作负载。其目标场景包括 AI 智能体、用户代码、插件、CI 作业、开发环境、爬虫和自动化任务。

主要能力：

• 硬件隔离：使用极小的虚拟机提供硬件级隔离。
• Fork 与快照：可 fork 运行中的沙箱，保存运行状态并在之后恢复；提供 --cow-mem 选项共享未变更内存；快照代（snapshot generations）描述推进过程，分支（branches）描述不同的历史路径；旧的 --forked 恢复标志仍作为已弃用别名保留。
• 跨平台：可在 Linux、macOS 和 Windows 上运行。
• OCI 兼容：可运行来自 Docker Hub、GHCR 或任何 OCI 注册表的标准容器镜像。
• 类 Docker 工作流：提供熟悉的镜像、命令、shell 和卷工作流。
• 即时启动：平均启动时间低于 100 毫秒（该数据指 M1 机器上的 guest 启动时间）。
• 可嵌入：直接在代码中生成 VM，无需设置服务器，也无需长期运行的守护进程。
• 密钥不可泄露：密钥键从不会进入 VM，无法被利用。
• 长期运行：沙箱可处于后台分离模式，适合长时间会话。
• 面向智能体：通过 Agent Skills 和 MCP 服务器，让 AI 智能体自行创建沙箱。

使用方式： 安装后即可创建沙箱。运行环境要求：macOS 需要 Apple Silicon；Linux 需要启用 KVM；Windows 需要启用 WHP。注意：Microsandbox 仍为 beta 软件，预期会有破坏性变更、缺失功能和粗糙边缘。 msb CLI 提供管理沙箱、快照、镜像和卷的完整接口。运行 msb --help 查看快速帮助菜单；运行 msb --tree 查看完整命令层级和描述；运行 msb <command> --tree 查看特定命令树。 SDK 允许直接在应用程序中创建和控制沙箱。Sandbox.builder("...").create() 会以子进程方式启动一个 microVM，无需任何基础设施。可参阅 Ruby SDK 指南了解安装、生命周期、网络和后端细节。首次调用 create() 时，如果镜像未在本地缓存，会拉取镜像，因此耗时可能因连接速度而异；后续运行会复用缓存。

实用场景示例：

• 沙箱中的 Docker：在不触碰宿主守护进程的情况下运行 Docker。
• OpenCode：为编码智能体提供隔离的项目工作区。
• Browser Use：在 microVM 内运行 AI 浏览器智能体。
• Playwright：在 microVM 内运行无头浏览器任务。
• 预热工作器（Warm Workers）：对工具链制作快照并启动干净的工作器。
• 迁移预演：测试数据库迁移后恢复到基线。
• GitHub Actions Runner：在一次性 microVM 中运行每个自托管作业。
• 文档转 PDF：在全新的离线工作器中转换不受信任的文档。

社区展示：

• Eve by Vercel：将 microsandbox 作为沙箱后端的智能体框架。
• Agentic Coding Quickstart by U.S. GSA：从零到运行 AI 编码智能体。
• Condukt 和 Once by Tuist：Elixir 智能体引擎，以及在全新沙箱中运行的可缓存操作。
• langchain-microsandbox by kenwoodjw：面向 LangChain Deep Agents 的 Microsandbox 集成。
• Smithers by Smithers：具有完整可观测性、回退、fork 和重放的智能体工作流。
• AgentConnect：将多个 AI 智能体带入团队的聊天、issue 和 pull request。
• wrap by Tobi Lütke：在隔离的 Arch Linux microVM 中运行编码智能体和项目命令。
• Agent VM by Wiren Board：在限定于本地文件夹的安全 VM 中运行 AI 智能体。
• h5i by h5i：用纯 Rust 编写的、安全可审计的 AI 智能体浏览器。
• Devsy by Devsy：将 devcontainer 部署到任何云、Kubernetes 集群或 Docker 主机。
• OpenWork by Different AI：带有 microsandbox 镜像的开源 Claude Cowork 替代品。
• Awesome Microsandbox by ya-luotao：精选的 SDK、集成、工具和资源列表。
• msb-omarchy by ya-luotao：在 Apple Silicon 上的 microVM 内运行 Omarchy 桌面环境。

智能体集成： 通过安装 Agent Skills，可教会任何 AI 编码智能体使用 microsandbox，支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等。通过 MCP 服务器，可将任何兼容 MCP 的智能体连接到 microsandbox，提供沙箱生命周期、命令执行、文件系统访问、卷和监控的结构化工具调用。

文档与贡献： 指南、API 参考和示例请访问 microsandbox 文档。贡献指南见 CONTRIBUTING.md，构建、测试和发布说明见 DEVELOPMENT.md。项目采用 Apache License 2.0 许可。特别感谢所有贡献者、测试者和社区成员，以及 libkrun 和 smoltcp 等项目。还有展示 VM 暂停/恢复、快照和 fork 的演示：Mario Never Dies 和 Multiverse of Madness。

限制：目前为 beta 软件，预期会有破坏性变更、缺失功能和粗糙边缘。