K8EK8E
首页
  • 什么是 K8E
  • 快速开始
  • 沙箱运行时配置
  • Sandbox CLI
  • 沙箱范例
  • E2B SDK 沙箱
  • DeepSeek Harness 接入
  • 架构
  • 组件
  • 高级安装
  • K8E 对比其他方案
  • 参与贡献
更新日志
  • English
  • 简体中文
GitHub
首页
  • 什么是 K8E
  • 快速开始
  • 沙箱运行时配置
  • Sandbox CLI
  • 沙箱范例
  • E2B SDK 沙箱
  • DeepSeek Harness 接入
  • 架构
  • 组件
  • 高级安装
  • K8E 对比其他方案
  • 参与贡献
更新日志
  • English
  • 简体中文
GitHub

开源 · CNCF 兼容 · Apache 2.0

让 AI Agent 在隔离沙箱中
安全执行任意代码

一个集群。多个 Agent。彼此零信任。 K8E 是打包为单个二进制、体积小于 100MB 的 Kubernetes 发行版,内置一等公民的沙箱原语——gVisor、Kata 或 Firecracker,从暖池获取会话的延迟低于 500ms。

安装 K8E查看 GitHub ↗ 阅读文档 →

已经在用官方 SDK? 把未经修改的 e2b 客户端指向 K8E ↗

  • 单文件 < 100 MB
  • CNCF 兼容
  • Apache 2.0
  • 支持离线部署
运行中sandbox-matrix · 网关 :50051
  1. 01 / 获取暖池亚 500ms 获取 gVisor pod
  2. 02 / 执行run "print(1)"经 gRPC + mTLS 流式返回
  3. 03 / 快照sha256 · zstd内容寻址,可增量恢复
状态可恢复销毁会话即释放资源,Agent 之间互不泄漏。
<100MB单个二进制CNCF 兼容的 Kubernetes
60s启动一个集群只需一条 curl 命令
<500ms暖池获取会话没有冷启动惩罚
3隔离运行时gVisor · Kata · Firecracker

正在发生的转变

Agent 负责写代码,但运行它仍然需要一套系统。

Agent 越强,沙箱越重要,而不是越不重要。

  1. 01单次提示→长时间自主运行
  2. 02单个 Agent→多个 Agent 共用一个集群
  3. 03生成的代码→真正被执行的代码
  4. 04信任本机→租户之间零信任

工作原理

一个入口,万般沙箱

Agent 不直接接触 Kubernetes,只调用一个经过审计的网关;会话生命周期、exec、文件、终端、出网策略与快照,全部由它掌管。

01Agents
k8e-sandbox-cli/k8e-sandbox skille2b SDKs

Agent 面对的是工具,而不是 Kubernetes 对象。

02网关
会话exec文件终端exposeallow-hosts

唯一入口,基于 gRPC + mTLS,全程可审计。

03运行时
gVisorKataFirecracker

按会话选择隔离级别,一切都不出 pod。

状态可恢复

工作区是临时 pod,快照采用内容寻址,随时可恢复。

已交付能力

是沙箱原语,不是 shell 变通

Agent 真正干活所需的一切,都以一等公民操作的形式暴露在同一个二进制里。

  1. 01隔离

    每个会话拥有独立 pod、独立文件系统与内核边界;按会话插拔运行时,默认方案无需 KVM。

    • gVisor
    • Kata
    • Firecracker
  2. 02管控

    按会话的数据路径出网策略,可在运行时自由调整白名单,无需任何代理进程。

    • Cilium
    • eBPF
    • toFQDNs
  3. 03暴露

    Agent 构建的 web 应用能拿到真实 URL,通过网关反向代理进 pod,网络策略自动生效。

    • Gateway API
    • expose
    • URL
  4. 04恢复

    内容寻址的工作区快照,支持增量恢复与服务端 registry。

    • sha256
    • zstd
    • --base

边界归属

你的集群。你的数据。你的模型。

K8E 是你自己运行的基础设施,而不是托管服务。没有向外的控制面,也没有需要解锁的许可证服务器。

控制面KubernetesAPI Server · 调度器 · etcd
网关K8E会话 · 策略 · mTLS
执行面你的节点运行时 · 代码 · 数据

两种用法

自建集群,或沿用现有 SDK

两种入口今天都可用,且都是 Apache 2.0。这里没有路线图式的承诺。

