# 4.0

## 4.0-1 <a href="#id-40-1" id="id-40-1"></a>

Версия: 4.0\
Выпуск: 1\
Дата релиза: 2026.09.03\
Статус релиза: Бета ([подробнее о жизненном цикле версий](/url/kb.pvhostvm.ru/hostvm-vdi/release-notes/life-cycle.md))

### Общие изменения <a href="#general-changes" id="general-changes"></a>

* Операционная система в готовых образах виртуальных машин брокера, туннелера, сервера БД, балансировщика обновлена до Debian версии 12.
* Минимальные системные требования к ресурсам машин:
  * Брокер - 4 vCPU / 4 vRAM / 16 vDisk;
  * Туннелер - 4 vCPU / 4 vRAM / 20 vDisk;
  * Сервер БД - 2 vCPU / 3 vRAM / 24 vDisk.
* Минимальные системные требования к версии СУБД:
  * MariaDB - 10.6 и выше;
  * PostgreSQL - 15 и выше.
* Совместимые версии ОС для установки пакетов брокера и туннелера 4.0:
  * Debian 12 (Bookworm);
  * РЕД ОС 8;
  * Альт Сервер 11.
* Дистрибутивы клиента для поддерживаемых ОС больше не распространяются в составе пакета брокера hostvm-vdi, а выделены в отдельный пакет hostvm-vdi-clients для установки (за исключением готовых образов виртуальных машин).
* Дистрибутивы агента для поддерживаемых ОС больше не распространяются в составе пакета брокера hostvm-vdi, а выделены в отдельный пакет hostvm-vdi-actors для установки (за исключением готовых образов виртуальных машин).

### Брокер <a href="#broker" id="broker"></a>

#### Сервис-провайдеры <a href="#service-providers" id="service-providers"></a>

* В настройки базовых сервисов добавлен выбор метода подсчета максимального количества сервисов:
  * `Стандартный` - режим, совместимый с предыдущими версиями. Учитываются только машины в состоянии "Подготавливается" и "Верный";
  * `Консервативный` - режим, в котором при расчете учитываются также машины, помеченные на удаление и находящиеся в состоянии "Удаляется", до момента их фактического удаления с платформы виртуализации.
* \[Горизонт-ВС] Добавлен сервис-провайдер платформы виртуализации Горизонт-ВС ([подробнее о настройке](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/service-providers/gorizont-vs.md)).
* \[RDS / Linux terminal] \[RDS (legacy)] \[Провайдер машин со статическим IP / Статический множественный IP адрес] Параметр `Список серверов` заменен на `Группа серверов`. Доступные для выбора группы задаются в новом разделе панели управления ["Сервисы/Серверы"](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/servers.md).
* \[HOSTVM / РОСА/ zVirt / РЕД Виртуализация] \[oVirt] \[OpenStack] \[Proxmox] \[VMware] \[Xen] В настройки базовых сервисов связанных клонов добавлен параметр `Сначала попробовать SOFT Shutdown` - "мягкое" завершение работы ОС (shutdown) клонов, которые подлежат удалению (по умолчанию используется принудительное выключение (poweroff) для ускорения завершения задачи и снижения нагрузки на СХД).
* \[OpenStack] \[Proxmox] \[VMware] \[Xen] Добавлен базовый сервис фиксированных машин, позволяющий создавать пулы из имеющихся в системе виртуализации машин, с возможностью управления сессий пользователя через unamanged агент, а также использованием снапшотов для сброса состояния машины (на поддерживаеммых платформах: Proxmox, VMware, Xen).
* \[OpenStack] \[Proxmox] \[VMware] \[Xen] В настройки базовых сервисов связанных клонов добавлен параметр `Удалять найденные дубликаты` - автоматическое удаление брокером существующих машин на платформе виртуализации при совпадении имени с создаваемым клоном.
* \[OpenStack] \[Proxmox] \[Xen] В сервисы связанных клонов добавлена опция `put back to cache`, позволяющая возвращаться ранее назначенные пользователям машины в кэш пула, вместо их удаления и пересоздания, позволяя сократить время подготовки рабочих столов и снизить нагрузку на СХД.
* \[VMware] добавлена совместимость с VMware vSphere 8.0.
* \[VMware] добавлена настройка проверки SSL сертификата.
* \[Proxmox] добавлена совместимость с Proxmox 9.0.
* \[Proxmox] добавлена возможность использования полных клонов (full clone) на поддерживаемых типах хранилищ.

