NX-эндпоинты

Что это

NX-эндпоинт — это отдельный демон nythronix-nx на машине разработчика, который управляет профилями CLI-инструментов codex и claude и запускает их сессии по команде из кабинета. В отличие от агента, NX-эндпоинт не даёт shell на машине: его задача — «домашние каталоги» инструментов, их настройки прокси и история диалогов.

Функция доступна только в self-hosted режиме: в SaaS пункт меню скрыт, а все связанные API отвечают 404.

Регистрация и установка

В админке откройте NX endpoints → Зарегистрировать NX endpoint, укажите логин, hostname и отображаемое имя. Пароль показывается один раз.
На машине установите бинарник скриптом scripts/install-nx.sh --server https://cp.example.com --login nx-1 --password '…' (флаг --user-mode ставит в ~/.local/bin без systemd) или вручную по шаблону deploy/systemd/nythronix-nx.service и nythronix-nx.env.example.
В env-файле обратите внимание на путь WebSocket — wss://cp.example.com/nx/ws (не /agent/ws), переменную NYTHRONIX_ROOT с каталогом профилей (по умолчанию ~/.nythronix) и NYTHRONIX_TRUSTED_KEYS для проверки обновлений.

Обновляется NX-эндпоинт так же, как агент: канал stable/canary и политика обновлений задаются в том же разделе админки, релиз публикуется scripts/release.sh.

Профили, прокси, треды

Профили хранятся на машине под $NYTHRONIX_ROOT/profiles/<tool>/<profile>/home. Страница эндпоинта в кабинете (/nx/<id>) имеет три вкладки:

Profiles — список профилей с инструментом, именем, домашним каталогом и последним использованным прокси;
Proxy — именованные прокси с селектором и алиасами; выбранный прокси можно назначить профилю;
Threads — треды выбранного профиля и сообщения в них.

Все вкладки работают только пока эндпоинт онлайн: запросы уходят на машину по WebSocket, при офлайне возвращается nx.offline.

Запуск сессии

В разделе Новая сессия выберите target «NX endpoint (tool)», эндпоинт, инструмент, профиль и прокси (или inherit), при необходимости рабочую директорию, и нажмите Запустить. Откроется терминал с реальным процессом codex или claude внутри выбранного профиля.

Экспорт и импорт снапшотов

Домашний каталог профиля можно перенести между машинами: API POST /api/nx/<id>/snapshots/export выгружает его как tar.gz с проверкой SHA-256, POST /api/nx/<id>/snapshots/import загружает обратно. Передача идёт потоком через WebSocket эндпоинта; жёсткий лимит размера — 2 ГиБ по умолчанию, при превышении передача обрывается. Отдельной кнопки в кабинете для снапшотов пока нет — используйте API.

См. также Администрирование и Модель безопасности.