> 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/yi-jian-an-zhuang/windows.md).

# Windows

本指南将向你展示如何使用一键安装程序在 Windows 上安装 CUBE OS。该安装程序会为你安装 VirtualBox、创建虚拟机并启动 CUBE OS。

### 1. 准备

{% stepper %}
{% step %}
**检查你的 Windows 电脑**

确保你的电脑满足以下要求：

* **操作系统**: Windows 10 或 Windows 11，64 位
* **CPU**: 2 核或以上
* **内存**: 4 GB 内存或以上
* **网络**: 稳定的互联网和局域网访问
* **权限**: Windows 管理员权限
*

{% endstep %}

{% step %}
**下载安装程序**

前往 [CUBE OS 发布页面](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) 并下载 **Windows 一键安装程序**.

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

在将 Zigbee 适配器连接到 Windows 之前，请为该加密狗芯片组安装相应的 USB 串口驱动：

* **CP210x** — [Silicon Labs CP210x USB 转 UART 桥接 VCP 驱动程序](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
* **CH34x** — [WCH CH341/CH34x USB 串口驱动程序](https://www.wch-ic.com/downloads/CH341SER_EXE.html)

{% hint style="info" %}
如果 Windows 在安装程序或 VirtualBox 中没有检测到该加密狗，请拔下适配器，安装驱动程序，然后重新连接。
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. 使用一键安装程序安装 CUBE OS

{% stepper %}
{% step %}
**以管理员身份运行安装程序**

在以下位置找到安装程序文件： **下载** 或你选择的文件夹中。右键单击它并选择 **以管理员身份运行**.

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

{% step %}
**让安装程序检查 VirtualBox**

安装程序会检查你的电脑上是否可用 VirtualBox。如果尚未安装 VirtualBox，请先按照屏幕上的步骤进行安装。

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

{% step %}
**设置虚拟机资源**

选择虚拟机名称、内存和 CPU 核数。推荐设置：

* **内存**: 2048 MB 或以上
* **CPU**: 2 核或以上

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

{% step %}
**选择桥接网络适配器**

在你的电脑上选择一个活动的网络适配器。使用桥接适配器，以便 CUBE OS 能加入你的本地网络。

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

{% step %}
**可选：配置 USB 直通**

如果你使用 Zigbee 加密狗，请从列表中选择 USB 设备。如果你现在不需要 Zigbee，请跳过此步骤。

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

{% step %}
**开始安装**

安装程序会自动解压所需文件并创建 CUBE OS 虚拟机。请等待过程完成，然后点击 **完成**.

<div align="left"><figure><img src="/files/1b0784c73879f6337b5024b9ce5a3223ee0daa7b" alt="" width="375"><figcaption></figcaption></figure></div>

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

### 3. 启动并访问 CUBE OS

{% stepper %}
{% step %}
**等待 CUBE OS 启动**

安装完成后，虚拟机会在 VirtualBox 中自动启动。启动完成后，控制台会显示 CUBE OS 的 IP 地址。

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

{% step %}
**打开 CUBE OS Web 控制台**

在同一网络中打开浏览器并访问以下地址之一：

* `http://<CUBE_OS_IP>/`
* <http://cube.local>

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

{% step %}
**稍后使用简短的本地地址**

设置完成后，你可以在设置页面找到简短 ID。然后你可以使用 `cube-{short-id}.local` 来在你的局域网中识别此 CUBE OS 实例。

<div align="left"><figure><img src="/files/16045584c1e6ccf3f20360f66ffb189dcff01aaf" alt="" width="375"><figcaption></figcaption></figure></div>
{% 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/yi-jian-an-zhuang/windows.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.