【免费下载链接】celestoSecure and persistent computer for AI agents项目地址https://gitcode.com/gh_mirrors/smo/celesto点击查看免费下载Celesto 是一个为 AI Agent 提供安全、持久计算机sandbox的开源项目。当你在宿主机上调用vm.run(echo hello)或上传文件时背后其实是宿主机与虚拟机之间的通信通道在工作。Celesto 同时支持两条控制通道SSH 通道传统、通用、全平台可用和vsock 通道原生虚拟机直通、更快、不依赖 IP 网络。本文将带你快速理解这两种通道的设计原理、自动选择逻辑以及如何在自己的场景下做出最佳选择。一、为什么要设计两套通信通道AI Agent 的沙箱需要宿主机持续遥控虚拟机执行命令、传输文件、探测开机是否就绪、打开交互式终端。Celesto 把这条控制面抽象成一个极小的接口CommChannel定义在 src/celesto/comm/base.py 中只暴露几个核心能力run/run_stream在客户机执行命令支持流式输出put_file/get_file上传/下载文件wait_ready阻塞等待客户机就绪close/connected连接生命周期管理接口刻意保持最小公分母因此环境变量注入、预设凭据拷贝等上层功能只需要调用run和put_file无论底层走 SSH 还是 vsock 都无需改一行代码。二、SSH 通道兼容性优先的万金油SSH 实现位于 src/celesto/ssh.py基于paramiko持久连接首次使用时建立一条 TCP 连接之后所有命令复用同一条连接避免了每次调用 fork 新ssh进程带来的约 170ms 额外开销全平台可用无论宿主机是 Linux 还是 macOS客户机是 Linux 还是 Windows只要有 sshd 就能工作自动等待 sshdwait_for_ssh从 20ms 起步、按 1.5 倍退避轮询尽早发现刚启动的 sshd减少开机等待的空转代价是它依赖虚拟机的 IP 网络客户机需要先完成网络配置、sshd 启动控制面流量还会被网络策略顺带影响。三、vsock 通道宿主机直插虚拟机的快车道vsockVirtual Socket是虚拟化平台提供的专用套接字通道不走 IP 网络宿主机和客户机通过客户机 CID 端口直接对话。Celesto 的 vsock 通道分两端实现3.1 宿主机端Rust guest agent 的 HTTP 客户端宿主机侧通道类RustHttpVsockChannel位于 src/celesto/comm/rust_http_vsock_channel.py核心约定端口用途1024guest agent 控制服务命令、文件、环境变量1025交互式终端流原始帧协议支持 resize、退出码回传它本质上是在 vsock 流上跑 HTTP/1.1/exec执行命令、/files/content传文件、/env管理受控环境变量、/capabilities协商协议版本与特性开关。两种底层连接方式QEMULinux使用原生AF_VSOCKQEMU 启动时挂载vhost-vsock-pci设备并分配guest-cid见 src/celesto/runtime/qemu_args.py依赖宿主机/dev/vhost-vsock设备FirecrackerLinux没有原生 vhost 设备Firecracker 提供宿主机侧 Unix Socket 桥Celesto 连接该 socket 后先发送CONNECT port一行完成握手再在其上流动 vsock 字节流3.2 客户机端常驻的 Rust guest agent虚拟机内部运行一个用 Rust 编写的celesto-guest-agent默认监听vsock://1024源码见 guest-agent/src/server.rs 与路由定义 guest-agent/src/handler.rs。它与宿主机配合完成命令执行与 SSE 流式输出文件/目录传输目录以 tar 流式传递关机前sync落盘、端口就绪探测终端会话1025 端口3.3 vsock 的安全边界由于 guest 被视为不可信宿主机侧做了大量防御下载目录时会剥离 setuid/setgid 权限位、拒绝绝对路径与符号链接穿越响应体有大小上限如单文件默认 256MB、tar 包 512MB防止恶意 guest 借传输通道做权限提升或耗尽宿主机资源。四、自动选择逻辑谁来决定走哪条通道选择逻辑集中在 src/celesto/comm/select.py 的resolve_comm_channel优先级为调用方显式指定comm_channelvsock或ssh——最高优先级VM 持久化配置中保存的通道自动模式vsock 可用就优先 vsock否则回退 SSH自动模式判定vsock 可用的条件客户机不是 WindowsWindows guest 一律 SSH后端为 QEMU 时宿主机是 Linux 且加载了vhost_vsock存在/dev/vhost-vsockmacOS/HVF 无对应设备返回 False后端为 Firecracker 时宿主机必须是 Linux一个关键设计原则显式请求 vsock 但环境不满足时抛出结构化的VsockNotSupportedError带错误码与恢复建议绝不静默降级为 SSH。自动模式下facade 还会运行时探测 vsock 就绪ping guest agent探测失败即让 vsock 就绪判定失败同样不做悄悄换路保证行为可预期。相关约束见 src/celesto/facade.py。五、怎么选一张对照表帮你决策场景推荐通道原因Linux Firecrackervsock唯一可选且是网络策略off/restricted的硬性要求Linux QEMUvsock自动更快无需等待客户机网络与 sshdmacOS 宿主SSH无 vhost_vsock 设备vsock 不可用Windows 客户机SSH当前版本 Windows guest 不支持 vsock需要彻底断网internet_settings为off/restrictedvsockvsock 独立于 IP 网络命令与文件传输照常工作vsock 与网络策略的关系在 docs/guides/networking.md 中有完整说明Firecracker 关闭出站网络后仍可通过comm_channelvsock直接执行命令、下载文件——这正是 vsock脱离 IP 网络价值的最佳体现。六、核心模块导航想深入源码这些路径值得收藏通道抽象接口src/celesto/comm/base.py通道选择与降级策略src/celesto/comm/select.pyvsock HTTP 通道实现src/celesto/comm/rust_http_vsock_channel.pySSH 通道实现src/celesto/ssh.py客户机 agentRustguest-agent/src/通道行为测试tests/communication/架构总览docs/contributing/architecture.md七、总结设计背后的三条理念接口最小化CommChannel只有执行、传文件、等就绪几个动词两条传输实现互相替换上层零感知快速路径优先在 vsock 可用的环境里自动走直连通道省掉客户机网络栈和 sshd 启动等待AI Agent 的高频命令调用受益最大失败要响亮显式选择被环境拒绝时给出结构化错误与恢复命令而不是静默换通道——对自动化场景而言可预期的失败远好于隐蔽的降级理解这套设计后下次遇到沙箱命令突然变快或断网模式无法 exec的情况你都能一眼定位到是通道选择策略在起作用。赞分享【免费下载链接】celestoSecure and persistent computer for AI agents项目地址https://gitcode.com/gh_mirrors/smo/celesto点击查看免费下载相关推荐Incus pci 设备类型详解将宿主 PCI 设备直通到虚拟机Incus pci 设备类型详解将宿主 PCI 设备直通到虚拟机 pci 是 Incus 中用于把宿主机上的原始 PCI 设备直接透传直通给虚拟机的设备类虚拟化云原生后端虚拟机内 chrome-devtools-mcp 连接宿主机 Chrome 被拒绝如何用 SSH 隧道解决虚拟机内 chrome devtools mcp 连接宿主机 Chrome 被拒绝如何用 SSH 隧道解决 在虚拟机VM中运行 MCP 客户端并希望通AI 应用MCP 服务浏览器控制开发工具Cloud Hypervisor virtio-vsock 支持全解析从 CID 寻址到宿主机/客户机双向通信实战Cloud Hypervisor virtio vsock 支持全解析从 CID 寻址到宿主机/客户机双向通信实战 VSOCK 为虚拟机客户机guest与人工智能AI AgentAgent 沙箱虚拟化云原生后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考