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

    • 什么是 K8E?
    • 快速开始
    • 沙箱运行时配置
    • Sandbox CLI
    • 沙箱范例 —— 由你的 AI Agent 驱动
    • 使用官方 E2B SDK 操作沙箱
    • DeepSeek Harness + k8e-sandbox 接入指南(分步)
    • 架构
    • 组件
    • 高级安装
    • K8E 对比其他沙箱平台
    • 参与贡献
  • 操作指南

    • 操作指南 (Guides)
    • 部署标准集群
    • 使用kubekey一键部署k8e
    • 内置Nerdctl工具
    • 离线环境下快速部署k8e
    • 默认支持10年有效证书
    • k8e集群备份与恢复
    • k8s安装配置Flannel的方案
    • 使用kube-vip实现集群VIP访问
    • 怎么清理K8E集群
    • 备份和恢复
    • 自定义pause镜像

沙箱运行时配置

K8E 自动检测已安装的运行时并注册对应的 RuntimeClass。根据你的隔离需求选择:

运行时隔离方式要求启动时间
gVisor系统调用拦截(用户态内核)无~10ms
Kata Containers虚拟机后端(QEMU)嵌套虚拟化或裸机~500ms
Firecracker硬件微虚拟机(KVM)/dev/kvm~125ms

gVisor —— 推荐默认

# 官方 “Latest release” 包:https://gvisor.dev/docs/user_guide/install/#latest-release
# 2026-07 起改为多文件布局,不再单独发布 runsc 二进制。
ARCH=$(uname -m)   # x86_64 最常见,ARM 为 aarch64
URL=https://storage.googleapis.com/gvisor/releases/release/latest/${ARCH}

wget ${URL}/gvisor.tar.zstd ${URL}/gvisor.tar.zstd.sha512

sha512sum -c gvisor.tar.zstd.sha512   # 必须输出 OK
sudo tar --zstd -xf gvisor.tar.zstd -C /usr/local/bin
ls -l /usr/local/bin/runsc /usr/local/bin/containerd-shim-runsc-v1 /usr/local/bin/gvisor-bin   # 确认已安装

主机没有 zstd?同一目录提供了 gvisor.tar.bz2,可改用 sudo tar -xjf gvisor.tar.bz2 -C /usr/local/bin。

压缩包含 runsc、containerd-shim-runsc-v1 shim 以及 gvisor-bin/ 侧车二进制目录(runsc 在自身二进制旁边查找)。请整体解压、保持文件在一起 —— 不要单独移动 runsc。

不要运行 runsc install —— K8E 管理自己的 containerd 配置(/var/lib/k8e/agent/etc/containerd/config.toml),启动时自动注入 gVisor 配置。

Kata Containers

bash -c "$(curl -fsSL https://raw.githubusercontent.com/kata-containers/kata-containers/main/utils/kata-manager.sh) install-packages"
kata-runtime check

Firecracker(需要 /dev/kvm)

ls /dev/kvm   # 验证 KVM 可用

# 安装 firecracker-containerd shim + devmapper snapshotter
# 参见: https://github.com/firecracker-microvm/firecracker-containerd
mkdir -p /var/lib/firecracker-containerd/runtime
# 将 hello-vmlinux.bin 和 default-rootfs.img 放到这里

应用变更

在启动 K8E 之前安装运行时,即可零重启配置。如果 K8E 已在运行,安装新的运行时 shim 后重启:

systemctl restart k8e
kubectl get runtimeclass
# NAME          HANDLER       AGE
# gvisor        runsc         10s
# kata          kata-qemu     10s
# firecracker   firecracker   10s   ← 仅当存在 /dev/kvm 时
最近更新: 2026/10/24 04:45
Prev
快速开始
Next
Sandbox CLI