news 2026/7/5 16:49:42

Runno架构设计：从WASI实现到多语言支持的完整技术栈

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Runno架构设计：从WASI实现到多语言支持的完整技术栈

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/runno

Runno是一个基于WebAssembly的沙盒化运行时，支持在浏览器、服务器或通过MCP运行多种编程语言和WASI二进制文件。这个开源项目的完整技术栈展示了如何构建一个安全、高效的代码执行环境，让开发者能够在浏览器中直接运行Python、Ruby、JavaScript、C/C++、PHP和SQLite等语言的代码。本文将深入解析Runno的架构设计，从底层的WASI实现到上层多语言支持，揭示这个创新项目的技术奥秘。

一、核心架构：WASI预览1标准的完整实现

Runno的核心基础是@runno/wasi包，它实现了WASI（WebAssembly System Interface）预览1标准。WASI为WebAssembly提供了一个标准化的系统接口，允许WebAssembly模块访问操作系统功能，而无需依赖具体的操作系统。

WASI实现的关键组件

Runno的WASI实现包含以下几个核心组件：

  1. WASI上下文管理(wasi-context.ts) - 管理运行环境、参数和环境变量
  2. 文件系统驱动(wasi-drive.ts) - 实现虚拟文件系统操作
  3. 快照预览1实现(snapshot-preview1.ts) - 完整的WASI预览1API实现
  4. 不稳定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目前支持以下编程语言运行时：

  1. Python 3.11.3- 来自VMware实验室的WebAssembly语言运行时
  2. Ruby 3.2.0- 同样来自VMware的Ruby实现
  3. QuickJS- 来自Second State的轻量级JavaScript引擎
  4. SQLite- 来自WAPM的SQLite数据库引擎
  5. Clang/Clang++- 来自binji的C/C++编译器工具链
  6. PHP-CGI 8.2.0- PHP的CGI实现

三、虚拟文件系统：安全的隔离环境

Runno实现了一个完整的虚拟文件系统，为每个代码执行实例提供隔离的存储环境。这个设计确保了代码无法访问宿主机的真实文件系统，提供了重要的安全隔离。

文件系统结构

在packages/wasi/lib/wasi/wasi-drive.ts中实现的WASIDrive类，提供了以下核心功能：

  1. 文件操作- 支持创建、读取、写入、删除文件
  2. 目录管理- 支持目录遍历和操作
  3. 权限控制- 基于WASI权限标志的文件访问控制
  4. 时间戳管理- 维护文件的访问、修改和变更时间

基础文件系统包

每种语言运行时都附带一个基础文件系统包（.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; } = {} ): Promise<RunResult> { // 获取运行时命令配置 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组件

  1. <runno-run>- 主要的代码运行组件
  2. <runno-editor>- 代码编辑器组件
  3. <runno-terminal>- 终端输出组件
  4. <runno-wasi>- 直接运行WASI二进制文件的组件

使用示例

<runno-run runtime="python" editor controls> print('Hello, Runno!') print('This code runs securely in your browser.') </runno-run>

这些组件通过Shadow DOM实现样式隔离，通过Custom Elements API提供丰富的配置选项，包括运行时选择、代码主题、终端样式等。

六、MCP集成：模型上下文协议支持

Runno的@runno/mcp包实现了MCP（Model Context Protocol）服务器，这使得AI助手和代码生成工具能够安全地执行代码：

MCP服务器功能

  1. 安全代码执行- AI可以在沙盒中运行生成的代码
  2. 结果验证- 检查代码执行结果是否符合预期
  3. 错误反馈- 提供详细的错误信息用于调试
  4. 多语言支持- 支持所有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的架构设计使得添加新的语言运行时变得简单：

添加新语言的步骤

  1. 获取WASM二进制- 将语言解释器/编译器编译为WASM
  2. 创建基础文件系统- 打包语言的标准库和依赖
  3. 配置命令参数- 在commands.ts中添加运行时配置
  4. 测试集成- 验证新语言在沙盒中的运行效果

现有语言实现的参考

开发者可以参考packages/sandbox/lib/commands.ts中现有的语言配置，了解如何集成新的编程语言。

十、实际应用场景

Runno的架构设计支持多种实际应用：

1. 在线编程教育

  • 学生可以直接在浏览器中运行代码示例
  • 无需安装复杂的开发环境
  • 提供安全的代码执行环境

2. 代码示例演示

  • 技术文档中的可运行代码示例
  • 博客文章中的交互式代码片段
  • API文档中的实时测试

3. 代码评估和测试

  • 自动化代码测试和评分
  • 编程竞赛的在线评判系统
  • 技术面试的编码测试

4. AI辅助编程

  • AI生成的代码可以立即测试
  • 代码补全的实时验证
  • 编程学习的智能助手

总结：Runno架构的核心价值

Runno的架构设计体现了现代Web技术的创新应用：

  1. 标准化基础- 基于WASI标准，确保兼容性和可移植性
  2. 安全第一- 多层安全机制保护用户环境
  3. 多语言支持- 统一的架构支持多种编程语言
  4. 易于集成- Web组件和API提供灵活的集成方式
  5. 性能优化- 精心设计的性能优化策略
  6. 扩展性强- 模块化设计支持新功能添加

通过将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），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/7/5 16:47:23

Andromeda核心功能深度解析：从Nova引擎到GPU加速Canvas

Andromeda核心功能深度解析&#xff1a;从Nova引擎到GPU加速Canvas 【免费下载链接】andromeda JS runtime lolz 项目地址: https://gitcode.com/gh_mirrors/andromeda18/andromeda Andromeda作为一款高性能JS runtime&#xff0c;其核心功能围绕Nova引擎与GPU加速Canva…

作者头像 李华
网站建设 2026/7/5 16:47:06

从CKAD认证到实际工作：Kubernetes应用开发技能迁移终极指南

从CKAD认证到实际工作&#xff1a;Kubernetes应用开发技能迁移终极指南 【免费下载链接】ckad-prep-notes List of resources and notes for passing the Certified Kubernetes Application Developer (CKAD) exam. 项目地址: https://gitcode.com/gh_mirrors/ck/ckad-prep-n…

作者头像 李华
网站建设 2026/7/5 16:44:05

智能支付系统革命：Jeepay计全支付如何重塑企业支付生态

智能支付系统革命&#xff1a;Jeepay计全支付如何重塑企业支付生态 【免费下载链接】jeepay Jeepay是一套适合互联网企业使用的开源支付系统&#xff0c;支持多渠道服务商和普通商户模式。已对接微信支付&#xff0c;支付宝&#xff0c;云闪付官方接口&#xff0c;支持聚合码支…

作者头像 李华
网站建设 2026/7/5 16:43:43

如何使用Clang-tutorial：初学者快速上手LLVM工具开发的5个步骤

如何使用Clang-tutorial&#xff1a;初学者快速上手LLVM工具开发的5个步骤 【免费下载链接】Clang-tutorial A collection of code samples showing usage of clang and llvm as a library 项目地址: https://gitcode.com/gh_mirrors/cla/Clang-tutorial Clang-tutorial…

作者头像 李华
网站建设 2026/7/5 16:43:12

Stout与CI/CD集成：在CircleCI、GitHub Actions中自动化部署静态网站

Stout与CI/CD集成&#xff1a;在CircleCI、GitHub Actions中自动化部署静态网站 【免费下载链接】Stout A reliable static website deploy tool 项目地址: https://gitcode.com/gh_mirrors/st/Stout Stout是一个可靠的静态网站部署工具&#xff0c;专门用于将网站文件上…

作者头像 李华