> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-zh/kuai-su-kai-shi/quickstart/xu-ni-ji/vmware.md).

# VMware

{% embed url="<https://www.youtube.com/watch?t=3s&v=TD_Gr38HOsU>" %}

### 1. 准备：

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

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

{% step %}
**安装 VMware**

下载并安装虚拟机管理软件， [推荐使用 VMware Workstation](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion) 。

> 有其他虚拟机管理器吗？理论上也可以使用以下步骤。\
> 不熟悉虚拟机且拥有树莓派吗？您可以选择在 [树莓派](/english-zh/kuai-su-kai-shi/quickstart/shu-mei-pai.md)上安装 CUBE 操作系统。 \
> 如果这些选项都不可行，您可以购买一台 [iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) ，其内置 CUBE 操作系统，可在 SONOFF 官方网站或亚马逊等平台上购买。
> {% endstep %}

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

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

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [列出的其他项](https://darkxst.github.io/silabs-firmware-builder/) 由开发者 @darkxst 提供&#x20;

{% hint style="info" %}
有关 Zigbee 配置和兼容性的更多信息，请参阅此 [指南](/english-zh/jian-rong-xing-jian-cha/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. 创建虚拟机

{% stepper %}
{% step %}
启动 VMware，选择“创建新的虚拟机” <img src="/files/07407903288eb890ac29c49b656ad8ab70fd6654" alt="" data-size="line">.

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

{% step %}
选择 **自定义**，点击 **下一步**。硬件-**Workstation 17.5 或更高版本，** 点击 **下一步。**\
![](/files/d11ca00512c1a0914431992e8cf837012663e134)![](/files/a13461a3cee58b1b16ab38834641c4e6ed2932df)
{% endstep %}

{% step %}
选择 **我将稍后安装操作系统**，点击 **下一步**.![](/files/991625c6c49f2a8c35c99b0f6f492799c77d679a)
{% endstep %}

{% step %}
选择 **选择来宾操作系统类型为 Linux > Other Linux 6.x kernel (64-bit)** 作为来宾操作系统类型。![](/files/adb550ea8c596bc13f3189d3c628b362a15a99f9)
{% endstep %}

{% step %}
将虚拟机命名为 **CUBE OS** 并选择存储位置。![](/files/d8f86626380dd519c2e4636dd620349f8998f336)
{% endstep %}

{% step %}
系统资源：

* **处理器**：2 核
* **内存**：4096MB（4GB）或更多\
  ![](/files/afa5cb5fcb9f8d4ccc27855dda6af7a687c45fa4)![](/files/b389fc67a3f1987a08c09b565fbedda7946d799e)
  {% endstep %}

{% step %}
网络 / I/O 控制器类型：

* 设置 **网络适配器** 为 **桥接** 模式（对局域网访问和发现很重要）。
* 设置 **控制器类型** 为 **LSI Logic** （为与虚拟磁盘兼容所需）。![](/files/f77e89b403e902b1b7714bd986cc7bc6c85c5772)![](/files/c8a76517fdffb8570ba64cdb6aa2384351c81b9a)
  {% endstep %}

{% step %}
选择磁盘类型 **SCSI（推荐），使用现有虚拟磁盘**.

![](/files/5c3d98fbeccadca6d440577355648065930a1a67)![](/files/a9e95b1288de49ff0bffd1833589fed0b3288e96)

{% endstep %}

{% step %}
点击 **浏览**，然后选择 CUBE OS `.vmdk` 和 **保持现有格式**.![](/files/5e15f01a3f734b19410886c705572a3e43a648c0)![](/files/d6abbe78df872b4a630d5af2bc3a3eac942b02a9)
{% endstep %}

{% step %}
点击“完成”以创建虚拟机。
{% endstep %}
{% endstepper %}

### 3. 配置虚拟机

{% stepper %}
{% step %}
选择已创建的虚拟机并点击“设置” ![](/files/cec7f1c1c047bfe627737ec2dfab238da7af27bc) 按钮。![](/files/01a264120b44d5e62b0f0b643d9c11a9060d34a4)
{% endstep %}

{% step %}
在“网络”选项卡下，确认网络连接为“**桥接**”并选择 **复制物理网络连接状态**.

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

{% step %}
在“选项”-“高级”选项卡下，设置 **固件类型** 为 **UEFI**. ![](/files/e14b3902deff9daa40bf03f950baaac0951b92d1)
{% endstep %}

{% step %}
**可选：** 如果使用 Zigbee USB 加密狗，确保已添加 **USB 控制器** 。在 **USB 控制器**下，启用 **显示所有 USB 输入设备。**

![](/files/4dee9ab2d083966e969e828c2aeb6c860e73d8f4)
{% endstep %}

{% step %}
点击“确定”以保存配置。
{% endstep %}
{% endstepper %}

### 4. 启动 CUBE OS

{% stepper %}
{% step %}
启动虚拟机。
{% endstep %}

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

![](/files/ca59431f03a7148a0c1d6e8a700003cda886e70f)
{% endstep %}

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

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/english-zh/kuai-su-kai-shi/quickstart/xu-ni-ji/vmware.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