#### Аутентификаторы <a href="#authenticators" id="authenticators"></a>

* В расширенные настройки добавлена возможность настройки доступности аутентификатора для заданных сетей источника подключения.
* Новая настройка видимости аутентификаторов, позволяет выбрать один из трех вариантов:
  * `Visible` отображается в списке доступных на портале входа в систему;
  * `Hidden` не отображается в списке доступных на портале, но возможен доступ через тэг (по прямой ссылке);
  * `Disabled` возможность входа через аутентификатор полностью отключена.
* В контекстное меню пользователя добавлена возможность временного включения отправки логов клиента VDI в режиме отладки на брокер (на 48 часов). Эти логи доступны к просмотру в журнале назначенного пользователю сервиса, а также в файле uds.log брокера.
* \[OAuth2] Добавлен аутентификатор с поддержкой протокола OAuth 2.0 ([подробнее о настройке](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/authenticators/oauth2.md)).
* \[Active directory] добавлена возможность указать дополнительные адреса серверов AD для подключения, на случай недоступности основного сервера.
* \[МФА / Radius OTP] добавлена возможность добавления в запрос атрибута Message-Authenticator.

#### Транспорты <a href="#transports" id="transports"></a>

* Значение параметра `Туннельный сервер` на вкладке "Туннель" соответствующих типов транспортов более не задается вручную. Доступные для выбора туннелеры задаются в новом разделе панели управления ["Подключение/Туннели"](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/tunnels.md).
* В расширенные настройки транспортов добавлена настройка правил сетевой фильтрации: отключить фильтрацию, разрешить доступ для выбранных сетей, запретить доступ для выбранных сетей.
* \[RDS RemoteApp] \[RemoteApp (legacy)] Изменено значение по умолчанию параметра `Linux Client / версия FreeRDP` на `3.x`. При наличии на клиенте FreeRDP версии 3, он будет использоваться для подключения в первую очередь (для версии клиента 4.0).
* \[RDP] добавлена поддержка клиента Thincast (Linux, Mac).

#### Панель управления <a href="#dashboard" id="dashboard"></a>

* \[Сервисы / Серверы] Новый раздел для централизованной настройки параметров серверов для провайдеров Static IP и RDS, с возможностью объединения в группы из нескольких серверов. После добавления группы серверов можно использовать в настройках соответствующих провайдеров, без ручного занесения адресов подключения ([подробнее о настройке](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/servers.md)).
* \[Подключение / Туннели] Новый раздел для централизованной настройки параметров используемых туннелеров (адрес/url подключения, порт). После добавления их можно использовать в настройках транспортов на вкладке "Туннель", вместо ручного внесения параметров подключения ([подробнее о настройке](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/tunnels.md)).
* \[Инструменты / Нотификаторы] Новый функционал отправки уведомлений о событиях, фиксируемых в журналах брокера (уровень от Warning до Critical) через внешние системы (email, telegram) ([подробнее о настройке](/url/kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/notifiers.md)).
* \[Инструменты / Токены / Агент] В записи зарегистрированных агентов добавлена информация по версии агента и типе ОС, на которую он установлен (только для агентов версии 4.0).
* \[Инструменты / Токены ] Подраздел "Туннель" переименован в "Серверы", в нем отображаются зарегистрированные на брокере туннелеры.
* \[Конфигурация / Security] Новый параметр "Allowed IP forwarders" - ограничение списка ip адресов/сетей, для которых разрешена отправка x-forwarder-for заголовков (например балансировщики нагрузки).
* \[Конфигурация / Custom] Добавлена возможность настройки cookies consent urls.

