Skip to content
说明停止一个或多个沙箱,但不删除它们
用法sbx stop SANDBOX... [flags]

描述 ​

停止一个或多个正在运行的沙箱,但不删除它们。或者——使用 --cloud——指定云端沙箱的 ID(sbx_*)或 "sbx --cloud ls" 中显示的名称。

已停止的沙箱会保留其状态,可以用 "sbx run" 重新启动。

使用 --cloud 时,stop 会就地挂起每个沙箱:其完整状态(内存 + 磁盘)得以保留,主机资源被释放,沙箱 ID 保持不变。stop 在请求被接受后即返回。用 "sbx --cloud ls" 观察沙箱进入已停止状态。

用 "sbx --cloud attach SANDBOX" 可以用相同的 ID 重新启动它,也可以用 "sbx --cloud run AGENT --name NAME"(还可以加上 --detach 以非交互方式运行),或者再次运行它的智能体并从提示中选择它。

stop 不会创建模板,也不会删除沙箱。如果想从正在运行的沙箱中获取可长期保存、可分享的模板,请改用 "sbx --cloud template save SANDBOX TAG"(该命令会让沙箱保持运行)。

选项 ​

选项默认值说明
--format输出格式:table、json 或 yaml
--json以 JSON 格式输出

全局选项 ​

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

示例 ​

console
sbx stop my-sandbox

# 一次停止多个沙箱
sbx stop one two

参见 ​

  • sbx — 管理 AI 编程智能体沙箱。