code Sandbox - 生产级 Python 执行沙箱

本项目实现了一个基于 FastAPI 的高性能、多层安全限制的 Python 代码执行沙箱服务。它旨在提供一个类似 Dify-Sandbox 的、可信赖的、高并发的代码执行环境，特别针对生产环境的安全性和可扩展性进行了优化。

本沙箱采用了 “层层限制” 的多级安全防护体系，确保用户代码在隔离环境中安全运行。

• 高性能：基于 FastAPI + Uvicorn，支持高并发和可配置的线程池优化。
• 多版本 Python：支持通过 language 参数指定 Python 版本（如 python3.9, python3.10, python3.11）。
• 参数化执行：支持通过 Base64 编码的 JSON 参数，自动解码后作为 main(obj) 函数的参数传入。
• 配置化管理：通过 config/config.yaml 文件集中管理所有核心参数（端口、线程池、限流规则、受限函数/模块）。
• 多架构支持：提供针对 x86_64 和 麒麟 V10 (ARM64) 的 Dockerfile，方便在不同国产化平台上部署。
• Node.js 预留：预留了 Node.js 语言分支，方便未来扩展。

确保您已安装 Docker 和 Docker Compose。

修改 config/config.yaml 文件以适应您的生产环境需求：

本项目提供了针对不同架构的 Dockerfile，并附带了构建脚本。

使用构建脚本 (推荐)：

chmod +x build.sh
./build.sh

手动构建示例：

# 构建 x86_64 镜像
docker build -f Dockerfile.x86 -t code-sandbox:x86_64 .

# 运行镜像（挂载宿主机配置）
docker run -d -p 8000:8000 \
    -v $(pwd)/config/config.yaml:/app/config/config.yaml \
    code-sandbox:x86_64

如果您的宿主机支持 gVisor，请使用 --runtime=runsc 启动容器以获得更强的隔离性：

docker run -d -p 8000:8000 --runtime=runsc manus-sandbox:x86_64

用于验证服务是否正常运行。

• 方法: GET
• 路径: /health
• 响应: {"status": "ok", "message": "Sandbox is healthy"}

用于提交代码并获取执行结果。

• 方法: POST
• 路径: /v1/sandbox/run
• 请求体:

• 响应体:

{
  "code": 0,
  "message": "success",
  "data": {
    "stdout": "Processing user: Manus", // 包含标准输出和执行结果
    "error": ""                       // 错误详情（如安全拦截或运行时异常）
  }
}

项目内置了全面的安全测试套件 (tests/)，覆盖了 AST 检查、Builtins 限制、API 功能和多版本执行。

# 在项目根目录执行
PYTHONPATH=. pytest tests/