comp-work/gke-sandboxes
运维与部署在自有 GKE 上为云 Agent 运行隔离的 Linux 沙盒,支持快照休眠与唤醒。
项目介绍
gke-sandboxes 让每个云 Agent 在你自己的 Google Cloud 项目里拥有独立 Linux 沙盒。沙盒可以执行命令、保留文件,空闲时休眠,稍后用同一 ID 唤醒并从快照恢复文件。隔离依靠每个沙盒独立的 gVisor Pod,入站流量被阻断,沙盒也拿不到你的云凭据。目标用户是已经在运营 GKE、想替代托管沙盒服务的团队;README 给出的对比中,2 vCPU / 4 GB 托管方案按 16.6¢/小时计价,而本项目估算为 1.9¢/小时。
客户端以 TypeScript 发布为 @getenergy/gke-sandboxes,支持 Node.js 22+ 或 Bun。沙盒镜像只要带 POSIX shell 即可。
部署
部署通过面向编码 Agent 的技能完成。把下面这段指令粘贴到 Claude Code、Cursor、Codex 或类似 Agent 中:
Set up gke-sandboxes in my Google Cloud project. Follow these instructions step by step:
https://raw.githubusercontent.com/comp-work/gke-sandboxes/main/skills/setup-gke-sandboxes/SKILL.md
Agent 会用 Terraform 部署集群、运行校验器,并说明如何接入后端。也提供手动部署指南。
后端接入
部署完成后安装客户端:
npm install @getenergy/gke-sandboxes
创建指向集群的客户端,按 ID 获取沙盒并执行命令:
import { GkeSandboxes, KubernetesApi } from '@getenergy/gke-sandboxes';
const sandboxes = new GkeSandboxes(new KubernetesApi(clusterUrl, getGoogleAccessToken), {
namespace: 'sandboxes',
serviceAccount: 'sandbox',
image: 'docker.io/library/debian:bookworm-slim',
});
const { sandbox } = await sandboxes.acquire('session-42', AbortSignal.timeout(300_000));
const { exitCode, result } = await sandbox.process.executeCommand('echo hello');
await sandboxes.sleep(sandbox.id);
这里的 clusterUrl 和 getGoogleAccessToken 是集群地址和取 token 函数的占位符。调用返回一个运行中的沙盒,或从快照唤醒已有沙盒。客户端指南进一步说明了命令执行、文件上传下载、回调和预览链接。
使用约束
休眠只保留文件,保存为 Cloud Storage 快照,不保留运行中的进程;这与 E2B 等能保留内存的托管服务不同。清扫器会在五分钟无操作后让沙盒休眠,内存保护会在失控程序拖垮沙盒前将其终止。保留两个预热沙盒时启动约 0.5 秒,没有预热池时约 2.7 秒;约 25,000 个文件时唤醒约需 6.5 秒。1.9¢/小时的估算对应大集群:520 个唤醒沙盒分摊在多台机器上,并计入备用机器、磁盘、系统节点和快照存储;小集群仍需承担最低机器成本,所以低规模下这个单价并不成立。集群的容量、升级等运维仍由你负责。仓库采用 Apache-2.0 许可。
HotRepo 点评
在 2026-11-19 的 HotRepo 新项目榜记录中,gke-sandboxes 在约 1.5 小时的观察窗口内新增 11 Star、11 Fork,累计 112 Star。这是新项目榜上的早期活跃度,并不代表 GitHub 全语言日榜名次。其成本卖点需要结合规模看:README 自己说明 1.9¢/小时要约 520 个唤醒沙盒才成立,打算与 Daytona、E2B 比较的读者应先算清自己集群的最低成本。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。