Требования

Proxmox VE

• Proxmox VE 8.x, доступный по своему API.
• API-токен, которым Planeon сможет читать инвентарь кластера/узлов/хранилищ и управлять жизненным циклом (клонирование, старт/стоп, удаление) ВМ в пулах, которые вы ему назначите.

Управляющий контур (control plane)

Сервисам управляющего контура Planeon (API, worker, веб-консоль, gateway) нужны:

• PostgreSQL 16 или новее — источник истины платформы.
• Redis 7 или новее — очередь заданий, кэширование и короткоживущие токены подключения.
• Хост, ВМ или кластер Kubernetes для запуска сервисов управляющего контура. В качестве стартового ориентира 2 vCPU и 4 ГБ RAM достаточно для небольшого развёртывания; увеличивайте ресурсы вместе с числом одновременных сессий и пулов.

Сетевые пути

Откуда	Куда	Протокол / порт	Назначение
Администраторы и пользователи	Веб-консоль	HTTPS	Операторская консоль и портал самообслуживания
Администраторы и пользователи	API	HTTPS	REST API, на который опирается веб-консоль
Пользователи (сессии рабочего стола в браузере)	Gateway	WebSocket (WSS)	Туннелирует сессию рабочего стола в браузере
Gateway	guacd	Протокол Guacamole, порт 4822	Проксирует браузерную сессию к целевому рабочему столу
guacd	ВМ рабочих столов	RDP, порт 3389	Протокол удалённого рабочего стола до гостевой ОС
Управляющий контур	API Proxmox VE	HTTPS, порт 8006	Синхронизация инвентаря и операции жизненного цикла ВМ

В любом продакшен-развёртывании поставьте перед веб-консолью, API и gateway обратный прокси с терминацией TLS. Туннель браузерного рабочего стола, в частности, требует защищённого контекста (https:// / wss://) для полной функциональности, включая доступ к буферу обмена.

Поддержка браузеров

Актуальные версии Google Chrome, Microsoft Edge и Mozilla Firefox поддерживаются для операторской консоли и портала самообслуживания. В сессиях рабочего стола в браузере браузеры на базе Chromium (Chrome, Edge) дополнительно умеют в полноэкранном режиме перехватывать зарезервированные браузером сочетания клавиш (например, Ctrl+W или клавишу Windows) и передавать их удалённому рабочему столу; в Firefox сессии работают без такого перехвата — эти сочетания остаются за браузером. Ctrl+Alt+Del не может быть перехвачен веб-страницей ни в одном браузере и всегда доступен через специальную экранную кнопку на панели инструментов.

Операционные системы шаблонов

Пулы рабочих столов клонируются из подготовленного вами шаблона Proxmox VE. Поддерживаемые гостевые операционные системы:

• Windows 10, Windows 11
• Windows Server
• Основные дистрибутивы Linux с установленным xrdp для сессий рабочего стола

В каждом шаблоне должен быть установлен и включён QEMU guest agent — он нужен Planeon для определения ОС, настройки имени хоста и проверки готовности гостевой системы во время provisioning.

Дальнейшие шаги

Переходите к руководствам по установке, когда ваше окружение соответствует этим требованиям.