# 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FxS9FgoQHLLqdGBxwL1sn%2Fimage.png?alt=media&#x26;token=03d7070e-ea60-40fc-969b-8a0ed960253c" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8tc2J86zFiizshwgAIyV%2Fimage.png?alt=media&#x26;token=72f4b78a-91f6-4f9f-9c90-e0bbc7a14b91" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQdua3l1pnrtpcc7pPDAY%2Fimage.png?alt=media&#x26;token=2b570f43-4cc3-4a4f-9c8b-11dd4f4322e7" 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FpfdBgeDtrKo3OhYPAbXw%2Fimage.png?alt=media&#x26;token=61c86177-e2b1-4197-a73c-25ba0e54429e" 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6VyRJr87Bi24M9Ydjpf8%2Fimage.png?alt=media&#x26;token=12cdb23c-adc8-46ca-baa7-9990370ea565" 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FiPnpG4xmGCMdIlIDGg87%2Fimage.png?alt=media&#x26;token=175030f1-f975-4664-99c7-27bb7dcdcc17" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

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

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FfuXNaQrDKv2E81C1Gcqm%2Fimage.png?alt=media&#x26;token=d2cecdf6-ed34-4f9d-a029-0e407f742277" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FblP4P5F1uymfIC01W0ii%2Fimage.png?alt=media&#x26;token=a532cd47-0f32-406c-a7e0-7c0860e8a35e" alt="" width="369"><figcaption></figcaption></figure></div>
{% endstep %}

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

1. Оборудование **Выберите импортированный**
2. Добавить **→** Импортировать жёсткий диск ![](https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FHHAzYiA9dcGIaV5vySZI%2Fimage.png?alt=media\&token=bbc9c988-1529-45ee-b52b-afae61468e8e)**Затем перейдите в**

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FF69ghjcxJnIAPSqGtKWH%2Fimage.png?alt=media&#x26;token=0663b5a7-3c5f-4a76-a03a-a8a92bb73185" alt="" width="556"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FgFpqm3Cc2iT0egyb6ruO%2Fimage.png?alt=media&#x26;token=4916ed74-486c-4fbb-a805-550141c5dbc8" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
запустить ВМ и откройте![](https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FU63IlpRoEXQvlMX5UFfA%2Fimage.png?alt=media\&token=868c3c5e-174c-4b72-986d-32d3898b97a7) Консоль **Подождите несколько мгновений, пока CUBE OS инициализируется.**.

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Fp6ESYiONl9HLhsdjh5eb%2Fimage.png?alt=media&#x26;token=af9bf298-919c-4e53-8051-b2fa475f640a" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

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

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6DzbTjl6xb6J7QpxyiRU%2Fimage.png?alt=media&#x26;token=4fcbb889-05b1-431c-b356-a75786949d05" 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" 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="https://610313518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FzspXAwmgdYxXVKMFNKkn%2Fimage.png?alt=media&#x26;token=71363e03-aa40-4e59-a1d2-d3e30acfe487" alt="" width="370"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Reboot the VM (if required) and then add Zigbee devices in CUBE OS.
{% endstep %}
{% endstepper %}