Обзор

Что это

Nythronix — это панель управления удалёнными машинами. На каждую машину ставится небольшой агент, который сам подключается к серверу управления по исходящему WebSocket-соединению. После этого вы работаете с машиной из браузера: открываете терминал, пробрасываете SSH через панель, даёте разовый доступ по коду, подключаете AI-воркеров, которые выполняют команды под вашим подтверждением.

Ключевое свойство: машине не нужен белый IP, открытые порты или VPN. Агент за NAT сам «звонит» на сервер; сервер никогда не инициирует соединение к машине.

Nythronix существует в двух вариантах: SaaS (кабинет на https://app.nx.3fe.ru, к которому подключаются агенты через nx.3fe.ru) и self-hosted (та же кодовая база у вас на сервере). Эта документация описывает работу с SaaS-кабинетом; отличия self-hosted упомянуты в FAQ.

Из чего состоит

Компонент	Что делает	Где работает
Control plane (сервер управления)	HTTP/WebSocket API, аутентификация, аудит, маршрутизация байтов между агентами, чат и память воркеров.	nx.3fe.ru
Кабинет	Веб-интерфейс: дашборд, терминалы, туннели, воркеры, админ-раздел.	https://app.nx.3fe.ru
Агент nythronix-agent	Служба на управляемой машине. Поднимает терминал (PTY), принимает релейные потоки, выполняет команды воркеров, обновляет себя.	каждая машина
Воркер	AI-участник канала. Читает канал, рассуждает, вызывает инструменты, спрашивает подтверждение у человека.	контейнер на стороне Nythronix
CLI оператора nyx-operator	Показывает парк машин и открывает локальный порт, который через панель ведёт к порту машины за NAT (SSH, scp, rsync).	ваш ноутбук
MCP-сервер nyx-mcp	Даёт те же действия Claude Code и другим MCP-клиентам: найти машину, открыть туннель, выполнить проверку только на чтение.	ваш ноутбук

Подробная схема связей есть в разделе SSH-реле и туннели.

Словарь

• Машина / агент. В кабинете эти слова означают одно и то же: запись об установленном агенте. У неё есть логин, hostname, версия, платформа, присутствие (Online / Offline) и набор тегов.
• Организация. Единица изоляции. Операторы видят только машины своей организации; реле и туннели работают только между агентами одной организации.
• Оператор. Учётная запись человека в кабинете. Роли: owner, admin, operator, viewer. Viewer может смотреть терминалы, но не печатать в них; admin и owner имеют доступ к разделу «Админ» (регистрация агентов, токены, релизы, аудит).
• Сессия. Один терминал на машине: обычный shell либо сессия внутри tmux или zellij. Сессия живёт на агенте, а не в браузере — к ней можно подключиться повторно, в том числе нескольким людям сразу. См. Терминал и сессии.
• Токен регистрации (nyxet_…). Одноразовый или многоразовый токен, по которому агент сам получает постоянные учётные данные при установке. Создаётся в «Админ → Агенты → Токены подключения».
• Реле. Механизм, при котором сервер управления переключает байты между двумя агентами (или между вашим nyx-operator и агентом). Так SSH и другие TCP-сервисы машины становятся доступны за NAT. Включается на каждой машине-цели отдельно.
• Туннель. Локальный TCP-порт, который через реле ведёт на loopback-порт другой машины. Может жить на агенте (создаётся в кабинете) или на вашем ноутбуке (nyx-operator tunnel).
• Код согласия. Разовый код, который владелец машины генерирует командой nythronix-agent share. Оператор вводит его на дашборде и получает доступ ровно к тому, что разрешил владелец. См. Доступ по коду согласия.
• Канал. Чат внутри организации, где общаются люди и воркеры. Воркер может состоять в нескольких каналах, канал — содержать несколько воркеров.
• Воркер. AI-участник канала. Выполняет команды на машинах только через сервер управления и только после подтверждения человеком (кроме команд из безопасного списка чтения). На Linux-машине его команды выполняются от непривилегированного пользователя nyx-worker.
• Скилл. Дополнительный набор инструментов воркера — MCP-сервер, который запускается на самой машине (например, для доступа к локальной БД) и доступен воркеру через панель. Включается в «Админ → Агенты → Скилы».

Для кого

• Администраторам, которые обслуживают парк машин за NAT (офисы, филиалы, домашние ПК, VPS) и хотят единый браузерный доступ без VPN.
• Командам, которым нужен совместный просмотр терминала и журнал действий.
• Тем, кто даёт разовый доступ к чужой машине (поддержка клиентов) и хочет, чтобы доступ существовал только пока владелец его разрешил.
• Тем, кто хочет поручать рутину AI-воркеру, оставляя за собой подтверждение каждой изменяющей команды.

Начните с быстрого старта.