Conch - Agent Sandbox Engine

Conch 是一个基于 Go 开发的容器沙箱引擎，能够适用于 Agent 对沙箱的高启动性能、高弹性、高 I/O 性能和高密度部署的诉求。 项目围绕以下 Agent 对沙箱新需求展开：

1. 新生态：相比传统命令行和K8S云原生生态，提供 Agent 原生的沙箱管理 API 和 SDK；
2. 新镜像：相对传统 OCI v1 容器镜像格式，提供 EROFS 镜像格式，统一管理容器镜像和快照；
3. 新硬件（超节点）：相比传统单机管理容器镜像，利用超节点高速互联能力，提供跨级镜像共享和管理机制。

核心特性

• 轻量安全隔离 -- 支持虚拟沙箱，对 Agent 任务进行安全隔离。支持完整的生命周期管理，包括创建、暂停、恢复和删除等操作。
• 快照启动加速 -- 支持虚拟机内存和根文件系统的快照功能。通过快照机制，可以实现秒级的沙箱启动，显著提升大规模部署场景下的资源利用效率。快照采用写时复制（Copy-on-Write）技术，最小化存储开销。
• 精简容器网络 -- 通过 veth 设备和 NAT 规则实现网络隔离和地址转换，支持容器网络池化复用，降低启动时延。

快速开始

环境要求

• Go 1.23+
• Containerd 2.2.1+
• Cloud-Hypervisor v48.0+
• Iptables 网络配置工具
• Linux 5.10+

一键编译安装

# 克隆代码仓库
git clone https://atomgit.com/openeuler/Conch.git
cd Conch
git checkout demo

# 一键执行全流程
./scripts/conch-env-setup.sh all

pip install -e ./sdk

运行服务

编译完成后，二进制文件位于 bin/ 目录下，通过以下命令启动conchd服务：

./bin/conchd

Python SDK 示例

from conch import Sandbox
sandbox = Sandbox()
result = sandbox.execute(cmd="python3",content="print('hello Conch！')")
print(result)
sandbox.delete()

许可证

木兰宽松许可证， 第2版

贡献指南

欢迎社区贡献代码和文档。