简介
August 11, 2026 · View on GitHub
sandbox connect(别名 cn)连接到一个已有的沙箱终端。当终端会话结束时,沙箱继续运行。
格式
qshell sandbox connect <sandboxID> [--user <user>] [--retry-max <N>]
qshell sbx cn <sandboxID> [--user <user>] [--retry-max <N>]
帮助文档
$ qshell sandbox connect -h
$ qshell sandbox connect --doc
鉴权
需要配置 QINIU_API_KEY 或 E2B_API_KEY 环境变量。
参数
sandboxID:沙箱 ID(必填)--user/-u:终端运行的用户;未指定时使用沙箱默认用户(user)--retry-max:连接请求的最大自动重试次数;0禁用重试。未传入时优先读取SANDBOX_RETRY_MAX,未设置则默认重试 5 次
示例
$ qshell sandbox connect sb-xxxxxxxxxxxx
$ qshell sbx cn sb-xxxxxxxxxxxx
以 root 用户身份连接终端:
$ qshell sandbox connect sb-xxxxxxxxxxxx -u root
$ qshell sbx cn sb-xxxxxxxxxxxx --user root
禁用连接请求自动重试:
$ qshell sandbox connect sb-xxxxxxxxxxxx --retry-max 0