Runno架构设计从WASI实现到多语言支持的完整技术栈【免费下载链接】runnoSandboxed runtime for programming languages and WASI binaries. Works in the browser, on your server, or via MCP.项目地址: https://gitcode.com/gh_mirrors/ru/runnoRunno是一个基于WebAssembly的沙盒化运行时支持在浏览器、服务器或通过MCP运行多种编程语言和WASI二进制文件。这个开源项目的完整技术栈展示了如何构建一个安全、高效的代码执行环境让开发者能够在浏览器中直接运行Python、Ruby、JavaScript、C/C、PHP和SQLite等语言的代码。本文将深入解析Runno的架构设计从底层的WASI实现到上层多语言支持揭示这个创新项目的技术奥秘。一、核心架构WASI预览1标准的完整实现Runno的核心基础是runno/wasi包它实现了WASIWebAssembly System Interface预览1标准。WASI为WebAssembly提供了一个标准化的系统接口允许WebAssembly模块访问操作系统功能而无需依赖具体的操作系统。WASI实现的关键组件Runno的WASI实现包含以下几个核心组件WASI上下文管理(wasi-context.ts) - 管理运行环境、参数和环境变量文件系统驱动(wasi-drive.ts) - 实现虚拟文件系统操作快照预览1实现(snapshot-preview1.ts) - 完整的WASI预览1API实现不稳定API支持(unstable.ts) - 扩展的WASI功能在packages/wasi/lib/wasi/wasi.ts中WASI类的设计体现了浏览器优先的理念所有系统资源都需要通过配置和回调来模拟。这种设计确保了在浏览器环境中的安全执行避免了直接访问真实系统资源。二、多语言运行时支持统一的执行模型Runno通过runno/sandbox包提供了统一的多语言执行模型。这个包定义了如何将不同编程语言的运行时适配到WASI环境中。运行时配置系统在packages/sandbox/lib/commands.ts中Runno为每种支持的编程语言定义了专门的配置// Python运行时配置 case python: return { run: { binaryURL: new URL( ../dist/langs/python-3.11.3.wasm, import.meta.url ).toString(), binaryName: python, args: [entryPath], env: {}, baseFSURL: new URL( ../dist/langs/python-3.11.3.tar.gz, import.meta.url ).toString(), }, };每个运行时都包含WASM二进制文件- 编译好的语言解释器或编译器基础文件系统- 包含必要的库和依赖的tar.gz包启动参数- 运行代码所需的命令行参数环境变量- 运行时的环境配置当前支持的语言Runno目前支持以下编程语言运行时Python 3.11.3- 来自VMware实验室的WebAssembly语言运行时Ruby 3.2.0- 同样来自VMware的Ruby实现QuickJS- 来自Second State的轻量级JavaScript引擎SQLite- 来自WAPM的SQLite数据库引擎Clang/Clang- 来自binji的C/C编译器工具链PHP-CGI 8.2.0- PHP的CGI实现三、虚拟文件系统安全的隔离环境Runno实现了一个完整的虚拟文件系统为每个代码执行实例提供隔离的存储环境。这个设计确保了代码无法访问宿主机的真实文件系统提供了重要的安全隔离。文件系统结构在packages/wasi/lib/wasi/wasi-drive.ts中实现的WASIDrive类提供了以下核心功能文件操作- 支持创建、读取、写入、删除文件目录管理- 支持目录遍历和操作权限控制- 基于WASI权限标志的文件访问控制时间戳管理- 维护文件的访问、修改和变更时间基础文件系统包每种语言运行时都附带一个基础文件系统包.tar.gz格式包含语言的标准库必要的系统头文件运行时依赖的配置文件预编译的扩展模块四、执行流程从代码到结果的完整过程Runno的执行流程经过精心设计确保代码能够在安全的沙盒环境中运行1. 代码准备阶段当用户提交代码时Runno会创建虚拟文件系统中的程序文件设置必要的环境变量和参数加载语言特定的基础文件系统2. 编译阶段针对编译型语言对于C/C等编译型语言Runno会调用Clang编译器将源代码编译为WebAssembly对象文件使用wasm-ld链接器生成可执行的WASM二进制将编译结果存储在虚拟文件系统中3. 执行阶段代码执行的核心在packages/sandbox/lib/runtime.ts的runFS函数中实现export async function runFS( runtime: Runtime, entryPath: string, fs: WASIFS, options: { stdin?: string; timeout?: number; } {} ): PromiseRunResult { // 获取运行时命令配置 const commands commandsForRuntime(runtime, entryPath); // 准备阶段如编译 let prepare: CompleteResult; try { prepare await headlessPrepareFS(commands.prepare ?? [], fs); fs prepare.fs; } catch (e) { // 错误处理 } // 执行阶段 const resultWithLimits await _startWASIWithLimits( binaryPath, { args: [run.binaryName, ...(run.args ?? [])], env: run.env, fs, stdin: options.stdin, stdout: (out: string) { prepare.stdout out; prepare.tty out; }, stderr: (err: string) { prepare.stderr err; prepare.tty err; }, }, { timeout: options.timeout, } ); }4. 结果收集阶段执行完成后Runno会收集标准输出内容标准错误输出退出代码最终的文件系统状态执行时间统计五、Web组件浏览器中的代码运行体验runno/runtime包提供了完整的Web组件让开发者能够轻松地在网页中嵌入可运行的代码示例核心Web组件runno-run- 主要的代码运行组件runno-editor- 代码编辑器组件runno-terminal- 终端输出组件runno-wasi- 直接运行WASI二进制文件的组件使用示例runno-run runtimepython editor controls print(Hello, Runno!) print(This code runs securely in your browser.) /runno-run这些组件通过Shadow DOM实现样式隔离通过Custom Elements API提供丰富的配置选项包括运行时选择、代码主题、终端样式等。六、MCP集成模型上下文协议支持Runno的runno/mcp包实现了MCPModel Context Protocol服务器这使得AI助手和代码生成工具能够安全地执行代码MCP服务器功能安全代码执行- AI可以在沙盒中运行生成的代码结果验证- 检查代码执行结果是否符合预期错误反馈- 提供详细的错误信息用于调试多语言支持- 支持所有Runno运行时配置示例{ mcpServers: { runno: { command: npx, args: [runno/mcp] } } }七、安全架构多层防护机制Runno的安全设计是其架构的核心优势1. WebAssembly沙盒内存隔离- 每个WASM模块有自己的线性内存指令验证- WebAssembly字节码经过严格验证控制流安全- 结构化控制流防止代码注入2. WASI权限系统文件系统沙盒- 只能访问虚拟文件系统能力导向安全- 基于权限的能力系统资源限制- 内存、CPU时间、文件描述符限制3. 浏览器安全特性跨域隔离- 需要COOP/COEP头部同源策略- 防止跨站脚本攻击内容安全策略- 额外的安全层八、性能优化高效的代码执行Runno在性能方面做了多项优化1. 预编译运行时所有语言运行时都预编译为WebAssembly减少浏览器中的即时编译开销提供一致的启动性能2. 懒加载策略按需加载语言运行时缓存已加载的WASM模块减少初始页面加载时间3. 高效的文件系统内存中的虚拟文件系统快速的文件访问操作最小化的I/O开销九、扩展性设计支持新语言运行时Runno的架构设计使得添加新的语言运行时变得简单添加新语言的步骤获取WASM二进制- 将语言解释器/编译器编译为WASM创建基础文件系统- 打包语言的标准库和依赖配置命令参数- 在commands.ts中添加运行时配置测试集成- 验证新语言在沙盒中的运行效果现有语言实现的参考开发者可以参考packages/sandbox/lib/commands.ts中现有的语言配置了解如何集成新的编程语言。十、实际应用场景Runno的架构设计支持多种实际应用1. 在线编程教育学生可以直接在浏览器中运行代码示例无需安装复杂的开发环境提供安全的代码执行环境2. 代码示例演示技术文档中的可运行代码示例博客文章中的交互式代码片段API文档中的实时测试3. 代码评估和测试自动化代码测试和评分编程竞赛的在线评判系统技术面试的编码测试4. AI辅助编程AI生成的代码可以立即测试代码补全的实时验证编程学习的智能助手总结Runno架构的核心价值Runno的架构设计体现了现代Web技术的创新应用标准化基础- 基于WASI标准确保兼容性和可移植性安全第一- 多层安全机制保护用户环境多语言支持- 统一的架构支持多种编程语言易于集成- Web组件和API提供灵活的集成方式性能优化- 精心设计的性能优化策略扩展性强- 模块化设计支持新功能添加通过将WebAssembly、WASI和现代Web技术相结合Runno创造了一个既安全又强大的代码执行环境。无论是教育、演示还是生产环境Runno都提供了一个可靠的解决方案让代码能够在任何地方安全运行。随着WebAssembly生态系统的不断发展Runno的架构将继续演进支持更多语言、更多功能和更好的性能。这个开源项目不仅展示了WebAssembly的潜力也为在线代码执行提供了一个优秀的技术参考。【免费下载链接】runnoSandboxed runtime for programming languages and WASI binaries. Works in the browser, on your server, or via MCP.项目地址: https://gitcode.com/gh_mirrors/ru/runno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考