# Proxmox

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

{% stepper %}
{% step %}
**Скачайте образ CUBE OS**

Посетите этот [репозиторий](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) чтобы скачать последний образ CUBE OS и распаковать его после загрузки.

Для Proxmox VE 9 скачайте архив с образом диска (обычно `sdcard.vmdk.xz`).

Распакуйте его, чтобы получить `.vmdk` файл.
{% endstep %}

{% step %}
**Подготовьте хост Proxmox VE**

* Рабочий **Proxmox VE** хост с правами администратора (Web UI + Shell/SSH)
* Если вы ещё не установили Proxmox VE, следуйте официальному [руководству](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* Рекомендуемые ресурсы для ВМ:
  * **CPU**: 2 ядра
  * **Память**: 4096 МБ (4 ГБ) или больше
    {% endstep %}

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

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

Вы можете пробросить ключ в ВМ в Proxmox (см. необязательный раздел ниже).
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
В Web UI Proxmox нажмите **Создать ВМ**.

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

{% step %}
**Общие -** Установите ID ВМ и имя, например `CUBE OS`.

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

{% step %}
**ОС -** Выберите **Не использовать медиа**.

<div align="left"><figure><img src="/files/8331b66a975d99360bb6854a8977cf1ecdf5e232" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
CUBE OS предоставляется как предварительно собранный образ диска. В Proxmox вы **импортируете образ диска** а затем загрузитесь с него.
{% endhint %}
{% endstep %}

{% step %}
**Система -** Рекомендуемые настройки:

* **BIOS**: `OVMF (UEFI)`
* **EFI диск**: добавьте EFI-диск (размер по умолчанию подходит)
* **Предварительные ключи Enfoll**: Снимите галочку

<div align="left"><figure><img src="/files/7c4d6105cd3d9920632e528bf5e11ff35d760f88" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Как и в руководствах для VirtualBox/VMware, **UEFI требуется**. Если загрузка не происходит, дважды проверьте, что в BIOS установлено **OVMF (UEFI)**.
{% endhint %}
{% endstep %}

{% step %}
**Диск / CPU / Память / Сеть**

* **Диск**: не **создавайте новый пустой диск. Вы импортируете образ диска CUBE OS в следующем разделе.** : 2 ядра (рекомендуемый тип CPU
* **CPU**host `)` Сеть
* **Память**: 4096 МБ (4 ГБ) или больше
* **Мост**:

  * **vmbr0**: `(или ваш LAN-мост)` Модель
  * **VirtIO (паравиртуализованный)**: `Для надежной работы обнаружения в локальной сети и`

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

{% hint style="warning" %}
cube.local `избегайте сетей в стиле NAT. Используйте` мостовую **сеть, подключённую к вашей домашней/офисной LAN.** 3. Импорт образа диска CUBE OS в Proxmox
{% endhint %}
{% endstep %}
{% endstepper %}

### Вы импортируете распакованный образ CUBE OS (например

CUBE-OS.vmdk `) и подключите его в качестве загрузочного диска ВМ.`Найдите подходящее хранилище (

{% stepper %}
{% step %}
**local`, а не`local-lvm `В левой боковой панели Web UI Proxmox нажмите`).** (не **, а не** Загрузить **В левой боковой панели Web UI Proxmox нажмите**).

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

{% step %}
**в `.vmdk` Нажмите `, а не`**

1. Импорт **Выберите распакованный образ диска на вашем компьютере, например:**
2. sdcard.vmdk
   * `Подождите, пока загрузка не завершится (800+ МБ может занять некоторое время)`
3. После завершения вы должны увидеть файл в списке

<div align="left"><figure><img src="/files/bed652ad15997f3cc25bf45291c28c3606a7c94a" alt="" width="563"><figcaption></figcaption></figure></div>

Контент **.** Подключите импортированный диск и установите его как загрузочный.

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

{% step %}
**В ВМ CUBE OS:** Перейдите в

1. Оборудование **Выберите импортированный**
2. Добавить **→** Импортировать жёсткий диск ![](/files/52bd37ebbd4b908be243a9163ec612898236ee84)**Затем перейдите в**

<div align="left"><figure><img src="/files/280cd3b6de4170ea4e40bfb14cf86939ef7cd16c" alt="" width="556"><figcaption></figcaption></figure></div>

3. Опции → Порядок загрузки **и установите импортированный диск как первое загрузочное устройство.** 4. Загрузка CUBE OS

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

### Нажмите, чтобы

{% stepper %}
{% step %}
запустить ВМ и откройте![](/files/9039e52d5df893208aa9bf3e2d5bcfe197df7ef3) Консоль **Подождите несколько мгновений, пока CUBE OS инициализируется.**.

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

{% step %}
После завершения загрузки вы увидите

IP-адрес **отображённым в консоли.** Откройте Web UI CUBE OS

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

{% step %}
Посетите

* http\://\<CUBE\_OS\_IP>/ `, или`Попробуйте:
* <http://cube.local> [После успешного доступа на странице настроек можно увидеть короткий идентификатор. Затем доступ к веб-странице управления CUBE OS можно получить по адресу](http://cube.local)

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

cube-{short id}.local `, что полезно для различения нескольких экземпляров CUBE OS в одной локальной сети.`5. (Необязательно) Проброс USB-ключа Zigbee (Proxmox)

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

### Подключите Zigbee-ключ к хосту Proxmox.

{% stepper %}
{% step %}
В ВМ перейдите в
{% endstep %}

{% step %}
Оборудование → Добавить → USB-устройство **Предпочтительно выбирать по**.

* ID производителя/устройства **(более стабильно, чем по порту, если вы меняете USB-порты).** Если ваш ключ предоставляет последовательный интерфейс, он также может появиться в разделе
* Добавить → Последовательный порт **в зависимости от вашей конфигурации.** Перезагрузите ВМ (если требуется), затем добавьте устройства Zigbee в CUBE OS.

<div align="left"><figure><img src="/files/15c97eb3a77d4a346d2180c972db5a01188d1949" alt="" width="370"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Reboot the VM (if required) and then add Zigbee devices in CUBE OS.
{% 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/proxmox.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.