已交付 · 自托管

自己运行这套集群

一个二进制、一条命令,任何 Linux 主机——x86_64、ARM64 或 RISC-V。

  • 单个二进制小于 100 MB,无外部控制面
  • 支持离线与本地化部署
  • 暖池按负载自适应伸缩
安装 K8E

今天即可 · 零代码改动

沿用你现有的 Agent 技术栈

继续使用现有 harness,K8E 只说它已经在说的协议。

  • 官方 e2b Python / JavaScript SDK,零修改
  • Claude Code / Codex / Pi 的 /k8e-sandbox skill
  • 兼容 kubernetes-sigs/agent-sandbox
阅读 E2B 指南
一个二进制无控制面、无许可证服务器、无按会话计费。Apache 2.0 · 自托管 · 自带算力

演进方向 · 非交付承诺

走向 Agent 沙箱矩阵

原语的下一步:让每一个 Agent 工作负载都被提交、隔离、存证并回收,全程无需人工介入。

  1. 01提交

    Agent 申请的是算力,而不是集群。

  2. 02调度

    矩阵将工作负载放到合适的节点上。

  3. 03隔离

    按会话选择运行时边界。

  4. 04执行

    代码在实时、可审计的出网策略下运行。

  5. 05存证

    执行记录与事件流让每次运行可复核。

  6. 06回收

    pod 被销毁,暖池随即补充。

沙箱不是 Agent 平台的一个功能,

它就是平台本身。

安装之前

在自有基础设施上运行 Agent 前,人们常问的问题

01运行 K8E 需要什么条件?

一台 Linux 主机即可——x86_64、ARM64 或 RISC-V,起步约 2 GB 内存。所有组件都在一个二进制里,`curl -sfL https://k8e.sh/install.sh | sh -` 大约 60 秒就能拉起一个 CNCF 兼容集群。

02支持哪些隔离运行时?

默认是 gVisor,无需 KVM,任何环境都能跑;Kata Containers 提供虚拟机级隔离;Firecracker 提供 microVM。运行时可按会话通过 Kubernetes RuntimeClass 插拔切换。

03与 E2B SDK 兼容吗?

兼容。官方 e2b Python / JavaScript SDK 无需修改即可使用——创建沙箱、exec、文件操作、watch 与 pause/resume 都能映射到 K8E 会话上。对多数技术栈而言,只需改两行 endpoint 配置。

04Agent 执行过的代码由谁复核?

每一次 exec 都有记录。`k8e-sandbox-cli log` 可回放窗口化执行记录,`events` 输出守护进程的 NDJSON 事件流,`ps` 展示 pod 内进程拓扑——全部在 CLI 内完成。

05Agent 崩溃或卡住会怎样?

会话就是临时 pod。暖池会补上挂掉的 pod,工作区状态可从内容寻址快照恢复(`snapshot save` / `snapshot restore`,用 `--base` 做增量恢复)。

06真的是免费的吗?

K8E 采用 Apache 2.0 协议且自托管。没有按席位计费、没有 token 计量、也没有许可证服务器——你的基础设施、你的模型、你的数据。

一条命令

拉起你的沙箱矩阵

打包为单个二进制的 CNCF 兼容 Kubernetes 发行版,从第一条命令开始就是隔离的 Agent 执行。

curl -sfL https://k8e.sh/install.sh | sh -

需要一台 Linux 主机(x86_64 / ARM64 / RISC-V)。启动时会自动识别 gVisor。

展开手动四步安装
# 1. install an isolation runtime (gVisor shown)
wget https://storage.googleapis.com/gvisor/releases/release/latest/$(uname -m)/runsc
chmod +x runsc && sudo mv runsc /usr/local/bin/
# 2. install k8e (one binary)
curl -sfL https://k8e.sh/install.sh | sh -
# 3. verify the cluster
export KUBECONFIG=/etc/k8e/k8e.yaml && kubectl get nodes
# 4. connect your agent
k8e-sandbox-cli --endpoint <server-ip>:50051 --apikey <key> connect
阅读快速开始查看源码 ↗ 对比其他方案 →
K8E
K8E开源 Agentic AI 沙箱矩阵
文档架构CLI更新日志GitHub ↗

Copyright © 2021-2026 xiaods · Apache 2.0 · 隐私政策

网站视觉设计参考 Orbi