项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 21224
技术标签
使用教程
环境要求
- macOS 或 Linux 系统(可直接用一键脚本安装 CLI)
- Windows 系统需使用 PowerShell 安装
- 可选:Node.js 20 或更高版本(使用 JavaScript/TypeScript SDK 时需要)
- 可选:已安装 Python 与 pip(使用 Python SDK 时需要,SDK 轮子支持 macOS/Linux 的 Intel 与 ARM64)
- 可选:已安装 Homebrew(macOS/Linux 上想用 brew 安装时)
安装与启动步骤
-
1macOS/Linux 装 CLI
用官方一键脚本下载并安装 Wasmer CLI,安装完成后终端会多出 wasmer 命令。
curl https://get.wasmer.io -sSfL | sh -
2Windows 装 CLI
在 PowerShell 中执行该命令下载安装 Wasmer CLI,适用于 Windows 平台。
iwr https://win.wasmer.io -useb | iex -
3用 Homebrew 安装
macOS/Linux 上已装 Homebrew 时,可改用 brew 安装 Wasmer CLI,二选一即可。
brew install wasmer -
4运行 Python 沙箱
从 registry 拉取 python/python 包并在沙箱内执行 Python 代码,本机无需安装 Python。
wasmer run python/python -- -c "print('Hello from Wasmer')" -
5运行 Bash 与 Cowsay
再试两个沙箱例子:Bash 执行 echo,以及 Cowsay 打印一段文字,验证沙箱能力。
wasmer run wasmer/bash -- -c "echo 'Hello from Wasmer'" wasmer run syrusakbary/cowsay -- "Hello from Wasmer" -
6安装 SDK(可选)
需要把沙箱嵌入自己的应用时,按语言安装 SDK:JS 用 npm,Python 用 pip。
npm install @wasmer/sdk python -m pip install wasmer-sdk -
7跑 JS SDK 示例
把 README 中的示例保存为 sandbox.mjs,然后执行它,Python 代码将在沙箱内运行。
node sandbox.mjs
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--volume | 否 | 把本地目录挂载给沙箱,授予其文件访问权限;默认沙箱不接触本地文件。 | --volume /your/path |
--net | 否 | 为沙箱启用主机网络访问,程序需要联网时加上。 | --net |
packages | 是 | SDK 创建沙箱时指定要运行的 registry 包及其版本。 | python/python@=3.13.20 |
如何确认成功
执行 wasmer run python/python -- -c "print('Hello from Wasmer')",终端输出 Hello from Wasmer 即表示安装与运行成功。
常见问题
Q:不想在本机安装任何东西怎么办?
A:直接打开 https://wasmer.sh,在浏览器里就能试用沙箱,无需安装。
Q:沙箱里的 Python 需要本机先装 Python 吗?
A:不需要。Python 在沙箱内执行,由 Wasmer 从 registry 下载该包并缓存,本机无需安装。
Q:怎么让沙箱读写我本地的文件或联网?
A:默认不允许。用 --volume 授予某个目录的访问权限,需要网络时再加 --net 选项。
Q:Rust SDK 可以用 cargo 安装吗?
A:目前不行,Rust SDK 是源码依赖,需克隆 wasmerio/wasmer-sdk 并将依赖指向其 rust 目录,crates.io 发布已暂时关闭。
Q:命令里的 -- 有什么作用?
A:它用来分隔 Wasmer 自身的选项和传给沙箱程序的参数,把程序参数放在 -- 之后即可。
注意事项
- Wasmer 首次运行某个包时会先下载并缓存,之后再次运行会更快。
- 在浏览器中运行 JS 沙箱需要页面开启跨源隔离(Cross-Origin-Opener-Policy: same-origin 与 Cross-Origin-Embedder-Policy: require-corp)。
- 更多安装方式见官方安装指南 https://docs.wasmer.io/install/,CLI 细节见 https://docs.wasmer.io/runtime/cli/。
- Swift SDK 的该版本提供预编译的 macOS 二进制,其他平台支持情况见其 Swift 设置指南。
核心亮点
- 启动速度毫秒级,内存占用远低于容器和虚拟机
- 支持 WASI/WASIX 标准,可运行多语言编译的模块
- 提供 Rust/Python/JS/C 等多语言 SDK,易于嵌入现有应用
不足之处
- WASIX 等扩展标准生态仍在早期,部分系统调用兼容性有限
- 对需要完整操作系统能力(如原生线程、GPU)的场景支持不足
适用场景
- SaaS 平台运行用户上传的插件或自定义逻辑
- AI Agent 工具调用时隔离执行不可信代码
- 边缘计算/无服务器函数中快速冷启动执行任务
替代项目
wasmtime、wasm3
下一篇:console
同类项目推荐
ezdata
开源
连接 60+ 数据源,AI 自动查询、绘图、分析,让数据开口说话。
AI-native data platform: 60+ connectors, dlt-based ETL, DAG scheduling, per-source R···
ADI-Stable-Diffusion
开源
用 C++ 和 ONNXRuntime 让 Stable Diffusion 推理飞起来
Accelerate your Stable Diffusion inference with the library's universal C/C++ framew···
cube-studio
开源
一站式拖拽构建AI流水线,轻松搞定大模型训练与推理
cubestudio开源云原生一站式机器学习/深度学习/大模型AI平台/MaaS/mlops/人工智能平台/训推···
agentcat-typescript-sdk
开源
给 MCP 服务器装上监控,一眼看清工具调用数据
AgentCat is an analytics platform for MCP server owners .
beta9
开源
让 GPU 推理快如闪电,秒级启动,按需付费
Ultrafast serverless GPU inference, sandboxes, and background jobs
redis
开源
高性能内存数据库,搞定缓存、队列和实时查询
For developers, who are building real-time data-driven applications, Redis is the pr···
fastembed-js
开源
在 Node.js 里直接生成文本向量,告别 Python 服务
Generate vector embeddings in NodeJS
byok-relay
开源
前端直连大模型,用户自带密钥,绕过 CORS 限制
Bring your own key (BYOK) relay to enable lightweight frontend-only apps to use LLMs···
llm-sandbox
开源
给 LLM 一个安全的代码沙箱,跑 AI 生成的代码不翻车
Lightweight and portable LLM sandbox runtime (code interpreter) Python library.
