#简介

#背景

大多数沙盒都是单一用途（浏览器、代码或 Shell），这使得文件共享和功能协调变得极其困难。例如，浏览器沙盒下载的文件需要通过 NAS/OSS 与其他沙盒共享，而一个 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 终端
• MCP Hub：/mcp 处的聚合服务

#MCP 集成

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

• 浏览器自动化
• 文件系统操作
• 终端交互
• 文档处理（Markitdown）
• 研究工具（Arxiv）

#开发预览

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

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

#使用场景

#AI Agent 开发

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

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

#云开发

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

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

#自动化工作流

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

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

#架构概览

┌─────────────────────────────────────────────────────────────┐
│                         AIO Sandbox                         │
├─────────────────────────────────────────────────────────────┤
│  🌐 浏览器 + VNC         │  💻 VSCode Server                 │
├─────────────────────────────────────────────────────────────┤
│  🐚 Shell WebSocket     │  📁 文件系统 API                   │
├─────────────────────────────────────────────────────────────┤
│  🤖 MCP Hub 服务        │  🔒 代码执行                       │
├─────────────────────────────────────────────────────────────┤
│  🚀 预览代理            │  📊 服务管理                       │
└─────────────────────────────────────────────────────────────┘

#开始使用

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

有关特定组件的详细信息，请探索侧边栏导航中的指南。