Hyper-V

本指南说明如何在运行于 Windows 的 Microsoft Hyper-V 上安装 CUBE OS。

特别感谢我们的社区贡献者 @Jordanwise 创建并分享此有用的教程视频：

1. 准备

1

下载 CUBE OS 镜像

访问此 仓库 以下载最新的 .vmdk 镜像。下载后请解压镜像。

2

安装 Hyper-V

Windows 10 / 11 专业版、企业版或教育版（需要 Hyper-V）

在系统上启用 Hyper-V：在使用 Hyper-V 之前，请确保在 Windows 中已启用它。打开 控制面板 → 程序 → 启用或关闭 Windows 功能,

启用 Hyper-V （包括 Hyper-V 管理工具 和 Hyper-V 平台), 虚拟机平台, Windows Hypervisor 平台，然后点击 确定 并重启计算机。

3

Zigbee 适配器（可选）

如果需要添加 USB Zigbee 设备，请注意 Hyper-V 不支持对像 Zigbee 加密狗 等硬件设备的原生 USB 直通。如果需要 USB 访问，请考虑使用 基于 USB-over-IP 的解决方案 或 基于网络的 Zigbee 协调器 代替。

2. 将 CUBE OS 镜像转换为 VHDX

在创建虚拟机之前，将 CUBE OS 磁盘镜像转换为 Hyper-V VHDX 兼容格式。

1

下载并安装虚拟机镜像转换工具，例如 VM Image Converter （在 Windows 上推荐）

2

启动转换工具并选择：

• 源格式： VMDK

• 目标格式： VHDX

3

完成转换并记录生成的 .vhdx 文件的位置。

3. 创建虚拟机

1

启动 Hyper-V 管理器.

2

点击 快速创建 → 选择本地安装源.

3

选择 更改安装源，选择已转换的 CUBE OS .vhdx 文件并禁用 Windows 安全启动.

4

为虚拟机输入名称（例如， CUBE OS），然后 创建虚拟机.

4. 配置虚拟机设置

1

点击 设置 新创建虚拟机的设置。

2

分配系统资源：

• 最低： 4096 MB（4 GB）

• 禁用动态内存（推荐）。

• 处理器：2 个虚拟处理器

3

点击 应用 和 确定 以保存设置。

5. 启动 CUBE OS

1

点击 连接 和 启动 已创建的虚拟机。

2

等待片刻以让 CUBE OS 初始化。监视启动屏幕直到启动完成。

3

完成后，屏幕上会显示 CUBE OS 的 IP。使用此 IP 地址或 cube.local 访问 CUBE OS 网页管理页面。

4

成功访问后，可以在设置页面查看短 ID。随后，可使用 cube-{short id}.local访问 CUBE OS 网页管理页面，这对于在同一局域网中区分多个 CUBE OS 实例非常有用。