#### Прочие изменения <a href="#other-broker-changes" id="other-broker-changes"></a>

* Информация по операциям сервис-провайдеров (создание, удаление, кэширование, назначение ВМ), выполняемым в сервис-пулах, заносится в новый файл журнала брокера `operations.log`.
* \[Сервис-пулы] Добавлена возможность отображения сообщения пользователям при подключении к пулу. При прочтении сообщения пользователю доступна возможность как продолжить подключение, так и прервать его. Для отображения сообщения необходимо активировать параметр "Включить сообщение при запуске" и задать "Текст сообщения при запуске" на вкладке "Экран/Дисплей" параметров пула.
* \[Мета-пулы] Добавлена настройка политики высокой доступности мета-пула. Если политика активна, при недоступности сервис-пула, входящего в мета-пул, сервисы пользователей будут автоматически запущены в следующем пуле, согласно заданной политике балансировки нагрузки.
* \[Портал пользователя] \[Панель управления] Добавлена тёмная тема (переключение по сочетанию клавиш `ctrl+alt+b`).

### Туннелер <a href="#tunneler" id="tunneler"></a>

#### HTML5 <a href="#html5" id="html5"></a>

Обновлены компоненты, обеспечивающие функционал HTML5 подключений:

* улучшена производительность рендеринга - более эффективная утилизация ресурсов сервера, повышение скорости отклика и снижение требуемой пропускной способности сети;
* добавлена поддержка Graphics Pipeline Extension (GFX) для RDP.

Исправлены следующие ошибки:

* \[HTML5 RDP] ошибка подключения, если в транспорте включен проброс микрофона в сессию;
* \[HTML5 RemoteApp] после сворачивания окна презентованного приложения пользователю остается виден лишь пустой рабочий стол сессии;
* \[HTML5 RemoteApp] в случае, если указан неверный алиас приложения RemoteApp либо оно не опубликовано, при подключении пользователю отображается черный экран, без сообщения об ошибке и выхода из сессии;
* \[HTML5] не сбрасывается изображение во вкладке браузера, если сессия на конечном сервере более не действительна.

#### Общие изменения <a href="#general-tunneler-changes" id="general-tunneler-changes"></a>

* Повышение производительности и стабильности туннельных подключений.
* Доработка журналирования ошибок подключений для упрощения диагностики.

### Клиент <a href="#client" id="client"></a>

* Обновлены системные требования для установки на Linux-based ОС: требуемая версия Python - 3.9 и выше.
* В журналы клиента добавлена информация об ошибках SSL подключения к туннелеру.
* Добавлена возможность отправки логов клиента на брокер для удаленной диагностики проблем с подключением.
* Обратная совместимость с компонентами VDI версии 3.6 (без нового функционала):
  * возможно использование клиента версии 3.6 с брокером/туннелером версии 4.0.

### Агент <a href="#actor" id="actor"></a>

* Обновлены системные требования для установки на Linux-based ОС: требуемая версия Python - 3.9 и выше.
* При регистрации на брокер дополнительно отправляется информация о версии агента и используемой ОС \[Панель управления / Инструменты / Токены / Агент].
* Повышена стабильность соединения с брокером при ошибках сети.
* Поддержка предыдущих релизов:
  * возможно использование агента версии 3.6 с брокером версии 4.0 (без нового функционала);
  * удалена поддержка legacy агента версии 2.2 (python 2.7), дистрибутивы исключены из состава выпуска.


---

# 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 http://localhost:3000/url/kb.pvhostvm.ru/hostvm-vdi/release-notes/changelog/4.0.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.