| 说明 | 将沙箱快照保存为模板 |
| 用法 | sbx template save SANDBOX TAG [flags] |
描述
把沙箱快照保存为本地镜像仓库中的模板。 从保存的模板创建沙箱时，请使用 --pull never。
创建该沙箱所用的镜像必须仍在本地镜像仓库中。如果已被移除，请先恢复它， 例如使用 sbx template load。
使用 --output 可以导出一个 tar 文件，以便在另一台主机上用 sbx template load 加载。
使用 --cloud： 把正在运行的云端沙箱快照为云端托管的模板。对于 Kit 规模的镜像，快照可能 需要几分钟；该命令会轮询直到完成。使用 --description 可以为保存的模板附加 一段自由格式的描述。
--capture-mode 控制捕获哪些内容："disk"（默认）从文件系统冷启动；"all" 会捕获 内存、磁盘和 microVM 检查点，因此后续运行可在亚秒级恢复，代价是加载更慢。
云端快照通常会生成数 GB 的模板，并需要几分钟才能完成。快照/加载模型参见 https://docs.docker.com/ai/sandboxes/。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--capture-mode | disk | 该模板捕获的内容。"disk"（默认）只捕获文件系统——从标准 OCI 镜像冷启动，加载更快。"all" 捕获内存、磁盘和 microVM 检查点——恢复时间在亚秒级，加载更慢。仅在配合 --cloud 时生效。 |
--description | 模板的说明（仅云端） | |
-o, --output | 同时将镜像导出为 tar 文件 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
# 保存为模板，供本主机上的新沙箱使用
sbx template save my-sandbox myimage:v1.0
# 从已保存的模板创建沙箱
sbx run --pull never -t myimage:v1.0 claude ./project
# 同时导出为可分享的 tar 文件
sbx template save my-sandbox myimage:v1.0 --output /tmp/myimage.tar
# 云端：将正在运行的云端沙箱快照为云端托管的模板
sbx --cloud template save sbx_abc123 my-snap
# 云端：为保存的模板附加说明
sbx --cloud template save sbx_abc123 my-snap --description "nightly build"
# 云端：捕获内存、磁盘和 microVM 检查点，以亚秒级恢复
sbx --cloud template save sbx_abc123 my-snap --capture-mode all参见
sbx template— 管理沙箱模板