OpenShell 沙箱技能

基于 NVIDIA OpenShell 为专业代理（specialist agents）提供的安全执行环境。

概述

OpenShell 提供受沙箱隔离的容器，集成 Landlock LSM、seccomp、网络命名空间及 L7 策略引擎。每个专业代理均获得独立沙箱，以保障代码执行的安全性。

可用沙箱

CLI 参考

# 列出所有沙箱
openshell sandbox list

# 在沙箱中执行命令
openshell sandbox exec -n  --  [args...]

# 启动交互式 Shell
openshell sandbox connect -n 

# 创建新沙箱
openshell sandbox create --name 

# 删除沙箱
openshell sandbox delete 

# 查看日志
openshell logs -n 

# 网关状态
openshell status

# 问题诊断
openshell doctor check

代理集成

针对 Coder 代理

当执行可能影响宿主机系统的代码时：

# 不要在本地运行：
python3 script.py

# 应在沙箱中运行：
openshell sandbox exec -n coder-sandbox -- python3 /workspace/script.py

针对 Security 代理

当运行安全工具或扫描任务时：

# 在隔离沙箱中运行 nmap、nikto 等工具
openshell sandbox exec -n security-sandbox -- nmap -sV target

针对 Debug 代理

当复现缺陷或验证修复方案时：

openshell sandbox exec -n debug-sandbox -- node test.js

针对 QA-Tester

当运行测试套件时：

openshell sandbox exec -n test-sandbox -- pytest tests/

文件传输

在宿主机与沙箱之间复制文件：

# 将文件复制 INTO 沙箱（通过 exec + cat 实现）
cat local_file.py | openshell sandbox exec -n coder-sandbox -- tee /workspace/local_file.py

# 将文件复制 FROM 沙箱
openshell sandbox exec -n coder-sandbox -- cat /workspace/result.txt > local_result.txt

策略

默认策略启用 L7 网络限制。查看或修改策略请使用：

openshell policy list

资源限制

• CPU：与宿主机共享（24GB RAM 服务器）
• 网络：受 L7 策略限制（默认禁止出站连接）
• 磁盘：临时存储（随沙箱删除而清除）
• 超时：每次 exec 命令默认时限为 30 分钟

故障排查

• 找不到沙箱：运行 openshell sandbox list 检查当前状态
• 网关宕机：运行 openshell status 和 openshell doctor check
• 权限被拒绝：沙箱以内置非特权用户身份运行
• 网络被阻断：默认策略禁止出站流量；可使用 openshell policy 修改策略

架构

宿主机（Ubuntu ARM64）
  └── OpenShell 网关（Docker + k3s）
       ├── coder-sandbox（aarch64，Python 3.13，Node 22）
       ├── security-sandbox（aarch64）
       ├── debug-sandbox（aarch64）
       └── test-sandbox（aarch64）

版本

• OpenShell CLI：0.0.35
• 基础镜像：ghcr.io/nvidia/openshell-community/sandboxes/base:latest
• 平台：aarch64（ARM64）