BoxLite 实测:持久工作区与网络控制
BoxLite 十六项真实运行检查:命令执行与文件传输。跨进程文件恢复、挂载权限、超时处理与出站白名单。
AgentIndex · 发布于 2026-11-06 · 更新于 2026-11-06
BoxLite 是把 Linux 执行环境嵌入智能体应用的运行时。选型时需要回答的实际问题是:任务能否执行命令、留下文件、换一个调用进程继续工作,并按明确规则释放资源?本篇在 Apple Silicon Mac 上启动真实微虚拟机验证这些流程。
结果支持把 BoxLite 放进持久本地工作区的候选:两个独立 Python 进程打开同一个 Box,保留文件可读;只读挂载拒绝写入,命令退出码能够保留;实时反转出站白名单后,新连接的允许与拒绝结果也随之反转。采用时仍需明确生命周期与文件传输方式:默认临时实例停止后会删除,高层复制接口也不能直接写入挂载后的 /tmp。
固定发布版与实测环境
2026 年 11 月 6 日,我们在独立环境安装已发布的 Python SDK 0.11.0,对应发布提交 24cef4607416b4b75e4663f966f8315a5e4773bd。本次还独立核对了 CPython 3.12、macOS ARM64 wheel 的公开 SHA-256,测试对象是发布的二进制包,没有把主分支全部功能视为已经交付。发布记录、Python SDK 参考
| 项目 | 本次实际输入 |
|---|---|
| 宿主 | macOS 26.6.2,Apple Silicon arm64 |
| Python 与 SDK | CPython 3.12.13,BoxLite 0.11.0 |
| 客体 | Linux aarch64,Alpine 3.22.8 |
| 单个 Box 配置 | 1 CPU、256 MiB,最多同时运行两个 |
| 镜像身份 | 固定 Linux ARM64 OCI manifest 摘要 |
| 运行数据 | 显式指定的独立临时目录 |
| 挂载内容 | 人工只读输入目录与可写输出目录 |
复现脚本 记录完整 wheel 和镜像身份。十六项具名检查没有替换虚拟机运行时,没有模型调用、个人文件或私有镜像仓库凭据。本次 wheel 标记为 macOS 14+ ARM64,其他宿主平台没有实测。
命令完成仍要判断退出状态
我们让一个命令分别写入标准输出和标准错误,再以退出码 7 结束。SDK 正确保留三项结果。因此,SDK 调用返回,并不代表任务成功;接入智能体时需要判断退出码,再决定怎样汇报和继续执行。
另一个流程创建会话文件,在下一次执行中读取,并显式传入工作目录和人工环境变量,这些设置得到遵守。两个并发命令也分别返回各自输出,没有混合结果。它们构成执行功能的基础验证,没有形成吞吐量测试。
超时检查给三秒的 sleep 设置 0.25 秒执行期限,结果提前返回,退出码为 -15,error_message 为空;下一条命令仍然成功。调用方不能只依赖异常或非空诊断识别失败。这项检查也没有证明任意后代进程树都会被完整终止。SimpleBox 执行实现
文件可以跨 Python 调用进程保留
第一个进程使用 auto_remove=False 创建具名 Box,写入文件后停止。该 Python 进程退出后,第二个进程使用相同的独立运行目录和 reuse_existing=True 打开它,得到相同 Box ID,并明确报告复用而非新建;会话文件和传入文件都可以读回。
这比在同一个对象上执行两条命令覆盖了更多恢复路径,验证的是跨调用进程的文件保留。它不意味着 Python 变量、进程内存或交互程序能够自动接续。智能体仍需把持久任务状态写入文件,并记录应该重新打开哪个工作区。
另一台采用默认临时生命周期的 Box,在停止后从运行时元数据中消失。保留型 Box 则停止后仍存在,需要显式删除;删除完成后,运行时列表为空。本测试使用该版本支持的 auto_remove 兼容参数,参考文档还提供新的 auto_delete 控制。接入时应固定 SDK 版本,明确保留策略。
挂载权限与文件复制分开设计
客体可以通过只读挂载读取人工输入文件,但写入返回退出码 1,宿主原文件不变;通过独立可写挂载写出的结果,则能在宿主目录中读到。未挂载的一个宿主测试路径在客体中不存在,专门设置的一个宿主环境变量也没有自动进入客体。
这些结果说明选定边界的实际行为,没有构成虚拟机逃逸审计,也不证明所有宿主资源均无法访问。可写挂载本来就是主动共享,因此选择哪个目录、授予什么权限,属于应用自身的访问决策。
公开 copy_in、copy_out 接口可以通过 /workspace 往返传输文件,字节一致。向 /tmp 复制则抛出 UnsupportedError,错误中指出了对应挂载。SDK 解释,这条传输路径写入底层根文件系统,挂载会把写入结果遮住。文件传输实现与说明
文件型任务可以把这条复制接口用于 /workspace 等普通工作目录,或采用本次验证过的显式共享输出目录。不同传输机制指向相同的文字路径,并不自动保证运行中的命令能看到同一份文件。
网络白名单做了反向对照
持久 Box 显式关闭出站网络,公共 HTTP 请求失败。第二个 Box 只允许 example.com:访问该域名成功,访问 example.org 失败。
为加强归因,避免把单个网站临时不可用当作策略生效,我们把运行中的白名单改为 example.org。新的请求能够访问它,原先允许的 example.com 新请求则失败。同一个运行中 Box 的结果随规则反转。
这验证了选定出站 HTTP 流程和实时更新路径,没有覆盖 TLS SNI、UDP、全部 IP 表达方式,或修改规则前已经建立的连接。SDK 参考文档说明,未指定策略时默认启用网络;本次的限制都是显式配置。网络配置参考
启动观察与镜像获取依赖
最终记录中,运行目录的镜像缓存为空时,第一次 start() 用时 8.440 秒;使用已有镜像缓存创建第二个 Box 用时 1.204 秒;第二个 Python 进程重新打开保留的 Box 时,调用返回耗时 0.204 秒,随后文件读取成功。
这些是本机单次 API 调用观察。第一次包含镜像获取,不包含 SDK 安装,不能当成不同机器的冷启动基准,也不是完整工作负载的完成时间。
更早的一次尝试在启动前连接 Docker 公共令牌端点失败,重试后成功。本篇保留这项获取依赖,没有据此断言 BoxLite 存在确定缺陷或 Docker 服务发生故障。可重复的集成既需要固定镜像身份,也需要考虑怎样获取镜像:客体尚未执行命令,创建流程就可能失败。
选型结论
如果需要用程序管理本地 Linux 工作区、跨会话保留文件,并由调用方明确控制执行与出站访问,BoxLite 值得试用。本篇 Python 流程启动了真实微虚拟机,没有通过 Docker CLI 执行任务;仓库采用 Apache-2.0。
更大规模服务仍需在目标宿主、工作负载、并发量和运维生命周期上验收。云端 REST、集群调度、对抗性隔离及模型驱动任务质量没有纳入本篇。关注智能体工作区自身的资料迁移,可看 PI-Desktop 存储评测;需要不执行权重的静态模型文件检查,可看 REA 实测。