> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/service-providers/proxmox.md).

# Провайдер Proxmox

Данный тип сервис-провайдера предоставляет возможность публикации сервисов виртуальных рабочих столов в среде гипервизора ProxmoxVE.

## Создание сервис-провайдера <a href="#provider" id="provider"></a>

Для создания сервис-провайдера зайдите в раздел "Сервисы", нажмите "Новый" и выберите тип провайдера "Proxmox".

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox1.png" alt=""><figcaption></figcaption></figure>

### Основные настройки <a href="#main" id="main"></a>

**Имя (Name)** - наименование сервис-провайдера;

**Хост (Host)** - имя/IP-адрес кластера или сервера виртуализации Proxmox;

**Порт (Port)** - порт подключения;

**Имя пользователя (Username)** - имя пользователя с административными правами в ProxmoxVE, вводить в формате user\@authenticator;

**Пароль (Password)** - пароль от учётной записи пользователя.

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox2.png" alt=""><figcaption></figcaption></figure>

### Расширенные настройки <a href="#advanced" id="advanced"></a>

**Одновременное создание (Creation concurrency)** - количество одновременных задач создания рабочих столов;

**Одновременное удаление (Removal concurrency)** - количество одновременных задач удаления рабочих столов;

**Таймаут (Timeout)** - тайм-аут подключения к ProxmoxVE (в секундах);

**Диапазон MAC-адресов (Macs range)** - диапазон MAC-адресов для присвоения создаваемым виртуальным рабочим столам. Принимаются любые допустимые для Proxmox значения;

**Начальный VmId** - идентификатор ВМ, с которого брокер начнёт создавать ВМ в Proxmox (≥ 10000).

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox3.png" alt=""><figcaption></figcaption></figure>

## Создание сервисов <a href="#services" id="services"></a>

После завершения настройки провайдера откройте его параметры с помощью двойного щелчка, перейдите на вкладку "Сервисы", нажмите "Новый" и выберите тип создаваемого сервиса:

* Cвязанный клон Proxmox (Linked Clone Proxmox) - для публикации виртуальных рабочих столов на основе "золотого" образа.

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/proxmox4.png" alt=""><figcaption></figcaption></figure>

* Фиксированные машины Proxmox (Proxmox Fixed Machines) - для подключения пользователей к существующим виртуальным машинам платформы виртуализации. *Данный тип сервиса доступен начиная с версии брокера 4.0.*

### Связанные клоны <a href="#linked-clones" id="linked-clones"></a>

#### Основные настройки <a href="#linked-main" id="linked-main"></a>

**Имя (Name)** - наименование создаваемого сервиса;

**Пул (Pool)** - пул, в котором будут находиться ВМ, созданные брокером;

**Высокая доступность (HA)** - включать ли созданные ВМ в группу HA PVE;

**Сначала попробовать SOFT Shutdown (Try SOFT Shutdown first)** - если включено, брокер попытается выполнить контролируемое выключение виртуального рабочего стола перед его уничтожением.

#### Машина <a href="#linked-machine" id="linked-machine"></a>

**Базовая машина (Base Machine)** - "золотой" образ ВМ, используемый брокером для развертывания виртуальных рабочих столов;

**Хранилище (Storage)** - хранилище для размещения виртуальных рабочих столов. Поддерживаются типы хранилищ, позволяющие создавать снапшоты (Snapshot);

**Доступность GPU (GPU Availability)** - метод проверки доступности GPU;

**Имена машин (Machine Names)** - базовое имя машины, используемое для создаваемых виртуальных рабочих столов (например, CloneVM- );

**Длина имени (Name Length)** - длина числового суффикса, добавляемого к базовому имени машины (например, Длина имени = 2 -> CloneVM-00, CloneVM-01 и т.д).

### Фиксированные машины <a href="#fixed-machines" id="fixed-machines"></a>

> Данный тип сервиса доступен начиная с версии брокера 4.0.

#### Основные настройки <a href="#fixed-main" id="fixed-main"></a>

**Имя (Name)** - наименование создаваемого сервиса для отображения в системе.

**Токен сервиса (Service token)** - токен, используемый агентами для связи с сервисом (задается в виде произвольной последовательности букв и цифр). Если задано, брокер будет отслеживать "вход" и "выход" пользователя в сеанс ОС машины, и при выходе из сеанса автоматически освобождать машину, делая ее доступной для подключения другого пользователя. Если поле оставить пустым, машина будет оставаться постоянно закрепленной за пользователем (до ручного сброса администратором системы).

> Если поле `Токен сервиса` заполнено, на машины, заданные в качестве используемых сервисом, необходимо установить соответствующий агент VDI типа `Unmanaged`, и при его настройке задать такое же значение поля `Токен сервиса`, как и в настройках базового сервиса.

#### Машина <a href="#fixed-machine" id="fixed-machine"></a>

**Пул ресурсов (Resource Pool)** - пул ресурсов, в котором находятся машины.

**Машины (Machines)** - виртуальные машины выбранного пула ресурсов, предоставляемые пользователям данного сервиса. Отметьте нужные машины в списке.

#### Расширенные настройки <a href="#fixed-advanced" id="fixed-advanced"></a>

**Оставлять при ошибке (Keep on error)** - если включено, при обнаружении ошибок доступа к машине она не будет переведена в статус "Ошибка".

**Использовать снапшоты (Use snapshots)** - если включено, брокер попытается создать снапшот (если еще не создан) перед доступом к машине и восстановить ее состояние после использования.