OpenSandbox CLIosb完全指南命令行管理沙箱的10个实用命令【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandboxOpenSandbox 是一个面向 AI Agent 的安全、快速、可扩展的沙箱运行时Sandbox Runtime而它的命令行工具OpenSandbox CLI命令名为osb就是你在终端里管理沙箱的遥控器创建沙箱、执行命令、读写文件、查看网络策略、收集诊断信息全部一条命令搞定。本文用 10 个最常用的命令带你从零跑通一套完整的 OpenSandbox 沙箱管理工作流无需编写任何 SDK 代码。准备工作三步装好 OpenSandbox CLI一条命令安装 osb在终端里任选一种方式安装推荐uv tool隔离干净uv tool install opensandbox-cli # 或者 pip install opensandbox-cli安装完成后用osb --version验证即可。先启动 OpenSandbox 服务CLI 本身只是客户端它通过 API 与 OpenSandbox Server 通信。本地开发时先启动服务端默认监听http://localhost:8080opensandbox-server快速了解 osb 命令体系敲一下osb --help你会看到 OpenSandbox CLI 的全部命令分组sandbox生命周期管理、command/exec沙箱内执行命令、file文件操作、egress出站网络策略、diagnostics日志与事件诊断、config本地配置、skills为 AI 编程助手安装技能包等。 记忆技巧日常使用只需要记住sandbox、command、file三大主力其余命令用osb 组 --help随时查阅。10 个实用命令从创建沙箱到问题诊断命令一osb config init —— 一次性配置连接信息首次使用先初始化配置文件默认写在~/.opensandbox/config.toml之后每条命令都自动携带连接信息osb config init osb config set connection.domain localhost:8080 osb config set connection.protocol http osb config set connection.api_key 你的API密钥还可以顺手设置默认镜像和超时时间后面的create命令会更短osb config set defaults.image python:3.12 osb config set defaults.timeout 30m命令二osb sandbox create —— 30 秒拉起一个沙箱核心命令来了。指定镜像和存活时间创建一个运行 Python 的沙箱osb sandbox create --image python:3.12 --timeout 30m成功后终端会直接打印沙箱 ID、镜像和状态把 ID 记下来后面的命令都要用它进阶玩法加--env KEYVALUE注入环境变量加--network-policy-file xxx.json限制出站网络加--credential-proxy启用凭据保险箱代理。命令三osb sandbox list —— 表格化查看所有沙箱随时用表格视图掌握全局状态、镜像、创建/过期时间一目了然osb sandbox list # 按状态筛选 osb sandbox list --state running --state paused小技巧exec命令支持输入前缀匹配。如果前缀同时命中多个沙箱CLI 会列出候选项并拒绝执行避免误操作命令四osb sandbox get —— JSON 格式查看沙箱详情调试脚本、CI 流水线里最常用的是结构化输出。-o json让任何命令都变成可编程的osb -o json sandbox list osb sandbox get sandbox-id -o json osb sandbox health sandbox-id -o json命令五osb command run —— 在沙箱内执行任意命令注意用--分隔 osb 参数和沙箱内命令。前台执行会实时流式打印输出也能跑 Python 代码osb command run sandbox-id -o raw -- echo hello world osb command run sandbox-id -o raw -- python -c print(11)两个实用变体加--background后台执行并返回 execution ID随后用osb command status/logs查进度用osb command session create创建持久化 shell 会话会话内环境变量、工作目录都会保留非常适合多步调试。命令六osb file write / cat —— 在本地和沙箱间传文件不登录、不开端口直接在终端里写文件、读文件osb file write sandbox-id /workspace/hello.txt -c hello osb file cat sandbox-id /workspace/hello.txt配合upload本地传上去、download结果取下来、search按*.py通配符搜索、chmod、replace文本替换等子命令构成一套完整的沙箱文件管理工具箱。命令七osb sandbox pause / resume —— 暂停与恢复沙箱长时间任务想省资源暂停它要继续时再恢复。注意 pause 是异步操作返回请求已接受后要轮询状态osb sandbox pause sandbox-id osb sandbox get sandbox-id -o json # 确认状态变为 Paused osb sandbox resume sandbox-id沙箱快到期还能用osb sandbox renew sandbox-id续命。命令八osb sandbox endpoint —— 对外暴露服务端口在沙箱里起一个 Web 服务比如http.server用 endpoint 命令拿到可访问的对外地址osb sandbox endpoint sandbox-id --port 8080 -o json这是让外部浏览器、其他服务、AI Agent访问沙箱内服务的关键一步。命令九osb egress get / patch —— 动态调整出站网络策略OpenSandbox 的卖点是沙箱级网络隔离。运行中也可以实时查看和修改出站规则osb egress get sandbox-id -o json osb egress patch sandbox-id --rule allowpypi.org --rule denyinternal.example.com改完规则直接用一条命令验证连通性osb command run sandbox-id -o raw -- curl -I https://pypi.org命令十osb diagnostics —— 沙箱出问题先查这里沙箱启动失败、命令异常先用稳定版诊断命令抓日志和事件osb diagnostics logs sandbox-id --scope container -o raw osb diagnostics events sandbox-id --scope runtime -o raw--scope是必填参数logs 支持container/allevents 支持runtime/all。如果还需要容器、资源、网络、端口的全景摘要可以试试实验性的osb devops summary sandbox-id它会输出一份完整的 SANDBOX DIAGNOSTICS SUMMARY 报告进阶玩法让 AI 编程助手学会操作沙箱这是 osb 最魔法的功能之一内置了 5 个技能包sandbox-lifecycle、command-execution、file-operations、network-egress、sandbox-troubleshooting一条命令安装到 Claude、Cursor、Codex、Copilot 等工具中AI 助手就能直接帮你管理 OpenSandbox 沙箱osb skills list osb skills install --all-builtins --target claude --scope project常见问题速查问题解决命令 / 思路连不上服务端确认opensandbox-server已启动核对osb config show中的 domain 与 api_key想换一套配置全局加osb --config /tmp/dev.toml ...指定其他配置文件输出格式不支持并非所有命令都支持所有格式--help查看当前命令支持的-o选项前缀匹配到多个沙箱使用更长的 ID 前缀或直接用完整沙箱 ID 更多命令细节可以查阅仓库中的 cli/README.md命令实现位于 cli/src/opensandbox_cli/commands/ 目录每个命令组对应一个模块文件方便按需深读。总结一张表记住 10 个核心命令命令用途osb config init初始化连接配置osb sandbox create创建沙箱osb sandbox list表格查看所有沙箱osb sandbox get -o jsonJSON 查看详情osb command run -- cmd沙箱内执行命令osb file write / cat读写沙箱文件osb sandbox pause / resume暂停 / 恢复osb sandbox endpoint暴露服务端口osb egress get / patch管理出站网络策略osb diagnostics logs / events日志与事件诊断从osb config init到osb sandbox create再到执行命令、管理文件、诊断排障——OpenSandbox CLI 把沙箱运营的日常全部搬进了终端。现在就打开终端敲下第一条osb --version开始你的第一个沙箱工作流吧 【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考