Терминал и сессии

Как открыть сессию

Два способа:

• «Запустить shell» на карточке машины — терминал открывается сразу с движком shell, автоматическим именем и домашней директорией.
• «Новая сессия» в левом меню — форма с настройками. Target оставьте Remote agent (shell), выберите Агент (доступен тот же фильтр по тегам, что на дашборде) и при необходимости задайте остальное.

Терминал рисуется в браузере, но сама сессия — процесс на машине. Закрытая вкладка не завершает сессию: она остаётся в списке «Сессии» левого меню и на странице машины, откуда к ней можно вернуться кнопкой «Подключиться». Завершает сессию только кнопка «Остановить» (или выход из оболочки).

Движки и восстановление

Поле Engine предлагает только то, что есть на машине — агент сам сообщает, какие программы установлены:

Движок	Что это	После обрыва связи или перезапуска агента
shell	обычная интерактивная оболочка ($SHELL на Linux, PowerShell на Windows)	сессия теряется
tmux	оболочка внутри сессии tmux nyx-<id>	сессия сохраняется; агент подключается к ней заново
zellij	то же с zellij	сессия сохраняется; агент подключается заново

На Windows доступен только shell. При обрыве связи агент переподключается сам, а панель передаёт ему список сессий, которые ещё ожидает; всё, что найдено среди живых nyx-* сессий tmux/zellij, подхватывается без вашего участия. Если для долгой задачи важно пережить перезапуск агента (например, автообновление), выбирайте tmux или zellij.

«Остановить» для tmux/zellij уничтожает и серверную сессию мультиплексора, чтобы на машине не накапливались осиротевшие nyx-*.

Имя сессии

Поле Имя сессии необязательно. Если его не заполнить, сервер придумает имя вида quiet-duck — прилагательное и существительное, как в zellij, с проверкой на уникальность среди живых сессий. Имя показывается в заголовке терминала, в меню «Сессии» и на дашборде.

Рабочая директория

Поле Рабочая директория принимает путь на машине. На десктопе клавиша Tab дополняет путь по списку подпапок, который агент возвращает по запросу; на телефоне удобнее кнопка «Обзор папок» — список папок, начиная с домашней директории пользователя агента, с переключателем «Показывать скрытые» и кнопкой «Выбрать эту папку». Навигация возможна по всей файловой системе: оператор и так получит оболочку, поэтому дополнительной экспозиции нет.

SSH на другой агент

В той же форме есть поле «SSH на другой агент». Если выбрать цель, на агенте-хосте запустится обычный ssh до выбранной машины через реле панели, а в браузере вы увидите его как терминал. Заполните SSH-пользователь (по умолчанию — пользователь агента) и SSH-порт. На целевой машине должно быть включено «Реле» и работать sshd на 127.0.0.1:22. Подробнее — в разделе SSH-реле и туннели.

Для машин на устаревших Windows (без ConPTY) это единственный способ получить терминал; форма сама предложит выбрать relay-цель.

Совместный просмотр

К одной сессии могут подключиться несколько человек одновременно. Сервер держит буфер последнего вывода (1 МиБ) и отдаёт его каждому новому зрителю, а дальше транслирует всё живое. Кто может печатать:

• роли operator, admin, owner — читают и пишут;
• роль viewer — только смотрит; ввод и изменение размера от него игнорируются;
• подключившиеся по коду согласия — как разрешил владелец (--view-only даёт только просмотр).

В окне терминала статус Live означает активное соединение, Disconnected — соединение потеряно (сессия при этом может быть жива). Кнопка «На весь экран» разворачивает терминал.

Сплит-вид

Пункт «Сплит-вид» в меню показывает до четырёх запущенных сессий рядом (сетка 2×2), каждая панель полностью интерактивна — ввод идёт в ту, где фокус. Кнопки: «Добавить сессию…», «Убрать панель», «Открыть полный терминал». Раскладка не сохраняется между визитами.

Превью на дашборде

В «Настройки → Превью сессий» три режима:

• Живые — каждая запущенная сессия рисуется на карточке машины цветной мозаикой, которая обновляется по мере вывода;
• Последний экран — один снимок без живого обновления, экономнее для слабых устройств и большого парка;
• Выкл — превью скрыто.

Это экспериментальная функция: мозаика передаёт цвет и структуру экрана, а не читаемый текст. Нажатие на превью открывает полный терминал.