MXC - 沙盒代码执行系统

Microsoft eXecution Container (MXC) MXC 是一个沙盒代码执行系统，用于在 Windows、Linux 和 macOS 上运行不受信任的代码（模型输出、插件和工具）。它在统一的遏制模型和类型化 SDK 后面提供了多个遏制后端，从操作系统本机进程沙箱到完整的虚拟机。跨平台：Windows、Linux 和 macOS 支持，具有适合平台的遏制后端 基于 JSON 的配置：版本化容器创建请求和安全策略 多个遏制后端：ProcessContainer、Windows Sandbox、LXC、Bubblewrap、Seatbelt、MicroVM (Nancix)、Hyperlight、IsolationSession 和 WSLC 策略驱动的沙箱：文件系统策略：只读、读写和拒绝路径列表 网络策略：代理支持、出站控制和后端相关主机过滤 UI 策略：剪贴板、显示和 GUI 访问控制 状态感知生命周期：配置、启动、执行、停止和取消配置持久性容器 Rust、.NET 和 Node SDK：用于一次性和状态感知执行的版本化 API 诊断：用于了解容器中拒绝访问故障的工具 MXC 是内置于您的应用程序中的 SDK 依赖项。流程图 LR App["您的应用程序
Launch API"] --> SDK["MXC SDK
Rust / .NET / Node
(处理中)"] SDK --> Backend["选定的后端
(处理中)"] Backend --> Container["隔离工作负载
ProcessContainer / WSLC / Bubblewrap / ..."] 加载您的应用程序指定： 容器类型 包含规则 工作负载命令 MXC验证请求，选择后端，并在生成的容器中启动工作负载。支持哪些容器类型？ MXC 通过 Windows、Linux 和 macOS 上适合平台的容器后端运行工作负载。运行时平台 默认后端 其他后端 最低主机操作系统 Windows 11 x64 / ARM64 processcontainer windows_sandbox *、wslc、microvm *、hyperlight *、isolation_session Windows 操作系统版本支持 Linux x64 / ARM64 bubblewrap lxc、microvm、hyperlight - macOS ARM64 / x64 安全带 - - * 这些后端是实验性的。通过包管理器安装 SDK。您不需要克隆此存储库。 Node 和 .NET 包包含本机运行时资产。 Rust 箱将 MXC SDK、引擎和选定的后端构建到消费应用程序中。非 SDK 消耗：特定于平台的执行程序二进制文件，例如 wxc-exec.exe ，接受稳定 schema 定义的 JSON 容器创建请求。用于测试或当 SDK 无法嵌入您的应用程序时。运行包含的工作负载 有关完整的 SDK 示例，请参阅 Rust、.NET 和 Node 示例。从'@microsoft/mxc-sdk/v1'导入{spawn，输入ContainerRequest}； const request : ContainerRequest = { command : 'node -e "console.log(\'来自容器的hello')"' , network : { egress : { default : 'deny' } } , timeoutMs : 30_000 , } ; const child = 等待生成（请求）；请参阅可运行的流标准 I/O 示例和 SDK API 参考。我的应用程序无法在沙箱中运行！您的应用程序在沙箱中运行时将遇到访问问题，直到您有时间调整遏制规则。我们随时为您提供帮助。本机执行器通常为工作负载保留标准输入、输出和错误。使用 --debug 进行 MXC 诊断输出： wxc-exec.exe --debug config.json 请参阅 MXC 诊断以获取完整的开发人员参考。警告：--audit 关闭正在分析的工作负载的所有沙箱安全性。切勿使用它来运行不受信任的代码。审核模式可帮助策略作者发现访问被拒绝的故障并重建 ProcessContainer 策略，以授予可信工具实际需要的文件和功能。在支持的 Windows 版本上，运行： wxc-exec.exe --audit policy.json MXC 记录观察到的访问并生成策略创作工件。请参阅日志记录访问被拒绝，以了解安全的拒绝和记录诊断、审核输出和支持的工作流程。 Microsoft 官方版本可以向 Microsoft 发送可选的诊断遥测数据。除非个人运行选择加入、Windows 用户明确同意、管理策略允许收集，并且您的应用程序在包含的工作负载请求中启用遥测选项，否则遥测将关闭。管理员可以阻止遥测，但无法授予用户同意。本地开源版本未配置为将遥测数据路由到 Microsoft，并且遥测数据在非 Windows 平台上是无操作的。有关控制和隐私详细信息，请参阅遥测政策和同意书。开发 MXC、更改本机运行时或使用独立执行器二进制文件而不是打包的 SDK 时从源代码构建。存储库构建生成平台本机运行时和执行器，并暂存 Node SDK 使用的本机资产。构建先决条件是： Rust ，通过 src/rust-toolchain.toml 固定到版本 1.93 Node.js 24 或更高版本和 npm 所选后端描述的平台工具链和先决条件 build.bat --all # Release build for current arc