Документация · версия 1.1.7

Руководство пользователя xConsole

Установка, подключение к платформам виртуализации, работа со списком ВМ, консолями, группами и горячими клавишами.

Windows Linux macOS Android Без SSH и VPN
01 · Начало работы

Быстрый старт

xConsole — нативный клиент для управления виртуальной инфраструктурой. Для начала нужны установленный клиент, доступ к платформе виртуализации и учётная запись.

01

Установите клиент

Запросите дистрибутив для своей ОС: Windows, Linux, macOS или Android.

Как получить дистрибутив
02

Добавьте платформу

В списке ВМ нажмите «Добавить кластер» и укажите адрес платформы и учётные данные.

03

Войдите через SSO

Клик по заголовку кластера запускает вход. xConsole сам загрузит список виртуальных машин.

04

Откройте консоль

Выберите ВМ и нажмите Enter. Консоль откроется в новой вкладке.

Один клиент — весь парк. В один список можно добавить несколько кластеров. Сессии кластеров изолированы, а поиск работает сразу по всем подключённым платформам.
02 · Подключение

Подключение к платформе

Кластер — это платформа виртуализации, к которой подключается xConsole. Каждый кластер хранит свой адрес, настройки SSO и учётные данные.

Добавление кластера

  1. В списке ВМ нажмите «Добавить кластер».
  2. Укажите имя кластера и адрес платформы виртуализации.
  3. При необходимости задайте отдельный адрес SSO. Если поле пустое, адрес выводится из адреса платформы.
  4. Введите логин и пароль. Пароль можно сохранить — он будет зашифрован.
  5. Нажмите «Войти» или Enter.

Если у платформы самоподписанный сертификат

В параметрах кластера включите пропуск проверки TLS или укажите корневой сертификат CA. Для запуска из командной строки доступны ключи --insecure и --ca <file>.

Несколько кластеров

Кластеры показываются отдельными группами в общем списке. У каждого кластера своя сессия, поэтому одинаковые имена или GUID машин в разных кластерах не смешиваются. Поиск учитывает имя кластера, адрес платформы и логин.

Меню кластера

ДействиеКак
Открыть или свернуть список ВМКлик по заголовку кластера или Enter
Параметры подключенияПравый клик по заголовку → «Параметры»
Отключить или включить кластерПравый клик по заголовку → «Отключить» / «Включить»
Удалить кластерПараметры кластера → удаление
03 · Список ВМ

Список виртуальных машин

Список показывает кластеры и их виртуальные машины. Для выбранной ВМ справа открывается сводка: параметры, мониторинг ЦП и памяти, кнопки питания.

Поиск и фильтр

  • Ищите по имени ВМ, GUID, имени кластера, адресу платформы или логину.
  • Фильтр статуса переключается кнопкой справа от поиска или клавишей S: все → работающие → остановленные.
  • Esc в поле поиска сбрасывает запрос.

Основные действия

ДействиеКак
Подключиться к ВМEnter или клик по активной строке
Открыть консоль сразуShift + Enter или Shift + клик
Контекстное меню ВМПравый клик по строке
Обновить все кластерыR
Навигация по спискуСтрелки, PageUp/PageDown, Home/End
Подключение в фоне. Вкладка консоли открывается сразу, а соединение устанавливается в фоне. Список и другие вкладки при этом остаются доступны.
04 · Консоли

Консоли и вкладки

Каждая открытая ВМ получает вкладку. Вкладки можно переключать, переставлять, сворачивать и закрывать. Вкладка «Виртуальные машины» закреплена первой.

Панель инструментов консоли

  • Ввод логина и пароля гостевой ОС.
  • Питание: старт или стоп в зависимости от состояния ВМ.
  • Перезагрузка, жёсткая перезагрузка и жёсткий стоп.
  • Буфер обмена: Ctrl+Shift+V вставляет локальный текст в гостевую ОС.

Вкладки

ДействиеКак
Переключить вкладкуCtrl+Tab, Ctrl+Shift+Tab или Ctrl+1…9
Переставить вкладкуПеретащить вкладку мышью
Закрыть вкладкуCtrl+Shift+W, средняя кнопка мыши или крестик
Свернуть консольCtrl+Alt+Shift+M
Отключиться и вернуться к спискуCtrl+Alt+Shift+Q
Полноэкранный режимCtrl+Alt+Shift+F

Переподключение

Если соединение разорвалось, вкладка остаётся открытой и переподключается автоматически. При ошибке первого подключения показывается причина и кнопка «Повторить». Esc во время подключения закрывает вкладку.

05 · Группы

Группы консолей

Одна вкладка может содержать несколько консолей. Это удобно, когда нужно одновременно смотреть логи, терминал БД и интерфейс приложения.

Раскладка

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

Добавление, перенос и обмен

  • Добавить консоль в группу: перетащите вкладку или панель на нужную вкладку.
  • Вынуть консоль в отдельную вкладку: перетащите панель на свободное место полосы вкладок.
  • Поменять панели местами: перетащите шапку одной панели на другую.
  • Новая пустая вкладка: Ctrl+Alt+Shift+T. Заполните её, перетащив ВМ.
  • Сбросить сетку: Ctrl+Alt+Shift+/.

Мультиввод

Клик с Ctrl по шапке панели добавляет её в набор для общего ввода. Ввод с клавиатуры уходит во все выбранные панели. Включить или выключить синхронный ввод можно сочетанием Ctrl+Alt+Shift+A.

