# Hyper-V

特别感谢我们的社区贡献者 [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) 创建并分享此有用的教程视频：

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. 准备 <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**下载** CUBE OS **镜像**

访问此 [仓库](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) 以下载最新的 `.vmdk` 镜像。下载后请解压镜像。
{% endstep %}

{% step %}
**安装 Hyper-V**

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

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

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&#x26;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&#x26;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Zigbee 适配器（可选）**

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

### 2. 将 CUBE OS 镜像转换为 VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

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

{% stepper %}
{% step %}
下载并安装虚拟机镜像转换工具，例如 **VM Image Converter** （在 Windows 上推荐）&#x20;

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&#x26;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
启动转换工具并选择：

* 源格式： **VMDK**
* 目标格式： **VHDX**

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&#x26;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
完成转换并记录生成的 `.vhdx` 文件的位置。

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&#x26;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. 创建虚拟机 <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
启动 **Hyper-V 管理器**.

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&#x26;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
点击 **快速创建** → 选择![](https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**本地安装源**.

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&#x26;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&#x26;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
为虚拟机输入名称（例如， `CUBE OS`），然后 **创建虚拟机**.
{% endstep %}
{% endstepper %}

### 4. 配置虚拟机设置 <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
点击 **设置** 新创建虚拟机的设置。

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&#x26;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
分配系统资源：

* 最低： **4096 MB（4 GB）**
* 禁用动态内存（推荐）。
* **处理器**：2 个虚拟处理器

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&#x26;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
点击 **应用** 和 **确定** 以保存设置。
{% endstep %}
{% endstepper %}

### 5. 启动 CUBE OS

{% stepper %}
{% step %}
点击 **连接** 和 **启动** 已创建的虚拟机。

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&#x26;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&#x26;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
完成后，屏幕上会显示 CUBE OS 的 IP。使用此 IP 地址或 [cube.local](http://cube.local/) 访问 CUBE OS 网页管理页面。

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://2213833752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}