Машины

Дашборд

Главная страница кабинета (https://app.nx.3fe.ru/) показывает все машины вашей организации карточками. На карточке:

Online / Offline — присутствие. Online означает, что агент прямо сейчас держит соединение с сервером управления. Статус обновляется по событиям, без перезагрузки страницы. Рядом с Offline показано, когда машина была в сети последний раз, например «был в сети 3 дн. назад», и сохраняются последние известные ОС и версия агента, так что офлайновая машина не превращается в пустую карточку.
Логин, Hostname, Версия агента.
Активных сессий и список этих сессий с кнопкой «Подключиться».
«Запустить shell» — открыть новый терминал одним нажатием.

Нажатие на заголовок карточки открывает страницу машины. Там те же поля плюс Статус (включена ли запись), Канал релизов и Update policy, список сессий с кнопками «Подключиться» и «Стоп» и кнопка «Новая сессия».

Если у машины включено превью сессий, на карточке отображается живая мозаика вывода каждой сессии (см. Терминал и сессии).

Поиск, фильтры, группы

Над списком есть единая панель фильтра — та же используется в «Новая сессия», «Туннели» и в админ-разделе:

Поиск — по имени, hostname и тегу.
Только online — скрыть отключённые машины.
Чипы тегов — нажмите тег, чтобы оставить только машины с ним; можно комбинировать несколько.
Группировать — по любому ключу тега (env, client, role…). Машины без такого тега попадают в группу «без тега».
Сбросить — очистить всё; счётчик «N из M» показывает, сколько машин осталось после фильтра.

Состояние фильтра синхронизируется с адресной строкой, например /?tags=env:prod&group=client. Такую ссылку можно сохранить в закладки или отправить коллеге — он увидит тот же срез.

Теги — единственный способ группировки, иерархии папок нет. Это сделано намеренно: одна машина одновременно принадлежит клиенту, окружению и роли, и любое дерево заставило бы выбрать «главную» ось. Соглашение — ключ:значение:

env:prod   env:stage   client:acme   role:db   site:msk

Правила нормализации: тег приводится к нижнему регистру, пробелы обрезаются, дубликаты удаляются; допустимые символы a-z 0-9 . _ : / -, длина до 64 символов, не более 32 тегов на машину.

Редактировать теги может admin или owner: «Админ → Агенты», в колонке Теги нажмите «теги…». Откроется редактор: выбранные теги показаны чипами, каждый можно снять; ниже одним нажатием подставляются теги, которые уже используются на других машинах и в токенах подключения, так что набор не расходится из-за опечаток. Новый тег вводится текстом, он принимается по Enter, запятой или пробелу, а Backspace убирает последний. Тот же редактор встроен в форму создания токена подключения. Новый набор заменяет старый целиком.

Раздел «Админ → Агенты»

Таблица всех агентов организации с колонками: ID, логин, hostname, отображаемое имя, Платформа (ОС и архитектура, видны только у online-машин), Версия, Присутствие, Статус (Включён / Отключён), Реле, Доступ, Теги, канал и политика обновлений.

Действия над машиной:

Переименовать — задать отображаемое имя вместо логина.
Реле Вкл/Выкл — разрешить другим агентам организации и nyx-operator подключаться к loopback-портам этой машины через панель. См. SSH-реле и туннели.
Доступ: Управляемый — операторы организации имеют постоянный доступ; Только по коду — доступ существует только по коду согласия владельца. См. Доступ по коду согласия.
Update policy (manual / auto / auto_idle_only) и Канал (stable / canary).
Root воркера — временная выдача sudo пользователю nyx-worker (только Linux). См. Установка на Linux.
Скилы — включить MCP-серверы из каталога, который публикует сама машина.
Отключить / Удалить — отключённый агент не может подключиться, но запись сохраняется; удалённый теряет учётные данные навсегда.

Кнопка «Зарегистрировать агента» создаёт запись с логином и одноразовым паролем — это старый способ; для новых машин используйте токены.

Токены подключения

Блок «Токены подключения» на той же странице. Токен создаётся с параметрами:

Поле	Смысл
Макс. использований	1 — для одной машины; больше — для раскатки на парк одной командой
Срок жизни (часы)	после истечения токен бесполезен, даже если использования остались
Шаблон hostname	принимать только машины с подходящим hostname
Список IP	принимать регистрацию только с этих адресов
Теги для новых агентов	каждая зарегистрированная машина получит эти теги
С реле	сразу включить «Реле» у новых машин (нужно для SSH через панель, особенно на Windows)

После нажатия «Создать токен» кабинет один раз показывает команду nythronix-agent enroll --token … --url …; рядом лежит ссылка на установщик для Windows. В таблице ниже видны выданные токены, число использований, срок и кнопка «Отозвать».

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