
appsandbox v0.1.5
轻松创建完全沙盒化的虚拟机,用于开发或计算机使用模型。
App Sandbox
App Sandbox 是一款面向 Windows 和 macOS 的虚拟机应用,专注于性能与易用性。
Windows 功能:
- 可在 Windows 11 家庭版或专业版上运行,无需 Hyper-V
- 支持 Windows 11 或 Ubuntu 26.04 LTS 虚拟机
- 零接触安装
- 复制与粘贴
- 双声道音频
- 通过半虚拟化(GPU-PV)实现 GPU 加速,支持 DirectX 12(仅限 Windows)、OpenGL、Vulkan、CUDA、OpenCL
- 支持 GPU 硬件视频解码器/编码器
- 通过 Hyper-V 套接字代理实现 SSH(无需网络)
- 快照
- 多种分辨率选项以及可选的动态分辨率
- 支持宿主机到客户机的热键
- 可在有/无互联网的情况下进行配置和启动
- 得益于嵌套虚拟化支持,可在虚拟机内运行 Claude Cowork 和 Docker
- 本地 API、MCP 服务器和 Python SDK
Mac 功能:
- 支持 macOS 或 Windows 11 ARM 虚拟机
- 零接触安装
- 复制与粘贴
- 双声道音频
- macOS:通过半虚拟化实现 GPU 加速,支持 Metal;Windows:无 GPU 加速
- 通过 virtio-vsock 实现 SSH(无需网络)
- 动态显示尺寸调整(Windows 上可选)
- 可在有/无互联网的情况下进行配置和启动
- 本地 API、MCP 服务器和 Python SDK
要求: 搭载 x64 处理器的 Windows 11,或 macOS 27 或更高版本(M 系列)
关于 App Sandbox
App Sandbox 可创建并运行完整的桌面虚拟机——Windows 11、Ubuntu 和 macOS。它免费且开源(MIT),以预构建二进制文件的形式分发(Windows 上经 EV 签名, macOS 上经 Apple Developer 签名),发布在其 Releases 页面。可使用图形 界面,或通过 API、MCP 服务器或 Python SDK 进行自动化操作。选择一个操作系统和安装程序 镜像,App Sandbox 便会配置磁盘、执行无人值守安装并启动 客户机。你需要提供 Windows 或 Ubuntu ISO;macOS 客户机会自动下载其恢复镜像 。它可在 Windows 11(x64)PC 或 Apple Silicon Mac 上运行,包括笔记本电脑。
可在 Windows 11 家庭版上运行,无需 Hyper-V。 在 Windows 上,App Sandbox 不使用 Hyper-V 或 Hyper-V Manager;它通过 Windows Host Compute System (HCS) 和 Host Compute Network (HCN) API 创建并运行虚拟机,这些 API 仅需要 Virtual Machine Platform 功能。Hyper-V 仅限于 Windows 11 专业版和企业版,而 Virtual Machine Platform 在 Windows 11 家庭版上可用,因此不需要 Windows 11 专业版许可证。 Virtual Machine Platform 与 WSL2 使用的是同一个 Windows 功能。
你可以用它来做什么:
- 一个完整的 Windows 或 Ubuntu 桌面虚拟机——一个具备 GPU 加速 (OpenGL、Vulkan、CUDA)的完整图形操作系统——用于在干净安装的环境中构建和测试你自己的软件。
- 在虚拟机中运行程序,与你的主操作系统和文件保持隔离。
- 开发和测试 Windows 驱动程序:内置的 测试模式 可在客户机内启用测试签名 ,因此宿主机的安全启动和启动配置保持不变。
- 在独立的虚拟机中运行计算机使用型 AI 代理(例如 Claude 的计算机使用模型)。App Sandbox 提供桌面和虚拟机;代理自身的模型循环在客户机内运行。 多个代理可以同时运行,每个都在自己的虚拟机中,且仅需一台笔记本电脑或台式机。
- 通过图形界面或无头 API 创建 GPU 加速(GPU-PV)虚拟机。
- 使用 Python SDK 从代码中编写虚拟机生命周期脚本——创建、快照、分支、SSH 登录和删除 GPU 加速虚拟机。
API 与 MCP。 App Sandbox 在 Windows 和 macOS 上支持通过本地 HTTP API、MCP 服务器和 Python SDK 进行自动化,可使用图形界面或无头模式。 有关设置和使用方法,请参阅 API、MCP 和 Python SDK 文档。
工作原理: 本仓库同时也是一个可运行的示例,展示如何通过 Windows HCS/HCN API 和 Apple 的 Virtualization.framework 以编程方式创建完整的桌面虚拟机。在 Windows 上,App Sandbox 将手工构建的 HCS 机器文档提交给 computecore.dll / computenetwork.dll —— 即同样支撑 WSL2 和 Windows Sandbox 的 HCS/HCN 层 —— 而不是通过 Hyper-V Manager。GPU 加速使用 GPU 半虚拟化(GPU-PV)将宿主机已安装的 GPU 共享给客户机 —— 与 WSL2 走的是同一条路径,而非专用直通(没有 VFIO/IOMMU,也不需要第二块 GPU)。Windows 客户机可获得 DirectX 12、OpenGL、Vulkan、CUDA 和 OpenCL;Ubuntu 客户机可获得除 DirectX 之外的相同支持;macOS 客户机获得 Metal。一个自定义的 IddCx 间接显示驱动和一个虚拟音频设备负责承载画面与声音,客户机↔宿主机之间的剪贴板、音频、输入和 SSH 通过 Hyper-V sockets 运行。客户机磁盘由仓库内的工具构建,支持 ext4、squashfs、qcow2 和 VHDX。在 macOS 上,App Sandbox 通过 virtio-vsock 使用 Apple 的 Virtualization.framework(VZVirtualMachine、VZMacOSInstaller)。在 Windows 上,Linux(Ubuntu)客户机通过自定义 DRM/KMS 内核模块(asb_drm)、Microsoft 的 WSL2 dxgkrnl 以及自定义 Mesa 构建来访问 GPU。这些应用使用原生 C / Objective-C 编写,并配有 HTML/JS 界面(Windows 上为 WebView2,macOS 上为 WKWebView)。
macOS 上的 Windows 客户机使用 QEMU 11.1.3 并启用 HVF 加速,构建自我们公开的 asb-qemu fork。它保留了我们全部四项 ivshmem 改动,包括在 macOS 上的支持以及可选的 x-device-id 覆盖。QEMU、其依赖库和固件均随 macOS 应用一同分发。有关固定版本的源码和重新构建说明,请参阅 QEMU 构建说明。
提示:
默认用户名为 user,默认密码为 test123
想为你的旧虚拟机启用新的 App Sandbox 功能?下载并运行新版 App Sandbox,然后把这份提示词交给你的 AI 代理,以协助完成升级
当你的虚拟机正在运行并已打开时,右键单击其标题栏会显示多个选项,例如发送热键、静音音频以及匹配窗口大小 —— 后者会让虚拟机显示画面根据查看器窗口大小动态调整尺寸。
[Windows] 需要高性能远程桌面来远程访问你的虚拟机?Phaze 效果不错
[Windows] 你可以在 App Sandbox 的 Windows 虚拟机内运行 gpu-test.exe 来检查 GPU-PV 驱动配置是否正常工作,gpu-test.exe 会显示一个包含 6 个旋转立方体的窗口,每个立方体使用不同的渲染引擎(D3D9、D3D10、D3D11、D3D12、OpenGL 和 Vulkan)。如果其中一个或多个失败,它们将无法为该渲染 API 正确显示旋转立方体。gpu-test.zip。注意:渲染 API 成功意味着 GPU-PV 已生效,但有时游戏或应用的编写方式会导致它们无法正确检测 GPU-PV 系统,从而仍然显示错误。
分享修复与功能
感谢你分享修复和想法!欢迎通过 Pull Request 提交建议,包括来自你自己 fork 的 AI 辅助改动。它们不太可能被正式审查或合并,但有助于促成变更的贡献将获得署名。详情请参阅贡献指南。
许可证
AppSandbox 采用 MIT 许可证 —— Copyright (c) 2026 James Stringer。
客户机驱动和捆绑的第三方组件保留各自的许可证,包括 asb-dxgkrnl、asb-mesa 和 QEMU。AppSandbox 的 Linux DRM 模块(tools/linux/asb_drm/)采用 MIT OR GPL-2.0 双许可证。有关各组件的许可证和源码链接,请参阅 THIRD-PARTY-NOTICES.md。
致谢
除了我自己构建 Easy-GPU-PV 的经验之外,我发现 NanaBox 对于理解 HCS 来说是一个非常有帮助的资源。
作者
James Stringer — Easy-GPU-PV 的作者。