Repolode
提交项目
opensandbox-group

opensandbox-group/OpenSandbox

开源沙箱运行时，为 AI 智能体提供隔离环境，用于执行代码、命令、文件及浏览器操作。

在 GitHub 查看官网
Star
16,496
Fork
1,559
未关闭 Issue
158
最近提交
8小时前

这是什么？

OpenSandbox 为 AI 应用提供隔离的沙箱环境，可用于执行代码、运行 Shell 命令、管理文件，以及操作浏览器或桌面。项目可以用 Docker 在本地启动，也可以部署到 Kubernetes，二者都通过同一套沙箱 API 管理。

项目包含基于 Firecracker 的 Fast Sandbox 运行时，支持暂停和恢复，并保留内存与磁盘状态。网络方面，入站流量经统一的 ingress 网关转发，出站访问可按沙箱配置 egress 策略；Credential Vault 则让智能体调用外部服务时无需接触真实凭据。

客户端可使用 Python、Java/Kotlin、TypeScript/JavaScript、C#/.NET 和 Go SDK，也可以通过终端 CLI `osb` 或 MCP 服务器接入 Claude Code、Cursor 等工具。示例涵盖编程智能体、代码解释器、Playwright 与 Chrome 自动化、桌面环境以及智能体评测。

核心功能

  • 01通过统一的生命周期 API 从容器镜像创建沙箱，可在本地 Docker 或 Kubernetes 上运行。
  • 02在隔离环境中执行命令、读写文件和运行代码。
  • 03基于 Firecracker 的 Fast Sandbox 运行时支持暂停与恢复，并保留状态。
  • 04通过按沙箱配置的出站策略和统一入口网关控制网络访问。
  • 05Credential Vault 在出站调用时注入凭据，避免暴露给沙箱内的工作负载。
  • 06提供 Python、Java/Kotlin、TypeScript、C#/.NET、Go 等 SDK，以及 osb 命令行工具和 MCP 服务器。

适用场景

  • 在隔离环境中运行 Claude Code、Codex CLI 等编程智能体，让其编辑文件并执行命令。
  • 执行模型生成的代码，并通过 Code Interpreter SDK 处理结果。
  • 为 Web 自动化测试提供浏览器环境，或为智能体提供桌面环境。
  • 为每次评测或强化学习训练试验分配独立沙箱。

快速上手

  1. 1

    生成示例服务器配置（需要 Docker）

    uvx opensandbox-server init-config ~/.sandbox.toml --example docker
  2. 2

    启动沙箱服务器

    uvx opensandbox-server
  3. 3

    安装 Python SDK

    uv pip install opensandbox

使用前须知

  • 本地运行需要 Docker，生产环境部署到 Kubernetes 需要集群和运维配置。

收录于专题

AI 智能体沙箱开源 AI Agent 框架与应用MCP Server 精选

标签

#ai-agent#sandbox#kubernetes#docker#code-execution#mcp#firecracker#aaif#ai#ai-infra

常见问题

OpenSandbox 是什么？
开源沙箱运行时，为 AI 智能体提供隔离环境，用于执行代码、命令、文件及浏览器操作。 OpenSandbox 为 AI 应用提供隔离的沙箱环境，可用于执行代码、运行 Shell 命令、管理文件，以及操作浏览器或桌面。项目可以用 Docker 在本地启动，也可以部署到 Kubernetes，二者都通过同一套沙箱 API 管理。
OpenSandbox 可以免费使用吗？用的什么许可证？
OpenSandbox 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
OpenSandbox 还在维护吗？
活跃维护中。OpenSandbox 最近一次提交是在 2026年11月7日。
OpenSandbox 适合用来做什么？
在隔离环境中运行 Claude Code、Codex CLI 等编程智能体，让其编辑文件并执行命令。 执行模型生成的代码，并通过 Code Interpreter SDK 处理结果。 为 Web 自动化测试提供浏览器环境，或为智能体提供桌面环境。 为每次评测或强化学习训练试验分配独立沙箱。
OpenSandbox 怎么安装和运行？
生成示例服务器配置（需要 Docker）: uvx opensandbox-server init-config ~/.sandbox.toml --example docker 启动沙箱服务器: uvx opensandbox-server 安装 Python SDK: uv pip install opensandbox
在哪里获取 OpenSandbox？
源代码和安装说明在 GitHub 上：https://github.com/opensandbox-group/OpenSandbox

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目