单机部署也能加速?SPACE Base Snapshots快照恢复+节点预热池快速上手指南
单机部署也能加速?SPACE Base Snapshots快照恢复+节点预热池快速上手指南
🚀 SPACE(Sandboxed Platform for Agentic Code Execution)是一个为 Agent 与用户代码提供可插拔运行时隔离沙箱的开源平台。本文介绍它的两大加速神器——Base Snapshots 快照恢复与节点预热池(warm pool):前者把沙箱的内存和 VM 状态存下来,新沙箱直接从快照恢复而不是从头启动;后者在单节点上提前备好一批"随时可用"的沙箱,让创建耗时几乎降为零。即使你只有单机部署,也能轻松享受这套加速方案。
一、为什么沙箱创建慢?两种加速方案对比
冷启动一个沙箱(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 和预热池来测创建耗时,缺什么就跳过哪种模式:
- 基准脚本:bench-sbx-lifecycle.sh
- 基准说明与更多压测工具:scripts/benchmarks/
对比 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 设计文档。
七、常见问题速查
| 问题 | 排查方向 |
|---|---|
| 创建后感觉还是冷启动 | 看输出里的 Boot mode: 一行,确认实际走的模式 |
| 发布新模板后快照"失效" | 快照绑定单一 release,新版本需重新确认 BASE SNAP 状态 |
pool 模式没有命中池子 |
池子为空或未从快照填充;检查 pool-status 输出 |
| K8s 部署里创建仍走冷启动 | 检查预热池的 release 是否最新、vCPU/内存规格是否一致,详见 warm-pools.md 排查清单 |
八、小结
- 快照恢复是单机加速的第一步:一条
space-tmplmgr base-snapshot命令即可开启; - 节点预热池让热门模板的沙箱常驻就绪,创建近乎零延迟;
- 两者都有自动降级兜底:池子没货、快照缺失时静默回落冷启动,业务不会失败;
- 用自带基准脚本量化提速效果,再按场景决定池子大小。
按这份指南操作,单机上的 SPACE 沙箱创建也能从"秒级"迈入"亚秒级"。✨

