agent-infra/sandbox

这是什么？

核心功能

• 01通过 VNC、Chrome DevTools Protocol 和 MCP 工具控制浏览器
• 02终端与文件读写共享同一文件系统
• 03内置 VSCode Server 和 JupyterLab，可直接在浏览器中编码
• 04预配置浏览器、文件、Shell 和文档转换 MCP 服务
• 05在沙箱内执行 Python 和 Node.js 代码
• 06可选 API Key 认证，保护接口和服务

适用场景

• 为 AI 智能体提供安全的命令和代码执行环境
• 自动化浏览器任务，并对下载的文件继续处理
• 在容器中为开发者提供可随时丢弃的云端 IDE
• 将 browser-use、LangChain 等智能体框架接入现成的工具环境

快速上手

1. 1

   使用 API 密钥运行沙箱容器（推荐）

   docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest
2. 2

   在 localhost:8080 打开文档

3. 3

   安装 Python SDK（可选）

   pip install agent-sandbox

使用前须知

• !需要 Docker，且容器需以 seccomp unconfined 方式运行。
• !部署依赖拉取体积较大的一体化容器镜像。

标签

常见问题

sandbox 是什么？

一个 Docker 一体化沙箱，为 AI 智能体提供浏览器、终端、文件系统、VSCode 和 MCP 等统一运行环境。 AIO Sandbox 将浏览器、终端、文件系统、VSCode Server、Jupyter 和 MCP 服务打包进同一个 Docker 容器。智能体或开发者可以在其中执行 Shell 命令、读写文件、操控浏览器，并运行 Python 或 Node.js 代码。浏览器下载的文件可以直接被终端和文件操作使用。

sandbox 可以免费使用吗？用的什么许可证？

sandbox 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

sandbox 还在维护吗？

半年内有更新。sandbox 最近一次提交是在 2026年9月14日。

sandbox 适合用来做什么？

为 AI 智能体提供安全的命令和代码执行环境 自动化浏览器任务，并对下载的文件继续处理 在容器中为开发者提供可随时丢弃的云端 IDE 将 browser-use、LangChain 等智能体框架接入现成的工具环境

sandbox 怎么安装和运行？

使用 API 密钥运行沙箱容器（推荐）: docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest 在 localhost:8080 打开文档 安装 Python SDK（可选）: pip install agent-sandbox

在哪里获取 sandbox？

源代码和安装说明在 GitHub 上：https://github.com/agent-infra/sandbox