#简介

#背景

大多数沙盒都是单一用途（浏览器、代码或 Shell），这使得文件共享和功能协调变得极其困难。例如，浏览器沙盒下载的文件往往需要先复制到外部存储，其他工具才能使用；一个 Agent 任务也可能需要多个环境准备就绪后才能运行。

#什么是 AIO Sandbox？

AIO Sandbox 是一个一体化的 Agent 沙盒环境，在单个 Docker 容器中结合了浏览器、Shell、文件、MCP 操作和 VSCode Server。基于云原生轻量级沙盒技术构建，它为 AI Agent 和开发者提供了统一的沙盒环境。

除了工具集成，它还提供实时沙盒预览以观察 Agent 活动，并提供对 Agent 友好的 API（MCP-ready），便于 Agent 轻松集成。

#关键特性

#统一文件系统

由于所有组件都在同一容器中运行，浏览器下载的文件可以立即通过 Shell 和文件操作访问，实现无缝工作流。

#多接口访问

• VNC：/vnc/index.html 处的可视化浏览器交互
• Code Server：/code-server/ 处的完整 VSCode 体验
• Terminal：/v1/shell/ws 处的 WebSocket 终端
• Bash：/v1/bash/* 处的 pipe 模式命令执行
• 代码运行时：通过 /v1/code/*、/v1/jupyter/* 和 /v1/nodejs/* 执行 Python 与 JavaScript
• MCP Hub：/mcp 处的聚合服务

#MCP 集成

API 和 MCP 服务器支持相互调用，实现不同服务层之间的无缝通信和增强的互操作性：

• 浏览器自动化
• 文件系统操作
• 终端交互
• 代码执行
• Skills
• 文档处理（Markitdown）

#开发预览

用于测试应用程序的内置代理端点：

• 通配符域访问：${port}-${domain} 用于通配符域路由
• 子路径访问：
  • /proxy/{port}/ 用于后端服务
  • /absproxy/{port}/ 用于前端应用程序

#使用场景

#AI Agent 开发

非常适合构建需要以下功能的 AI Agent：

• 浏览网站并与 Web 应用程序交互
• 在安全沙盒中执行代码
• 操作文件并运行 Shell 命令
• 无缝访问多个开发工具

#云开发

非常适合需要以下功能的团队：

• 远程开发环境
• 团队成员之间的标准化工具
• 安全的代码执行环境
• 易于部署和扩展

#自动化工作流

非常适合需要以下功能的场景：

• 带有视觉反馈的浏览器自动化
• 文件处理和代码生成
• 多步骤开发管道
• 集成测试环境

#架构概览

#开始使用

准备好开始了吗？查看我们的快速开始指南，几分钟内即可运行您的 AIO Sandbox。

有关特定组件的详细信息，请探索侧边栏导航中的指南。如果你计划部署到云主机或 Kubernetes，请阅读云上部署。如果你正在选择 Agent 应该运行在沙盒外还是沙盒内，请阅读 Agent Call Sandbox vs In Sandbox。