# 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="/files/98790711445a8ca9b0a9b89a2ac82a59ea332d24" alt="" width="310"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/e7726326ab29727f610a711ceff24c6e54e554b3" 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="/files/099e22216df2291fa501d1ce99cd1d15e682db39" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

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

<div align="left"><figure><img src="/files/0323c690e5fdddf679da978570bb911531378270" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="/files/b6e3aa64061dcf8ce96b1f2c3514b74465919a67" 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="/files/b89a1f3c61fa4e693d2f8e36a761b3791d02e83c" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
点击 **快速创建** → 选择![](/files/bcdf011cdf4e100848a009d84a2575ab4dd9baee)**本地安装源**.

<div align="left"><figure><img src="/files/a0230407015ada3b0e82e68fce6767cffc26e41e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="/files/e121218ace0f8089e50186ca0cb7d232ba7b83de" 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="/files/c501e24998fe307e2f5dd8375c94a04f05579d01" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

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

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

<div align="left"><figure><img src="/files/96c6a0986dc6f5bad029da0b7ade4e3aa5aa9ced" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

### 5. 启动 CUBE OS

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

<div align="left"><figure><img src="/files/9fd8567be560b13f389556a7ef9beebdd25d4721" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="/files/c7fe9a72b5ab7f59f1e087cd5a1808466906924f" 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="/files/9c4d9e04846715c243439f27d252dd3758bce57d" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="/files/fa038405b45d1fb120cbfcf18926f1c427f6ea83" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/english-zh/ru-men-zhi-nan/quickstart/xu-ni-ji/hyper-v.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.