| 说明 | 管理已存储的密钥 |
| 用法 | sbx secret COMMAND |
描述
管理沙箱环境使用的已存储密钥。
服务密钥（例如 "github"、"anthropic"、"openai"） 沙箱启动时，代理会使用已存储的密钥代表智能体对 API 请求进行认证。密钥本身绝不会被直接暴露。作用域可以是全局的（所有沙箱共享），也可以限定到特定沙箱。
镜像仓库密钥（例如 "ghcr.io"、"myregistry.azurecr.io"） 用于在创建沙箱之前拉取私有模板镜像和 Kit 制品。与服务密钥不同，镜像仓库凭据默认仅在主机上使用。除非设置 --all-sandboxes 或 --sandbox，否则不会注入沙箱（凭据绝不会进入沙箱文件系统）。使用 "sbx secret set --registry <host> --password-stdin" 存储它们。
子命令
| 命令 | 说明 |
|---|---|
sbx secret import | 导入在主机环境变量中检测到的密钥 |
sbx secret ls | 列出已存储的密钥 |
sbx secret rm | 删除密钥 |
sbx secret set | 创建或更新密钥 |
sbx secret set-custom | 创建或更新自定义密钥 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
参见
sbx— 管理 AI 编程智能体沙箱。sbx secret import— 导入在主机环境变量中检测到的密钥sbx secret ls— 列出已存储的密钥sbx secret rm— 删除密钥sbx secret set— 创建或更新密钥sbx secret set-custom— （实验性）创建或更新自定义密钥