单机部署也能加速?SPACE Base Snapshots快照恢复+节点预热池快速上手指南

原创2026-10-18 17:54:081,376 阅读

单机部署也能加速?SPACE Base Snapshots快照恢复+节点预热池快速上手指南

🚀 SPACE(Sandboxed Platform for Agentic Code Execution)是一个为 Agent 与用户代码提供可插拔运行时隔离沙箱的开源平台。本文介绍它的两大加速神器——Base Snapshots 快照恢复与节点预热池(warm pool):前者把沙箱的内存和 VM 状态存下来,新沙箱直接从快照恢复而不是从头启动;后者在单节点上提前备好一批"随时可用"的沙箱,让创建耗时几乎降为零。即使你只有单机部署,也能轻松享受这套加速方案。

SPACE 快照恢复与预热池所在的参考部署架构总览图

一、为什么沙箱创建慢?两种加速方案对比

冷启动一个沙箱(cold 模式)需要完整走一遍:拉起 microVM、加载内核、启动客户机系统——整个过程可能要数秒。对 AI Agent 这种高频创建/销毁沙箱的场景来说,这段延迟会被放大得很明显。

SPACE 提供两级加速:

加速手段 原理 适用场景
Base Snapshots(基础快照) 把已启动模板的内存与 VM 状态保存下来,新沙箱直接恢复快照 单机直接运行 node manager 的部署
节点预热池(node warm pool) 基于快照提前建好一批就绪沙箱,创建时直接"领"一个 单机部署的可选进阶
K8s Warm Pool(控制面预热池) 由集群控制面维护的就绪沙箱池 Kubernetes 部署(如本地 Kind 集群)

⚠️ 注意区分:单机直接跑 node manager 时,用本文的 Base snapshots;如果你用的是 Kubernetes 部署,节点上的本地配置会被控制面覆盖,应改用 Warm pools 指南。

二、环境准备:先部署好你的 SPACE

在跑快照命令之前,需要先在单节点上完成 SPACE 的安装(二进制会放在 /space/bin)。完整的本地部署流程(含 Kind 集群方案)参见 安装与本地配置指南,创建第一个沙箱的入门示例见 Your first sandbox 与示例脚本 first_sandbox.py。

三、Base Snapshots 快照恢复快速上手

步骤 1:创建基础快照

在 worker 节点上执行(--state true 表示开启快照):

sudo /space/bin/space-tmplmgr base-snapshot --template my-template --state true
sudo /space/bin/space-tmplmgr list

当 space-tmplmgr list 输出中该模板的 BASE SNAP 列显示 on,快照就准备就绪了。

💡 小贴士:快照绑定的是某一个模板 release(版本)。每次发布新的模板 release 后,记得重新确认快照状态。

删除快照则执行同一命令并将状态改为 false:

sudo /space/bin/space-tmplmgr base-snapshot --template my-template --state false

步骤 2:用快照启动沙箱

创建沙箱时通过 --boot-mode 选择启动方式:

sudo /space/bin/space-sbxmgr create --runtime fc --template my-template \
  --boot-mode base-snapshot --blocking

三种启动模式的行为对比:

--boot-mode 取值 行为
cold(默认) 完整冷启动
base-snapshot 从基础快照恢复
pool 优先使用预热池中就绪的沙箱,没有则退回快照恢复

创建请求指定的资源如果不可用,SPACE 会静默降级(一路回落到冷启动)而不会报错。输出中的 Boot mode: 一行会告诉你实际走的是哪条路径,排查加速是否生效时看一眼即可。

四、节点预热池:让沙箱"秒开"

快照恢复已经很快,但如果你希望创建零等待,可以在单节点上再建一个小预热池,让它从快照自动填充:

# 先确保 base snapshot 已创建,预热池会从快照填充
sudo /space/bin/space-tmplmgr create-pool --template my-template --boot-mode snapshot --count 5
sudo /space/bin/space-tmplmgr pool-status --template my-template

之后用 pool 模式创建沙箱,系统会直接领用池中就绪的沙箱:

sudo /space/bin/space-sbxmgr create --runtime fc --template my-template \
  --boot-mode pool --blocking

需要移除预热池时:

sudo /space/bin/space-tmplmgr delete-pool --template my-template

📌 单机场景建议池子不要开太大,5 个左右就够日常突发用了,避免占用过多内存。

五、验证加速效果:跑一下基准测试

仓库自带了生命周期基准脚本,它会自动找到模板的 base snapshot 和预热池来测创建耗时,缺什么就跳过哪种模式:

对比 cold 与 base-snapshot / pool 三种模式的耗时,就能直观看到加速收益。

六、进阶:Kubernetes 部署的预热池

如果你后续把 SPACE 迁到 Kubernetes(例如本地 Kind 集群),预热池由控制面统一管理:

  • 可用 space-admin-cli warm-pool create 一键创建,指定模板、vCPU、内存与 --target-ready-slots(保持就绪的沙箱数);
  • 在 UI 的 Templates → Template Releases → Create Pool 也能图形化配置;
  • 频繁发布新模板版本时,推荐用 Rolling Warm Pool Policies(滚动预热池策略),自动让最新 release 保持预热、旧版本自动排水;
  • 预热池配置存在控制面 PostgreSQL 的 kubernetes_pool_configs 表中,建议通过 UI、CLI 或 Admin API 管理而非直接写 SQL。

完整操作步骤见 Warm pools 指南,设计原理(slots、claims、controller 与滚动策略)见 warm-pools 设计文档。

SPACE 控制面中 Sandbox Pod 视图与集群控制器、预热池协调器的缓存数据流架构

七、常见问题速查

问题 排查方向
创建后感觉还是冷启动 看输出里的 Boot mode: 一行,确认实际走的模式
发布新模板后快照"失效" 快照绑定单一 release,新版本需重新确认 BASE SNAP 状态
pool 模式没有命中池子 池子为空或未从快照填充;检查 pool-status 输出
K8s 部署里创建仍走冷启动 检查预热池的 release 是否最新、vCPU/内存规格是否一致,详见 warm-pools.md 排查清单

八、小结

  • 快照恢复是单机加速的第一步:一条 space-tmplmgr base-snapshot 命令即可开启;
  • 节点预热池让热门模板的沙箱常驻就绪,创建近乎零延迟;
  • 两者都有自动降级兜底:池子没货、快照缺失时静默回落冷启动,业务不会失败;
  • 用自带基准脚本量化提速效果,再按场景决定池子大小。

按这份指南操作,单机上的 SPACE 沙箱创建也能从"秒级"迈入"亚秒级"。✨

登录后查看全文
SPACE