> 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/cube-os-ru/nachalo-raboty/quickstart/ustanovka-v-odin-klik/windows.md).

# Windows

Это руководство показывает, как установить CUBE OS на Windows с помощью установщика в один клик. Установщик настраивает VirtualBox, создаёт виртуальную машину и запускает CUBE OS за вас.

### 1. Подготовка

{% stepper %}
{% step %}
**Проверьте свой ПК с Windows**

Убедитесь, что ваш ПК соответствует этим требованиям:

* **ОС**: Windows 10 или Windows 11, 64-разрядная
* **ЦП**: 2 ядра или больше
* **Память**: 4 ГБ ОЗУ или больше
* **Сеть**: Стабильный доступ к интернету и LAN
* **Права**: Права администратора в Windows
*

{% endstep %}

{% step %}
**Скачайте установщик**

Перейдите на [страницу релизов CUBE OS](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) и скачайте **установщик в один клик для Windows**.

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

{% step %}
**Адаптер Zigbee (необязательно)**

Если вам нужно добавить устройства Zigbee, подготовьте Zigbee-ключ. Проверенные Zigbee-ключи включают:

Перед подключением адаптера Zigbee к Windows установите соответствующий USB-драйвер последовательного порта для чипсета ключа:

* **CP210x** — [Драйверы Silicon Labs CP210x USB to UART Bridge VCP](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
* **CH34x** — [USB-драйвер последовательного порта WCH CH341/CH34x](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/d05b964aec496758336e7d2c676c5085d6dd9fb9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Позвольте установщику проверить VirtualBox**

Установщик проверяет, доступен ли VirtualBox на вашем ПК. Если VirtualBox не установлен, следуйте инструкциям на экране, чтобы сначала установить его.

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

{% step %}
**Настройте ресурсы виртуальной машины**

Выберите имя виртуальной машины, объём памяти и количество ядер ЦП. Рекомендуемые настройки:

* **Память**: 2048 МБ или больше
* **ЦП**: 2 ядра или больше

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

{% step %}
**Выберите сетевой адаптер с мостом**

Выберите активный сетевой адаптер на вашем ПК. Используйте адаптер с мостом, чтобы CUBE OS мог подключиться к вашей локальной сети.

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

{% step %}
**Необязательно: настройте проброс USB**

Если вы используете Zigbee-ключ, выберите USB-устройство из списка. Если Zigbee сейчас не нужен, пропустите этот шаг.

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

{% step %}
**Начните установку**

Установщик распакует необходимые файлы и автоматически создаст виртуальную машину CUBE OS. Подождите, пока процесс завершится, затем нажмите **Готово**.

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

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

### 3. Запуск и доступ к CUBE OS

{% stepper %}
{% step %}
**Подождите, пока CUBE OS запустится**

После установки виртуальная машина автоматически запускается в VirtualBox. После завершения загрузки консоль показывает IP-адрес CUBE OS.

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

{% step %}
**Откройте веб-консоль CUBE OS**

Откройте браузер в той же сети и перейдите по одному из этих адресов:

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

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

{% step %}
**Используйте позже короткий локальный адрес**

После настройки вы можете найти короткий ID на странице настроек. Затем вы можете использовать `cube-{short-id}.local` чтобы идентифицировать этот экземпляр CUBE OS в вашей локальной сети.

<div align="left"><figure><img src="/files/3e02c88db56eb91719f9fba3838bd451db20a4fa" 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:

```
GET https://cube.ewelink.cc/cube-os-ru/nachalo-raboty/quickstart/ustanovka-v-odin-klik/windows.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.