Docker Sandboxes
说明从 tar 文件把镜像加载到沙箱运行时
用法sbx template load FILE [flags]

描述 ​

从 tar 文件把镜像加载到沙箱运行时的镜像存储中。

加载后的镜像可以用作新沙箱的模板。 tar 文件通常通过以下命令创建：sbx template save SANDBOX TAG --output FILE

使用 --cloud 时： 把 tar 文件上传为云端模板。接受 FILE 和 NAME 两个参数；NAME 在每个账号内必须唯一。上传可能需要几分钟。

必须指定 --cpus 和 --memory-mib，且需对应某个可计费的沙箱规格：

  • micro（1 vCPU / 2048 MiB）
  • small（2 vCPU / 4096 MiB）
  • medium（4 vCPU / 8192 MiB）
  • large（8 vCPU / 16384 MiB）
  • xl（16 vCPU / 32768 MiB）

使用 --capture-mode disk 捕获文件系统快照，或使用 all 同时捕获内存、磁盘和 microVM 检查点，以加快恢复速度。

选项 ​

选项默认值说明
--capture-modedisk该模板要捕获的内容。disk（默认）仅捕获文件系统 —— 从标准 OCI 镜像冷启动，加载更快。all 捕获内存 + 磁盘 + microVM 检查点 —— 恢复时 TTI 可做到亚秒级，但加载更慢。仅在使用 --cloud 时生效。
--cpus0vCPU 数量；需与 --memory-mib 一起指定某个可计费的规格（使用 --cloud 时必填）
--description可选的模板描述（仅 --cloud）
--memory-mib0内存（单位 MiB）；--cpus/--memory-mib 需指定某个可计费的规格：micro（1 vCPU / 2048 MiB）、small（2 vCPU / 4096 MiB）、medium（4 vCPU / 8192 MiB）、large（8 vCPU / 16384 MiB）、xl（16 vCPU / 32768 MiB）（使用 --cloud 时必填）

全局选项 ​

选项默认值说明
--cloud改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表）
-D, --debug启用调试日志
--no-input从不提示；需要应答的命令会直接失败，并给出应当运行的命令

示例 ​

console
# 从 tar 文件加载镜像
sbx template load /tmp/myimage.tar              # Linux/macOS
sbx template load C:\Users\me\myimage.tar       # Windows

# 使用加载后的镜像作为模板
sbx run --pull never -t myimage:v1.0 claude

# 云端：把 tar 上传为云端托管的模板（捕获磁盘，加载更快）
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096

# 云端：捕获内存 + 磁盘 + microVM 检查点，实现亚秒级恢复
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096 --capture-mode all

# 云端：附带描述信息
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096 --description "Nightly baseline"

参见 ​