这篇是一份可以直接照着敲的教程。是阿里云百炼在 2026 年 8 月 26 日上线的 Sandbox一台云端沙箱实例独立文件系统、可控出网、能休眠能释放用bl sandbox这一组十五条命令管理。全文的命令、参数、返回字段都经过逐条核对读数来自我自己开的六台实例。先给三个最容易踩的前提避免你照着抄到一半卡住地域只有 cn-beijing 一个镜像仓库fc-e2b-registry.cn-beijing.cr.aliyuncs.com和实例域名都在境内不需要代理。首次使用要在控制台完成服务关联角色授权角色名AliyunServiceRoleForSFMSandbox弹窗出现在第一次创建模版的时候不是创建实例的时候。创建实例时务必显式传--instance-timeout。不传的话请求体里没有 timeout 字段服务端按 604800 秒也就是七天处理而这个产品按小时计费。一、安装与身份确认npminstall-gbailian-cli bl skill init bl auth login --api-key sk-你的keyAPI Key 在控制台签发地域选华北 2北京。装好后先确认身份和配置bl config show bl--version我这边 CLI 版本是 2.1.0。bl config show会显示当前 profile 和 base_url注意不要把输出里的 key 贴到任何公开场合CLI 默认是打码显示的保持这个习惯。二、看镜像一条不需要鉴权的命令bl sandbox official-images返回三个内置镜像code-interpreter (代码解释器) fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/code-interpreter-v1:v0.0.44 browser (浏览器) fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/browser:v0.0.44 all-in-one (全能型) fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/all-in-one:v0.0.44这条命令离线就能跑不发请求不花钱适合放在脚本最前面做环境自检。三、建模版实例必须从模版创建模版决定 CPU、内存、镜像和默认生命周期。控制台建模版只有两种规格配置 11 Core2 GB推荐和配置 24 Core8 GB挂载本地文件最多 5 个。想先看请求体长什么样用 dry-run写命令的 dry-run 不发请求bl sandbox template create--namemy-python--imagecode-interpreter --cpu-count1--memory-mb2048--dry-run--outputjson--image传英文 ID 或中文名都可以两种写法产出的请求体逐字一致fromImage填完整镜像地址imageName填中文显示名。查看已有模版bl sandbox template list四、创建实例并进入执行bl sandbox create --template-id你的模版ID--instance-timeout300三秒返回state直接是running没有就绪等待。返回体里 token 默认打码{envdUrl:https://49983-sbx-ad9a99f4-....cn-beijing.e2b.fc.aliyuncs.com,envdAccessToken:[REDACTED],envdVersion:0.2.4,sandboxID:sbx-ad9a99f4-...,state:running}两个 ID 别混sandboxID带sbx-前缀是后续命令和运行时域名要用的bailianSandboxId是平台内部 ID拿它拼域名会失败。create的返回里没有startedAt和endAt看寿命要再取一次详情bl sandbox get --sandbox-id sbx-...--outputjsonget比create多八个字段startedAt、endAt、lifecycle、cpuCount、memoryMB、allowInternetAccess、network、metadata。在沙箱里执行命令不在bl sandbox里没有bl sandbox exec这种命令。get和connect只返回连接信息。真正的执行走 envd 运行时接口拿envdUrl和envdAccessTokenPOST 到/process.Process/Start请求体用 Connect 协议的流式封装1 字节 flags 加 4 字节大端长度再加 JSON事件还包一层{event: {...}}。先探/health返回{status:ok}说明运行时可用。取明文 token 要加--show-credentials。教程里不给这个参数的示例你也别把 token 写进脚本日志或提交进仓库我的做法是重定向到umask 077的临时目录脚本从文件读用完删。五、出网策略四种配法的实测差别同一模版同一规格只改出网参数我开了五台做对照。结论表配法example.compypi.org服务端回读不加出网参数200 / 0.47 秒200 / 1.76 秒allowInternetAccess: true--allow-internet-access falsecurl 35 / 0.014 秒curl 35 / 0.009 秒false自动补两个内网 OSS 域--allow-out pypi.orgcurl 35 / 0.015 秒20010 秒收到 957 KBfalse总开关被隐式关掉--deny-out 104.20.23.154/32200 / 5.6 秒200 / 3.69 秒truedenyOut 回读一致--deny-out 0.0.0.0/0curl 28 / 10 秒超时curl 28 / 10 秒超时truedenyOut 回读一致四条要点断网断的是传输层DNS 照样解析。沙箱里getent hosts example.com能出地址不代表能出网判据看 TCP/TLS 建不建得起来。失败形态是 TLS 层 unexpected eof八到十四毫秒就断别误判成证书问题。传--allow-out会隐式把总开关关掉帮助文本没写这层联动。--allow-out收域名--deny-out只收 IP 和 CIDR。传域名创建直接失败服务端原文denyOut only supports IP / CIDR, domains are not supported而且--dry-run照不出这个错。单个/32封不住 CDN 域名。我封的104.20.23.154正是沙箱内解析到的地址但 curl 实际连的是172.66.147.243同属 Cloudflare 地址池。判定臂0.0.0.0/0能全拦住说明机制没问题是粒度问题。白名单那臂 pypi.org 十秒只收到 46.9 MB 里的 957 KB基线臂同一页面 1.76 秒下完。看着像走了代理但同一命令在另外两臂分别跑了 3.69 秒和 12 秒超时每臂只跑一次没有重复对照所以这只作观察不作结论。六、休眠与释放bl sandbox pause --sandbox-id sbx-... bl sandbox resume --sandbox-id sbx-... --instance-timeout900bl sandbox delete --sandbox-id sbx-...--yespause五秒返回{paused: true}resume三秒。休眠不丢盘写入的文件唤醒后原样在token 不轮换连接信息可以存着跨休眠周期用resume把寿命重新给满我这台endAt从 09:37:47Z 变成 09:43:00Z。坑pause之后get和list都还写着state: running。能看出休眠的只有两处bl sandbox list --state paused筛得到它--state running筛不到以及往 envd 发执行请求会拿到 HTTP 500 “an internal error has occurred. Please retry.”那不是内部错误是它睡着了。靠轮询 state 的调度器会在这上面给假阳性探活打/health。delete不带--yes会停在退出码 7 提示不可撤销。我这天六台实例全部显式删除删完bl sandbox list复查为空。七、计费口径官方《Sandbox 计费说明》最后修改 2026-10-09计费项对象单价规则会话运行费基础款0.156 元/小时按实际运行时长会话运行费进阶款0.312 元/小时按实际运行时长会话运行费旗舰款0.624 元/小时按实际运行时长数据保留费暂停、Snapshot0.0021 元/GiB·小时按实际占用与保留时长运行中的实例含 15 GiB 系统盘不另收费原文限定运行中。官方算例进阶款跑 40 加 20 分钟、暂停两小时占 8 GiB、Snapshot 6 GiB 留三小时合计 0.3834 元暂停那两小时只算保留费。所以休眠省的是运行费不是全部。两个必须写进文档的事实Sandbox 没有专属免费额度模型 Token 免费额度不覆盖它计费页的三档价格与控制台的两种规格1C2G / 4C8G之间没有任何官方映射三档对两配置数量都不吻合所以 1 vCPU 的实例属于哪一档、花多少钱公开文档给不出答案。八、常见问题Qbl sandbox list超过 50 台怎么办A翻不了页。--limit上限 50没有--all也没有--cursortemplate list有--cursor但服务端不返回 next cursor。规模上去要换盘点思路。Q--metadata打的标签为什么查不到A我 create 时传了--metadata purpose...dry-run 请求体里有这个字段但之后每次get回读都是null。要靠 metadata 做批管理的先自己验一遍。Q--state拼错了会报错吗A不会。bl sandbox list --state bogus-state返回空数组、退出码 0和确实没有该状态实例一模一样。Q服务端报错是中文脚本怎么匹配A匹配api_code。沙箱运行时不存在是 12000082沙箱模板不存在是 12000094别匹配中文字符串。Q--dry-run是不是完全不发请求A只对写命令短路。create、pause、resume、connect、delete、template create加它只摊请求体list、get、template get、template build-status加了它照样打服务端加--verbose能看见真实 GET。Q退出码分别是什么意思A0 成功1 服务端错误2 客户端参数校验失败7 高风险操作待确认。区间校验在本地就做--instance-timeout限 300 到 604800--cpu-count必须正整数。Q能在沙箱里跑需要 root 的任务吗A不能。登录用户是 uid 1000 的usercgroup 只读挂载镜像里没有ip、iptables。Qnproc报 2 但模版写 1 vCPU信哪个A信模版。忙循环实测 2 并发单进程掉到约一半、4 并发掉到约四分之一真实并行度约等于一核cpu.cfs_quota_us是 -1 没有硬配额容器里看到的核数是宿主机漏进来的。内存才是硬的memory.limit_in_bytes正好 2048 MB。九、收尾环境安装CLI 安装页API Key bl sandbox official-images bl sandbox template list bl sandbox create --template-id你的模版ID--instance-timeout300bl sandbox delete --sandbox-id实例ID--yes用文件、网络、权限、资源四问去量这台实例文件与权限两问答得干脆网络一问有三处反直觉但都能复现资源一问能测到限额却测不到它属于哪一档计费。第四问的答案在账单里不在文档里写预算说明的时候把这句话原样带上。