kubernetes-sigs/agent-sandbox

这是什么？

核心功能

• 01Sandbox CRD 提供一个具有稳定主机名和网络标识的有状态 Pod。
• 02持久化存储可在 Pod 重启后保留数据。
• 03生命周期管理涵盖创建、定时删除、暂停和恢复。
• 04SandboxWarmPool 维护预热沙箱，便于快速分配。
• 05SandboxClaim 可从池中申请沙箱，无需管理完整配置。
• 06通过 RuntimeClass 支持 gVisor 和 Kata Containers 等隔离运行时。
• 07提供 Go 和 Python SDK。

适用场景

• 为 AI 智能体提供隔离环境，执行 LLM 生成的或不可信的代码。
• 为强化学习和评测循环提供快速启动的沙箱。
• 托管持久化的云端开发环境或 Jupyter 类会话。
• 运行需要稳定身份的单实例服务，避免 StatefulSet 的额外开销。

快速上手

1. 1

   使用 kubectl 安装核心组件和扩展（最新版本）

   kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml
2. 2

   验证 Sandbox CRD 已安装

   kubectl get crd sandboxes.agents.x-k8s.io
3. 3

   使用你的容器镜像应用 Sandbox 清单

使用前须知

• !需要已安装 agent-sandbox 控制器的 Kubernetes 集群。
• !沙箱隔离依赖于 gVisor 或 Kata Containers 等独立的运行时。

收录于专题

标签

常见问题

agent-sandbox 是什么？

一个 Kubernetes 控制器与 CRD，用于管理隔离、有状态的单 Pod 沙箱，面向 AI 智能体运行时和强化学习场景。 agent-sandbox 为 Kubernetes 增加了 Sandbox 自定义资源和控制器，用于运行长期存活的单容器工作负载，提供稳定的主机名、网络标识和可选的持久化存储。它填补了 Deployment（无状态、可副本化）与 StatefulSet（编号的有状态 Pod 集合）之间的空缺，适合需要稳定身份但不想承担 StatefulSet 开销的场景。

agent-sandbox 可以免费使用吗？用的什么许可证？

agent-sandbox 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

agent-sandbox 还在维护吗？

活跃维护中。agent-sandbox 最近一次提交是在 2026年11月6日。

agent-sandbox 适合用来做什么？

为 AI 智能体提供隔离环境，执行 LLM 生成的或不可信的代码。 为强化学习和评测循环提供快速启动的沙箱。 托管持久化的云端开发环境或 Jupyter 类会话。 运行需要稳定身份的单实例服务，避免 StatefulSet 的额外开销。

agent-sandbox 怎么安装和运行？

使用 kubectl 安装核心组件和扩展（最新版本）: kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml 验证 Sandbox CRD 已安装: kubectl get crd sandboxes.agents.x-k8s.io 使用你的容器镜像应用 Sandbox 清单

在哪里获取 agent-sandbox？

源代码和安装说明在 GitHub 上：https://github.com/kubernetes-sigs/agent-sandbox