Сохранение группы

  1. Соберите нужные консоли в одной вкладке и настройте раскладку.
  2. Нажмите «Сохранить группу» внизу консоли.
  3. Задайте имя группы.
  4. Откройте сохранённую группу из списка кластеров. Состав и раскладка восстановятся.

Сохранённые группы находятся внизу списка ВМ. Открыть, переименовать или удалить группу можно из её контекстного меню.

Совет. Для повторяющегося рабочего места — например, «API + БД + логи» — сохраните группу под понятным именем. При следующем запуске достаточно открыть её одним действием.
06 · Клавиши

Горячие клавиши

Основные сочетания xConsole. Полная справка доступна в приложении по кнопке «Справка» на панели действий.

Список ВМ

КлавишиДействие
↑ ↓ PageUp PageDownНавигация по списку
EnterПодключиться к выбранной ВМ
Shift + EnterПодключиться и сразу открыть консоль
RОбновить список
SПереключить фильтр статуса
EscСбросить поиск

Консоль и группы

КлавишиДействие
Ctrl + Shift + VВставить локальный буфер в гостевую ОС
Ctrl + Alt + Shift + FПолноэкранный режим
Ctrl + Alt + Shift + MСвернуть консоль, сохранив сессию
Ctrl + Alt + Shift + QОтключиться и вернуться к списку
Ctrl + Alt + Shift + TНовая вкладка с пустой панелью
Ctrl + Alt + Shift + /Сбросить сетку группы
Ctrl + Alt + Shift + AСинхронный ввод во все консоли вкладки
Ctrl + клик по панелиДобавить панель в набор для мультиввода
Двойной клик по шапке панелиРазвернуть панель на всю область
Перетаскивание разделителяИзменить размер панелей
07 · Безопасность

Безопасность и доступы

xConsole работает через аккаунт платформы и не требует открывать SSH или VPN. Доступы хранятся в зашифрованном виде, а сессии кластеров изолированы.

  • Конфигурация кластеров шифруется AES-256-GCM.
  • Пароли не хранятся на диске в открытом виде.
  • У каждого кластера отдельная сессия и свой набор cookie.
  • Соединения защищены TLS. Для самоподписанных сертификатов можно указать CA или включить пропуск проверки.
  • Внутренние сети остаются закрытыми: SSH и VPN для консоли не нужны.

Где хранятся настройки

ОСФайл конфигурации
Linux$XDG_CONFIG_HOME/dynamix-console/clusters.enc или ~/.config/dynamix-console/clusters.enc
Windows%APPDATA%\dynamix-console\clusters.enc
macOS~/.config/dynamix-console/clusters.enc

Ключ шифрования хранится отдельно от файла конфигурации. Не передавайте файл конфигурации и ключ третьим лицам.

08 · Платформы

Платформы и установка

Версия 1.1.7. Для каждой ОС — нативная сборка. Дистрибутивы предоставляются по запросу: оставьте заявку, и мы пришлём подходящий файл и инструкцию по установке.

Windows

Установщик NSIS, x86_64.

Запросить .exe

macOS

Universal: Intel и Apple Silicon. Откройте .dmg и перетащите приложение в Applications.

Запросить .dmg

Linux

AppImage, DEB для Ubuntu 24.04 и RPM для Fedora 42.

Запросить сборку

Android

Мобильная сборка APK. Установите файл, разрешив установку из неизвестных источников.

Запросить .apk

Команды для Linux

# AppImage
chmod +x xConsole-1.1.7-AppImage-x86_64.AppImage
./xConsole-1.1.7-AppImage-x86_64.AppImage

# Ubuntu / Debian
sudo apt install ./xConsole-1.1.7-Ubuntu2404-x86_64.deb

# Fedora
sudo dnf install ./xConsole-1.1.7-Fedora42-x86_64.rpm
09 · Диагностика

Диагностика и частые вопросы

Не удаётся войти в кластер

Проверьте адрес платформы и SSO, логин и пароль. Для самоподписанного сертификата укажите CA или включите пропуск проверки TLS в параметрах кластера.

Консоль не подключается

Убедитесь, что ВМ запущена и платформа доступна. При ошибке первого подключения вкладка показывает причину и кнопку «Повторить». Esc закрывает вкладку.

Соединение разорвалось

Вкладка переподключится автоматически с нарастающей паузой. Дождитесь восстановления или закройте вкладку и подключитесь заново.

Не работает вставка из буфера обмена

Используйте Ctrl+Shift+V. Синхронизация буфера включена по умолчанию; проверьте, что приложение запущено без флага --no-clipboard.

Как сбросить раскладку группы

Нажмите Ctrl+Alt+Shift+/ или пересоберите группу перетаскиванием панелей.

Где посмотреть подробности подключения

Запустите xConsole с ключом --verbose. В консоль будут выведены детали SSO, API и VNC-подключения.

Полезные ключи командной строки

КлючНазначение
--sso <url>Отдельный адрес SSO
--session <id>Повторно использовать существующую сессию
--lang ru|enЯзык интерфейса
--insecureНе проверять TLS-сертификат
--ca <file>Свой корневой сертификат CA
--no-clipboardОтключить синхронизацию буфера обмена
--fullscreenЗапустить в полноэкранном режиме
--verboseПодробный вывод диагностики
10 · Лицензия

Лицензия

xConsole — внутренний продукт, распространяемый в составе платформы виртуализации. Передача и распространение вне платформы без письменного соглашения не допускаются.

Открыть текст лицензии