# VirtualBox

{% embed url="<https://www.youtube.com/watch?v=ZRNFkle69BI>" %}

### 1. 准备：

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

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

{% step %}
**安装虚拟机**

下载并安装虚拟机管理程序，推荐使用 [VirtualBox](https://www.virtualbox.org/wiki/Downloads) 。

<img src="/files/44c37c5f9bdbe5b14fe4fbe357a1e4df8cbd2c85" alt="" data-size="original">
{% endstep %}

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

如果需要添加 Zigbee 设备，请准备一个 Zigbee 加密狗。已测试的 Zigbee 加密狗包括：
{% endstep %}
{% endstepper %}

### 2. 创建虚拟机：

{% stepper %}
{% step %}
启动 VirtualBox

<img src="/files/066eda2803c8754d71718cafdfbb2ae997665fc7" alt="" data-size="original">
{% endstep %}

{% step %}
选择“新建” <img src="/files/3205749942e9bb1595174665cfeecbacf119e475" alt="" data-size="line"> 或使用快捷键“Ctrl + N”。
{% endstep %}

{% step %}
为虚拟机命名，类型选择“Linux”，子类型选择“Other Linux”，版本选择“Other Linux (64-bit)”。

<img src="/files/f7bf10ec3e3bff5d475bddacda72f32235f3c7e8" alt="" data-size="original">
{% endstep %}

{% step %}
在“硬件”下，分配虚拟机的内存大小和处理器数量。建议 4GB 内存和 2 个 CPU。然后启用 EFI。

<img src="/files/78f45fe1a9eef7c5951fed8d2e828553e7c53570" alt="" data-size="original">

{% hint style="info" %}
重要：确保启用 EFI；否则 CUBE OS 无法启动。
{% endhint %}
{% endstep %}

{% step %}
在“硬盘”下，选择使用现有的虚拟硬盘文件，并选择从 [准备步骤 1](#id-1-preparation)

<img src="/files/e2d279db9d0d89d6e70e54f23e6e80d80a6c6e73" alt="" data-size="original">
{% endstep %}

{% step %}
中解压得到的 .vdi 文件。
{% endstep %}
{% endstepper %}

### 点击“完成”以创建虚拟机。

{% stepper %}
{% step %}
3\. 配置虚拟机： <img src="/files/dda3ad4959af3049c566b7c15bfc59d06a9cbae8" alt="" data-size="line"> 选择刚创建的虚拟机并点击“设置”

<img src="/files/0e87582a5e9e8742c82c6a07afa6d0b6d56e3b9f" alt="" data-size="original">
{% endstep %}

{% step %}
按钮。

<img src="/files/c705eb33486f0fe3deea5a98cae9b3dc3d278acb" alt="" data-size="original">
{% endstep %}

{% step %}
在“网络”选项卡下，将网络连接配置为“桥接网卡”，并选择你正在使用的网络适配器。&#x20;

<img src="/files/5142e7229e4963cdda62e84a6af5498ef6153cdf" alt="" data-size="original">
{% endstep %}

{% step %}
**在“声音”下，启用音频并选择默认选项作为控制器。** 可选：

<img src="/files/0803d0bbb023b6f5ca9c9e5ae4ade2a399d32884" alt="" data-size="original">
{% endstep %}

{% step %}
对于 Zigbee 加密狗的使用，请在此步骤插入 Zigbee 加密狗，并在“USB”下选择正确的控制器类型。在 USB 过滤器中，通过侧边的添加按钮添加所需的 Zigbee 加密狗。
{% endstep %}
{% endstepper %}

### 点击“确定”保存配置。

{% stepper %}
{% step %}
4\. 启动 CUBE OS <img src="/files/03e1a626a70bc05c3be5a2ef10e2e6a83ab11350" alt="" data-size="line">.

<img src="/files/e39aeea1c3f8888ca8031052251eff798b3b4ba3" alt="" data-size="original">
{% endstep %}

{% step %}
点击“启动”按钮

<img src="/files/d77cb75cddf958a3073240dcb6a39f534ecb2853" alt="" data-size="original">
{% endstep %}

{% step %}
监视启动屏幕直到启动完成。 [完成后，你将在屏幕上看到 CUBE OS 的 IP。使用该 IP 地址或](http://cube.local) cube.local

<img src="/files/318227da0068604d82bdeb649a2004eec1d7a72c" alt="" data-size="original">
{% endstep %}

{% step %}
访问 CUBE OS 的网页管理界面。 `成功访问后，可在设置页面查看一个短 ID。随后，可使用`cube-{short id}.local

<img src="/files/4251c0d8002c8e776b39172e658dbe31af281e38" alt="" data-size="original">
{% 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/virtualbox.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.