# 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">
{% endstep %}

{% step %}
**Zigbee-адаптер (опционально)**

Если нужно добавить Zigbee-устройства, подготовьте Zigbee-донгл. Протестированные Zigbee-донглы включают:
{% 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: 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/virtualnaya-mashina/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.