OpenSandbox 是什么?1.67 万星的 Agent 沙箱底座,Docker 到 K8s 一套 API,凭据不进沙箱(基础篇)

OpenSandbox 是什么?1.67 万星的 Agent 沙箱底座,Docker 到 K8s 一套 API,凭据不进沙箱(基础篇)

Agent 会写代码只是第一步。等它能自己开 shell、装依赖、跑测试,问题就从「它聪不聪明」变成了「它会不会把我这台机器搞坏」。OpenSandbox 是这道题的基建答案:不教 Agent 怎么思考,只负责给它一间带门锁的工位——跑命令、改文件、开浏览器都在里面,出门还得过安检。

它是什么

仓库在 opensandbox-group/OpenSandbox,11 月 9 日的数据是 16,696 星、1,576 个 fork、156 个 open issue,Apache-2.0。2025 年 12 月 17 日建仓,到现在还不满一年。

血统得交代清楚:它原来是 alibaba/OpenSandbox,2026 年 6 月转到独立组织,现在是 Agentic AI Foundation(AAIF)名下的项目。AAIF 的项目页记着 609 个贡献者、98 家组织。但包名没跟着改——Java 还是 com.alibaba.opensandbox,npm 还是 @alibaba-group/opensandbox,Go module 还指 github.com/alibaba/OpenSandbox。翻代码的人一眼就知道是谁写的。

定位一句话:它不是 Agent 框架,是 Agent 的沙箱平台。官方 description 写得很直白——Secure, Fast, and Extensible Sandbox runtime for AI agents。给 AI 应用开隔离环境,执行代码、跑命令、管文件、开浏览器和桌面。

版本节奏现在很密:1.2.0 稳定版 10 月 27 日发,1.2.1-rc.1 在 11 月 4 日切出来。

它到底给了什么

拆成六层看比较清楚。

协议层。specs/ 下的 OpenAPI 是唯一契约:生命周期走 /v1,执行走 execd API,外发走 egress 策略,各有一份规格。好处是换运行时不用换客户端,自定义运行时也能照着协议接进来,不用 fork。

控制面。一个 FastAPI 写的 lifecycle server,管创建、续期、暂停、恢复、快照、模板。它只做校验和编排,真正开容器的是运行时后端。

运行时。本地 Docker 一条路;K8s 上可以挂 BatchSandbox 或 kubernetes-sigs/agent-sandbox;再往上是 FastSandbox,用 Firecracker microVM,README 报的数是创建 64ms P50(串行)、10 并发 125.4ms P99,pause/resume 能把内存和磁盘状态一起留住。

数据面。沙箱里的 execd 提供命令、文件、PTY、Jupyter kernel。官方 code-interpreter 镜像带 Python、Java、Node、Go,还有五种 Jupyter kernel。示例里能看到 Claude Code、Codex CLI、Chrome、Playwright、VNC、VS Code 都能塞进去跑。

网络与凭据。入站统一走 ingress 网关;出站按沙箱下发 egress 策略,DNS 和 nftables 两层落地。Credential Vault 让出站请求带上真凭据,但沙箱里的 workload 读不到明文。1.2.0 落地的是 OSEP-0022,1.2.1-rc 又加了 exchange——按请求解析 header,不落盘。

接入面。Python、Java/Kotlin、TypeScript、C#/.NET、Go 五套 SDK,一个 osb CLI,还有一个 MCP server,Claude Code 和 Cursor 可以直接连。

OpenSandbox 架构:客户端接入经生命周期服务创建沙箱,执行走 execd 直连,出站经 egress 策略与 Credential Vault
OpenSandbox 的三条路径:生命周期走控制面,执行与文件直连解析后的端点,出站过 egress 和凭据保险柜

怎么上手

官方现在推荐用 uv 起服务:

uvx opensandbox-server init-config ~/.sandbox.toml --example docker
uvx opensandbox-server
uv pip install opensandbox

然后十几行 Python 就能建沙箱、跑命令、写文件、读回来、销毁:

import asyncio
from opensandbox import Sandbox
from opensandbox.models import WriteEntry

async def main():
    box = await Sandbox.create("alpine")
    try:
        r = await box.commands.run("echo 'Hello OpenSandbox!'")
        print(r.logs.stdout[0].text)
        await box.files.write_files([
            WriteEntry(path="/tmp/hi.sh", data="echo hi $1", mode=755)
        ])
        print(await box.files.read_file("/tmp/hi.sh"))
        r = await box.commands.run("sh /tmp/hi.sh godsun")
        [print(l.text) for l in r.logs.stdout]
    finally:
        await box.destroy()

asyncio.run(main())

不想写代码就用 osb:

osb config init
osb sandbox create --image python:3.12 --timeout 30m -o json
osb command run <sandbox-id> -o raw -- python -c "print(1 + 1)"

MCP 那条路更短:pip install opensandbox-mcp,跑 opensandbox-mcp --domain localhost:8080 --protocol http,再配进 Claude Code 的 mcpServers。

几句实话

第一,64ms 这个数字有前提。那是 K8s 加 Firecracker 的路径,笔记本上 Docker 起的是容器不是 microVM,别拿 README 的数当本机指标。

第二,五套 SDK 就是五份维护债。156 个 open issue 摆在那儿,1.2.1 还在 rc,生产上钉 1.2.0 的镜像 digest,别跟 main。README 自己也承认,umbrella release 的签名和来源证明还有缺口(issue #2463),旧的分组件发布才有 Cosign。

第三,自托管不等于省事。单机 Docker 够玩;K8s 那套要有人管 ingress 网关、egress 策略、存储卷、节点池。这是给平台团队用的东西,不是给个人博客用的。

第四,它和托管沙箱不是一类生意。E2B 那种是把沙箱当 API 卖,按秒计费,省心;OpenSandbox 卖的是「跑在你自己机器上」。Daytona 六月份转闭源那件事说明,这类基建的所有权比功能表更重要——挂到基金会名下,至少不会哪天醒来发现 license 变了。

第五,社区在长,主力还是原班人马。贡献榜第一的 Pangjiping 一个人 2,113 次提交,比第二名的 429 次多出一个量级。98 家组织听着热闹,真正在维护的还是那几个人。

所以它适合谁:已经有 K8s、又要跑不可信代码的团队——编码 Agent、Agent 评测、RL 训练、代码解释器,这些场景都要「一次性、隔离、能批量」的环境。个人想跑段代码,装 Docker 或者直接调 E2B 更快;要的是「Agent 外面那层笼子」的整体方案,可以翻翻之前写的 NemoClaw 和 OpenShell。托管沙箱的账,E2B 和 Daytona 那两篇算得更细。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注