AI Coding 多沙盒隔离 · namespace · 内置 pi Agent

沙盒开发环境
管理平台

轻量级沙盒开发环境管理平台,集成 AI Coding Agent。每个沙盒独立 namespace 隔离,支持多项目多用户并行开发。Docker 一键部署,GitHub Actions 多架构 CI。

⭐ 查看源码 📖 文档
$ docker run -d --privileged ghcr.io/dyyz1993/sandbox-box:latest
5
Namespace 隔离
19
AI 模型
Web
管理面板
ARM64
多架构
ARCHITECTURE

5 层架构

从 Web 到沙盒,完整闭环

┌─────────────────────────────────────────┐Web 管理面板 (React)            │
│  Sandboxes | Projects | Users | Agent├─────────────────────────────────────────┤Node.js API Server             │
│  SQLite DB | RPC Bridge | WebSocket├─────────────────────────────────────────┤沙盒引擎 (Shell)                │
│  unshare | nsenter | veth | nginx├─────────────────────────────────────────┤pi Coding Agent (RPC)             │
│  sandbox-bash extension | 19 models├─────────────────────────────────────────┤Docker Container                │
│  node:22 | supervisor | sshd | nginx└─────────────────────────────────────────┘
ISOLATION

5 层 namespace 隔离

真正的沙盒,互不干扰

Network NS

veth pair + 独立子网 10.10.{id}.0/24

Mount NS

两阶段 bind mount,workspace 隔离

UTS NS

独立 hostname,容器名隔离

PID NS

独立进程空间,ps 看到的都是自己的

cgroup v2

内存限制 512MB,优雅降级

FEATURES

核心特性

🧱

多沙盒隔离

每个沙盒独立 network/UTS/filesystem namespace,互不干扰,真正沙盒。

🤖

AI Agent 集成

内置 pi coding agent,通过工具调用在沙盒内执行命令。19 个模型可选。

🖥

Web 管理面板

沙盒 / 项目 / 用户 / 工作区一站式管理,React 前端。

🔀

多工作区

同一项目可创建多个工作区,各自独立开发,适合实验性分支。

👤

用户隔离

每个用户独立沙盒环境,资源隔离,数据隔离。

🌿

Git 集成

支持 Token 认证,clone / commit / push 全流程,直接在沙盒内完成。

💻

Web 终端

每个沙盒 ttyd 终端接入,浏览器即可 SSH。

🌐

域名映射

每个沙盒自动分配子域名,Nginx 反向代理,沙盒内服务直接外网访问。

🚀

CI/CD

GitHub Actions 多架构自动构建,NAS 一键更新。

每个项目一个家

AI 编码 · 多用户 · 多项目 · 完全隔离