CubeSandbox

简体中文

English

简体中文

English

Appearance

下载与 Release 说明 ​

CubeSandbox 的所有发布物都在同一个 Releases 页面上。先按你的场景对号入座，再跳到对应小节照做：

你的场景需要手动下载什么去哪一节
标准部署（快速开始、裸金属）什么都不用标准部署
PVM 部署（云服务器无 /dev/kvm）宿主机内核包（rpm/deb）PVM 部署
自建发布包 / 替换内核或镜像guest 内核、guest 镜像自建部署

只是照着快速开始部署？

那你不需要本页面 —— 在线安装脚本会自动下载一键部署包并解析全部产物。

标准部署：无需手动下载 ​

一行命令在线安装（详见快速开始）：

bash
curl -sL https://cnb.cool/CubeSandbox/CubeSandbox/-/git/raw/master/deploy/one-click/online-install.sh | MIRROR=cn bash

需要手动下载整包（cube-sandbox-one-click-<版本>-<架构>.tar.gz，架构为 amd64 / arm64）：

bash
wget https://cnb.cool/CubeSandbox/CubeSandbox/-/releases/download/v0.6.0/cube-sandbox-one-click-v0.6.0-amd64.tar.gz

PVM 部署：下载宿主机内核包 ​

PVM 部署中，唯一需要手动下载的就是宿主机内核包 —— 装上它、重启进入 PVM 内核即可获得 KVM 能力。PVM 的 guest 内核（vmlinux-pvm）已内置于一键部署包，安装时设 CUBE_PVM_ENABLE=1 即自动激活。安装、GRUB 配置与重启的完整步骤见 PVM 部署 — 第一步，本节只讲怎么拿到包。

内核包发布在专属的 kernel-release-* Release 上，直接到发布页下载：

  1. 打开 CubeSandbox Releases 页面，在过滤框输入 kernel-release，打开最新的一个
  2. 按你的发行版下载内核主包：
    • RPM 系（OpenCloudOS、RHEL、CentOS、TencentOS、Fedora）：kernel-*opencloudos9.cubesandbox.pvm.host*.x86_64.rpm
    • DEB 系（Ubuntu、Debian）：linux-image-*opencloudos9.cubesandbox.pvm.host*_amd64.deb

资产列表中的 kernel-headers-*、-dbg 等为可选包，无需下载。

已安装 GitHub CLI 的用户也可免找文件名、按通配直接下载，用法见附录。

📌 OpenCloudOS 9 用户专属快捷路径 内核包已上架 OpenCloudOS 官方 yum 仓库，无需手动下载 rpm，dnf install 一行命令可实现直装，整体部署只需 5 条命令。 👉 在 OpenCloudOS 9 上一键部署 CubeSandbox 实测

自建部署：下载 guest 内核与镜像 ​

只有在自行构建发布包或替换组件时才需要下载这些（一键部署包已全部自带）：

bash
# guest 内核（发布在 kernel-release-* 下，文件名固定）
wget "https://cnb.cool/CubeSandbox/CubeSandbox/-/releases/download/kernel-release-260812-1/vmlinux-amd64"       # 裸金属/KVM，aarch64 用 vmlinux-arm64
wget "https://cnb.cool/CubeSandbox/CubeSandbox/-/releases/download/kernel-release-260812-1/vmlinux-pvm-amd64"    # PVM guest 内核（仅 x86_64）

# guest 镜像（发布在 guest-image-* 下，内含 cube-guest-image-cpu.img）
wget https://cnb.cool/CubeSandbox/CubeSandbox/-/releases/download/guest-image-260820-1/cube-guest-image-amd64.tar.gz
tar -xzf cube-guest-image-amd64.tar.gz

URL 中的 tag 会随发布递增（文件名固定，换 tag 即可）；最新 tag 可在 Releases 页面 过滤 kernel-release / guest-image 查看。

自建时把 vmlinux 放入 deploy/one-click/assets/kernel-artifacts/ 即可，详见本地构建部署 — 1.1 准备内核文件。

附录：URL 规律、最新 tag 与版本 pin ​

URL 规律 —— 所有资产两个渠道完全一致，把域名换掉即可切换：

渠道URL 规律
CNB 镜像（国内推荐）https://cnb.cool/CubeSandbox/CubeSandbox/-/releases/download/<tag>/<资产名>
GitHub（权威源，境外推荐）https://github.com/TencentCloud/CubeSandbox/releases/download/<tag>/<资产名>

用 gh 免找文件名 —— 按通配直接下载，或列出所有 kernel-release tag：

bash
# 列出最新的 kernel-release tag
gh release list --repo TencentCloud/CubeSandbox --limit 30 | grep kernel-release

# 按通配下载（<tag> 替换为上面查到的最新 tag，无需知道精确文件名）
gh release download <tag> --repo TencentCloud/CubeSandbox \
  --pattern 'kernel-6*.x86_64.rpm'   # 或：--pattern 'linux-image-6*_amd64.deb'

版本 pin —— 每个 v* 产品版本在 deploy/release-assets.yaml 中记录打包所用的 kernel / guest-image tag（也写在包内 release-manifest.json），据此可查"我手里的包用的是哪个内核"。专属 tag 的发布节奏独立于产品版本，pin 可能落后于最新 tag —— PVM 宿主机内核建议始终用最新 kernel-release-*（含内核安全修复），无需与产品版本对齐。

（v0.6.0 及之前的产品 Release 上还直接附有内核/镜像资产，属历史布局，之后不再如此。）