搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

comp-work/gke-sandboxes

运维与部署

在自有 GKE 上为云 Agent 运行隔离的 Linux 沙盒,支持快照休眠与唤醒。

122
12
TypeScript
Apache-2.0
创建于 1 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. google/gvisor为用户态 Linux 内核与 OCI 运行时,让运行不可信代码的容器不再与宿主机共享内核。Go19,791
  2. agent-substrate/substrate在 Kubernetes 上以高密度运行不受信任的 AI Agent,并提供隔离沙箱与快照恢复能力的运行时。Go5,768