# 腾讯云 CVM 部署 CubeSandbox实测快照、克隆、回滚三大核心能力## 前言如果只是看产品介绍很多人对 CubeSandbox 的感受会停留在“这是一个沙箱平台”。真正上手之后更容易感受到它的价值其实是在一套可控环境里把实例状态保存、复制和恢复这三件事做得足够快。这篇文章就按一次完整实操来写先在腾讯云 CVM 上部署 CubeSandbox再进入 WebUI 配置数字助手最后亲手体验 **快照**、**克隆**、**回滚** 这三项核心能力。整套流程运行在 OpenCloudOS 9 环境中适合第一次接触 CubeSandbox 的读者直接照着做。## 一、实操环境先准备好这次实验需要的基础信息有 3 个| 项目 | 说明 || --- | --- || 云服务器 | 腾讯云 CVM || 操作系统 | OpenCloudOS 9 || 登录方式 | SSH 远程连接 |如果现场已经统一发放服务器和 API Key可以先用下面的命令连上机器bashssh root服务器ip -p 9888连上之后不要急着直接安装 CubeSandbox。因为在腾讯云 CVM 上运行 CubeSandbox 之前先要把 PVM 内核准备好让虚拟机环境具备运行条件。## 二、先安装 PVM 内核### 1. 安装指定内核在 OpenCloudOS 9 上执行下面这条命令bashdnf install -y kernel-6.6.69-1.1.cubesandbox.oc9这一步的作用很直接就是把 CubeSandbox 需要的内核装到当前系统里。后面的默认启动切换、启动参数配置都建立在这个内核已经安装完成的前提下。### 2. 切换默认启动内核并写入启动参数继续执行bash# 把刚装的 CubeSandbox 内核设为默认启动grubby --set-default /boot/vmlinuz-6.6.69-1.1.cubesandbox.oc9.x86_64# 配置 PVM 所需的内核启动参数curl -sL https://cnb.cool/CubeSandbox/CubeSandbox/-/git/raw/master/deploy/pvm/grub/host_grub_config.sh | bash# 重启进入新内核reboot这里有两个关键点需要注意- grubby 切换默认内核成功后会有一行默认内核回显这不是报错。- host_grub_config.sh 的作用是补齐 PVM 运行需要的启动参数省掉手工改 grub 的步骤。执行重启后当前 SSH 会断开。等服务器重启完成再重新连接一次。### 3. 重启后验证内核和模块重新连回服务器后先确认是不是已经进入目标内核bashuname -r期望看到的版本是text6.6.69-1.1.cubesandbox.oc9.x86_64如果内核版本没问题再加载 PVM KVM 模块bashmodprobe kvm_pvmlsmod | grep kvm_pvmecho kvm_pvm /etc/modules-load.d/kvm-pvm.conf这 3 条命令分别完成 3 件事- 立即加载模块。- 确认模块已经生效。- 写入 /etc/modules-load.d/kvm-pvm.conf保证机器重启后自动加载。做到这里宿主机环境才算真正准备完成。## 三、一键安装 CubeSandbox并检查是否可用环境准备好之后就可以开始安装 CubeSandboxbashcurl -sL https://cnb.cool/CubeSandbox/CubeSandbox/-/git/raw/master/deploy/one-click/online-install.sh \| CUBE_PVM_ENABLE1 MIRRORcn bash这个安装命令里有两个值得关注的参数- CUBE_PVM_ENABLE1表示启用 PVM 模式。- MIRRORcn使用国内镜像加快安装过程。安装结束后不建议只看脚本跑完就判断成功最好再做一次模板级验证。执行下面的命令bashcubemastercli tpl create-from-image \--image cube-sandbox-cn.tencentcloudcr.com/cube-sandbox/sandbox-code:latest \--writable-layer-size 1G \--expose-port 49999 \--expose-port 49983 \--probe 49999接着再查看模板状态bashcubemastercli tpl list如果模板状态显示为 READY说明 CubeSandbox 已经具备正常工作的基础条件。这个验证动作很重要因为它直接对应后续 WebUI 和数字助手能不能顺利创建实例。## 四、进入 WebUI先把管理界面跑通CubeSandbox 安装完成后可以通过 WebUI 继续后面的所有操作。登录信息如下| 项目 | 信息 || --- | --- || WebUI 地址 | http://机器ip:12088 || 默认账号 | admin || 默认密码 | admin |登录成功后首页通常可以看到当前沙箱实例和模板列表。这里不用做复杂配置先确认管理界面能正常访问即可。如果你觉得这个项目值得继续关注也可以顺手去 GitHub 看一下仓库[TencentCloud/CubeSandbox](https://github.com/TencentCloud/CubeSandbox)## 五、配置数字助手准备进入实操接下来进入数字助手页面开始配置模型服务。### 1. 先配置模型服务在模型配置弹窗中填写下面这些信息| 字段 | 填写内容 || --- | --- || Provider | OpenAI Compatible || LLM Base URL | https://newapi-2607.cubesandbox.com/v1 || 模型 ID | hy3-preview || LLM API Key | 现场发放的 Key || 凭证交付方式 | 凭证托管 |这里推荐直接选择凭证托管。这样保存之后密钥会由 CubeEgress 托管沙箱内部拿不到真实 Key安全性更高。### 2. 选择助手镜像模型配置完成后进入应用市场选择 OpenClaw 镜像并安装到数字助手。在创建实例时需要额外留意两个点- 给实例起一个容易区分的名字。- 把“状态管理模式”设置为 **完整快照型**。这个设置直接关系到后面体验快照、克隆和回滚时的效果。如果这里没选对后面的状态管理能力就体验不完整。等待模板制作完成、实例初始化结束之后就可以进入 OpenClaw 的对话界面继续测试。## 六、用一次完整实验体验快照、克隆、回滚实例创建完成后点击卡片底部的 Gateway 管理进入 OpenClaw 的对话 WebUI。进入页面后先在底部模型选择器中选中 hy3-preview再发一条简单消息确认对话服务能正常响应。确认助手工作正常后就可以开始下面这三个实验。### 1. 体验快照第一步先让助手在实例里创建一个文件text往“/root/a.txt写入 ”测试消息111“。然后cat 一下文件给我。如果返回结果里能看到文件内容说明这个实例当前状态已经发生了变化。接着回到 CubeSandbox WebUI打开这个实例的管理页进入状态管理然后点击“创建存档”。这个动作本质上就是为当前实例打一个快照把当前环境状态保存下来。这一步的意义不只是“存一下文件”而是证明当前实例的文件系统和会话环境可以被保存为一个可回到的历史点。### 2. 体验克隆有了快照之后就可以继续测试分身能力。在状态管理页面点击“创建分身”等待系统完成克隆。分身创建完成后再进入这个分身的 Gateway 管理页面。通常可以先观察到一个非常直观的现象历史对话记录和原始实例是一致的。接着在分身里发送text往“/root/b.txt写入 ”我是分身“。然后cat 一下文件给我。如果这一步执行成功再回到原始实例中输入text帮我看看/root/b.txt这个文件内容。这时如果原始实例里找不到这个文件就说明分身和原实例已经分离成两套独立环境。也就是说分身虽然继承了创建那一刻的状态但后续修改不会反向影响源实例。这正是克隆能力在实际业务里最有价值的地方可以基于同一个起点快速派生多个相互隔离的实验环境。### 3. 体验回滚最后再测试回滚能力。先在原始实例里执行一次“误操作”text帮我删除/root/a.txt然后再确认文件是否还存在text看看/root/a.txt还在不在如果助手反馈文件已经不存在说明环境状态已经被改坏了。这个场景很像真实使用中的误删文件、运行脚本出错、依赖环境损坏。接下来回到 CubeSandbox 控制台进入原始实例的状态管理页面选中之前创建的存档点击“回档”。回档完成后再重新进入原始实例的 Gateway 管理页面可以继续检查两个结果- 之前误删文件之后的对话记录是否已经消失。- 再次询问 /root/a.txt 是否存在时文件是否已经恢复。如果这两个现象都出现就说明回滚不是简单恢复某个文件而是把实例整体状态恢复到了打快照时的那个时间点。## 七、这套流程适合什么场景把这三个实验做完之后CubeSandbox 的适用场景会很清楚。### 1. 适合做高频实验环境当你需要反复试命令、试依赖、试脚本时先做一次快照再基于快照回滚能明显降低试错成本。### 2. 适合做多分支并行验证同一个基础环境可以快速克隆出多个分身。每个分身各自验证不同方案互不影响特别适合多版本测试和多路径尝试。### 3. 适合做可恢复的数字助手工作台数字助手并不只是聊天入口更像一个带状态的执行环境。快照、克隆、回滚三件事一旦接到同一个工作流里整个助手环境就会更可控。## 总结这次实操从宿主机内核准备开始一路走到 CubeSandbox 安装、WebUI 登录、数字助手配置再到快照、克隆、回滚三项能力验证整条链路是完整打通的。如果你第一次接触 CubeSandbox建议至少把 /root/a.txt、/root/b.txt 这两个实验亲手做一遍。做完之后对“状态型数字助手”到底能解决什么问题理解会比看功能介绍直接很多。
