> 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/virtualnaya-mashina/virtualbox.md).

# 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/1057648787178f8e9bf20b98715dcd5188290f40" alt="" data-size="original">

> Есть другие менеджеры виртуальных машин? Следующие шаги теоретически также можно использовать.\
> Не знакомы с виртуальными машинами и у вас есть Raspberry Pi? Вы можете выбрать установку CUBE OS на [Raspberry Pi](/cube-os-ru/nachalo-raboty/quickstart/raspberry-pi.md). \
> Если ни один из этих вариантов неприемлем, вы можете приобрести [iHost](https://sonoff.tech/products/sonoff-ihost-smart-home-hub/58) с предустановленным CUBE OS на официальном сайте SONOFF или на платформах вроде Amazon.
> {% 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, пожалуйста, обратитесь к этому [руководству](/cube-os-ru/proverka-sovmestimosti/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. Создание виртуальной машины:

{% stepper %}
{% step %}
Запустите VirtualBox

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

{% step %}
Выберите «Создать» <img src="/files/ae77450a918a4834801c50881b640e29269d0ebf" alt="" data-size="line"> или используйте сочетание клавиш «Ctrl + N».
{% endstep %}

{% step %}
Назовите виртуальную машину, выберите «Linux» как тип, «Other Linux» как подтип и «Other Linux (64-bit)» как версию.

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

{% step %}
В разделе «Оборудование» выделите объём памяти и количество процессоров для виртуальной машины. Рекомендуется 4 ГБ памяти и 2 CPU. Затем включите EFI.

<img src="/files/37f2892cd4b309bbafff539bd910f1ed0756433b" alt="" data-size="original">

{% hint style="info" %}
Важно: убедитесь, что EFI включён; иначе CUBE OS не загрузится.
{% endhint %}
{% endstep %}

{% step %}
В разделе «Жёсткий диск» выберите использование существующего файла виртуального жёсткого диска и укажите .vdi файл, извлечённый из [Шага подготовки 1.](#id-1-preparation)

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

{% step %}
Нажмите «Готово», чтобы создать виртуальную машину.
{% endstep %}
{% endstepper %}

### 3. Настройка виртуальной машины:

{% stepper %}
{% step %}
Выберите созданную виртуальную машину и нажмите кнопку «Настройки» <img src="/files/6fd0664a9179e25bfff2a670a02642baa37d4291" alt="" data-size="line"> .

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

{% step %}
На вкладке «Сеть» настройте подключение как «Сетевой мост (Bridged Adapter)» и выберите используемый сетевой адаптер.

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

{% step %}
В разделе «Аудио» включите звук и выберите опцию по умолчанию как контроллер.&#x20;

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

{% step %}
**Дополнительно:** Для использования Zigbee-донгла вставьте его на этом этапе и выберите правильный тип контроллера во вкладке «USB». В фильтре USB добавьте необходимый Zigbee-донгл с помощью кнопки добавления сбоку.

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

{% step %}
Нажмите «ОК», чтобы сохранить настройки.
{% endstep %}
{% endstepper %}

### 4. Загрузка CUBE OS

{% stepper %}
{% step %}
Нажмите кнопку "Запустить" <img src="/files/685e9e41430cdcd207198f7f1191f42d6f6c2739" alt="" data-size="line">.

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

{% step %}
Наблюдайте за экраном загрузки до завершения процесса.

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

{% step %}
После завершения на экране будет отображён IP-адрес CUBE OS. Используйте этот IP-адрес или [cube.local](http://cube.local) чтобы получить доступ к веб-интерфейсу управления CUBE OS.

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

{% step %}
После успешного доступа на странице настроек можно увидеть короткий идентификатор. Впоследствии получайте доступ к веб-интерфейсу CUBE OS используя `cube-{short id}.local`, что удобно для различения нескольких экземпляров CUBE OS в одной локальной сети.

<img src="/files/b85f6e432ac5c7689a778e38ba8ce809acf8523d" 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/cube-os-ru/nachalo-raboty/quickstart/virtualnaya-mashina/virtualbox.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.