搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

pithings/unkernel

开发工具

把真实 Linux 内核编译成 WebAssembly,在浏览器或 Node 中快速启动 Alpine Shell。

111
5
TypeScript
GPL-2.0
创建于 3 天前

项目介绍

unkernel 把一个真实的 Linux 内核编译成单个 WebAssembly 模块,启动后不到一秒即可进入 Alpine Linux Shell。内核的 syscall、调度器、内存管理、ext4 和 TCP/IP 都是原生 wasm 代码而非模拟执行;只有用户程序经由 kwemu(用 Zig 编写的 riscv64 CPU)加 JIT 模拟,因此 Alpine、Debian、Ubuntu 中未经修改的 riscv64 二进制可以直接运行。它面向希望在浏览器或 Node 中获得便携 Linux 环境、或把 Linux 嵌入自己应用的开发者。

浏览器试用

打开 unkernel.dev,下载约 10 MB 后会出现带包管理器、持久磁盘、网络和显示/声音支持的 Shell,改动在刷新后保留,并支持多终端窗口和坏系统恢复。页面接受 ?mem=512、?net=0、?data=0、?wisp=wss://... 等参数,分别调整内存、关闭网络、禁用持久盘和指定 Wisp 代理。浏览器无法直接建立 TCP 连接,联网需走 Wisp 代理;把页面部署到别处时需用 ?wisp= 指向自己的 Wisp 代理。Chrome/Edge 137+、Firefox 153+、Safari 27+ 有明确支持记录,缺少 JSPI 等能力的浏览器会直接提示。

终端快速开始

只需要 Node.js,无需搭建工程:

npx unkernel

它会从内存启动 Alpine,并通过宿主机 socket 联网,按 Ctrl-] 退出。常用选项包括 --disk alpine.ext4 使用可持久化的 ext4 根盘、--mount .:/work 把宿主机目录挂进 guest、--forward 8000:80 转发端口到 guest 服务,以及 --timeout/--input 做脚本化运行并由退出码报告结果。完整 CLI 用法见终端章节。

通过 JavaScript 使用

安装 npm 包 后创建内核:

npm install unkernel
import { createKernel } from "unkernel";

const vm = await createKernel();
vm.onOutput((bytes) => process.stdout.write(bytes));
vm.write("uname -a; poweroff\n");

const { code, kind } = await vm.exited;

这段代码在 Node 和浏览器中都能运行;unkernel/node、unkernel/web 可显式选择入口。除基本控制台外,SDK 还提供 exec() 和基于 pty 的 spawn() 执行程序、经 9p/vsock 挂载宿主机目录、vsock 字节流、通过 vm.connect() 与 vm.fetch() 访问 guest 回环 TCP 服务、共享内存、framebuffer/evdev/ALSA 接口,以及通过 directBackend() 或 wispBackend() 启用网络。各接口细节见 SDK 章节。

使用约束

内核只有单 CPU、无 SMP,不支持 IPv6,UDP 仅覆盖 DHCP/DNS,也不接受入站连接。ptrace 寄存器集合和 seccomp 缺失,strace 与 gdb 无法使用,内核中的 wasm trap 会终止会话。JIT 只覆盖热点整数代码,原子指令和系统指令仍走解释器。SDK 方面,guest 通过终端/控制台或自写 vsock 程序驱动,stop() 不是干净关机(优先用 poweroff),每个线程只能运行一个内核,Node-only 的 TypeScript 项目使用其类型时需要 DOM 类型或 skipLibCheck。

从源码构建

需要 Linux x86-64 或 arm64、Zig 0.16、Node 24、带 wasm target 的 clang 21+ 及常用构建工具,./setup.sh --check 会列出缺失项。首次构建约 12 分钟、占用 5 GiB 磁盘。./setup.sh 完成检查和构建,node js/cli.ts 启动自己构建的版本,pnpm install && pnpm dev 在本地提供网页。内核及补丁采用 GPL-2.0-or-later,JavaScript SDK 和页面采用 MIT,因此 npm 包为 MIT AND GPL-2.0-only。

HotRepo 点评

unkernel 创建于 2026-11-12,2026-11-16 的 TypeScript 新项目快照显示 111 Star,在记录的一小时窗口内新增 10,尚未记录到 GitHub 全语言日榜名次。观察窗口很短,这些数字只说明早期关注,不足以判断趋势。它的特殊之处在于架构:Linux 内核原生跑在 wasm 中,只模拟 riscv64 用户态,背后是真实的 Sv39 页表和解释器/JIT 两层执行,外设走轻量半虚拟化驱动。README 自己的基准显示 syscall 接近原生、纯计算明显落后,这与设计相符,也是评估 CPU 密集型 guest 负载时首先要看的数字。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。