Установка на Windows

Требования

• Windows 7 SP1 / Server 2008 R2 и новее, 32 или 64 бита. Один установщик покрывает всю линейку, см. таблицу ниже.
• Права администратора для запуска установщика.
• Исходящий доступ по HTTPS/WSS к nx.3fe.ru. Входящие порты не нужны.
• Токен регистрации nyxet_…, созданный в кабинете («Админ → Агенты → Токены подключения»). Для доступа по SSH через панель отметьте у токена «С реле».

Установщик: https://nx.3fe.ru/downloads/nythronix-agent-setup.exe. Ссылка на него есть на странице входа и в блоке токенов подключения.

Какие Windows поддерживаются

Файл установщика один на все системы. Он сам смотрит версию Windows и разрядность и ставит подходящую сборку агента, поэтому заранее выяснять, что именно стоит на машине, не нужно.

Система	Терминал в браузере	SSH-реле и команды	OpenSSH
Windows 10 1809+ / Server 2019+, 64 бита	да	да	встроенный компонент, из комплекта как запасной вариант
Windows 7 SP1 / 8 / 8.1 / Server 2008 R2 / 2012 / 2012 R2, 64 бита	нет	да	из комплекта установщика
Любая 32-битная Windows	нет	да	из комплекта установщика

Терминал в браузере требует ConPTY, а он появился только в Windows 10 1809. На более старых системах машина живёт в кабинете почти полноценно: видно, что она онлайн, работают SSH-реле, туннели, read-only команды и автообновление агента. Не работает то, что упирается в терминал: «Запустить shell», сессии tmux и zellij и доступ по коду согласия. Терминал к такой машине открывается через соседнюю современную машину полем «SSH на другой агент».

Заметка

На Windows 7 и Server 2008 R2 OpenSSH-сервер берётся из комплекта установщика: своего магазина компонентов там нет, а скачать его система не может, потому что TLS 1.2 по умолчанию выключен. Установщик кладёт OpenSSH в свою папку, поэтому уже установленный администратором OpenSSH не перезаписывается, а при удалении агента остаётся на месте вместе с вашим SSH-доступом. Из-за встроенного комплекта файл установщика весит около 12 МБ.

Что спрашивает мастер

1. Дополнительные задачи.
   • Установить OpenSSH-сервер (sshd) — отмечено по умолчанию. Мастер выполняет Add-WindowsCapability … OpenSSH.Server, переводит службу sshd в автозапуск и запускает её. Нужен доступ к Windows Update или WSUS; если sshd уже установлен, шаг пропускается. Входящий порт при этом не открывается: операторы попадают на 127.0.0.1:22 машины через реле Nythronix.
   • Сделать PowerShell оболочкой по умолчанию для SSH-входов — не отмечено. Записывает HKLM\SOFTWARE\OpenSSH\DefaultShell.
2. Сервер управления.
   • Адрес сервера — предзаполнен https://nx.3fe.ru. Принимается как https://…, так и wss://…/agent/ws.
   • Токен регистрации — вставьте nyxet_…. Оставьте поле пустым, если машина уже зарегистрирована и вы просто обновляете агента.
   • Имя машины в кабинете — необязательное. Если заполнить, машина появится в списке под этим именем вместо сетевого; пишите на любом языке, например «Касса 2, склад». Пустое поле оставляет имя по умолчанию.

Дальше мастер копирует nythronix-agent.exe в %ProgramFiles%\Nythronix Agent, выполняет enroll (учётные данные сохраняются в %ProgramData%\Nythronix\agent.json), регистрирует службу NythronixAgent (LocalSystem, автозапуск, перезапуск при сбое) и запускает её. Через несколько секунд машина появляется на дашборде как Online.

Если sshd не удалось поставить автоматически, мастер покажет предупреждение, а агент всё равно будет установлен. Поставить sshd позже можно вручную:

Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Set-Service -Name sshd -StartupType Automatic
Start-Service sshd

Тихая установка

nythronix-agent-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART ^
  /SERVER=https://nx.3fe.ru /TOKEN=nyxet_… /NAME="Касса 2, склад" /TASKS=sshd /LOG=C:\setup.log

• /SERVER= — адрес сервера управления.
• /TOKEN= — токен регистрации. Без него установка на незарегистрированной машине завершится ошибкой; на уже зарегистрированной — сохранит текущую регистрацию.
• /NAME= — необязательное имя машины в кабинете. Если параметра нет, используется имя по умолчанию.
• /TASKS=sshd,pwsh — какие задачи выполнить; /TASKS= (пусто) пропускает установку sshd.
• /LOG= — стандартный журнал Inno Setup.

Токен многоразовый (поле «Макс. использований» больше 1) удобен для раскатки одной командой на несколько машин; теги из токена машины получат автоматически.

Где что лежит

Что	Где
Исполняемый файл	%ProgramFiles%\Nythronix Agent\nythronix-agent.exe
Учётные данные и ключ проверки обновлений	%ProgramData%\Nythronix\agent.json
Журнал службы	%ProgramData%\Nythronix\logs\agent.log.* (ротация по дням)
Журнал шагов установщика	%ProgramData%\Nythronix\logs\setup-step.log
Адрес сервера для повторной установки	HKLM\SOFTWARE\Nythronix\Agent\ServerUrl

Служба видна в services.msc как NythronixAgent. Управлять ею можно и через сам агент из командной строки администратора:

"%ProgramFiles%\Nythronix Agent\nythronix-agent.exe" service stop
"%ProgramFiles%\Nythronix Agent\nythronix-agent.exe" service start

Терминал, открытый из кабинета, запускает PowerShell 7 (pwsh.exe), если он установлен, иначе Windows PowerShell. Движки tmux и zellij на Windows недоступны.

Обновление

Два пути:

• Автоматически. В «Админ → Агенты» установите машине Update policy = auto (или auto_idle_only — обновляться только без активных сессий). При выходе новой версии агент скачает её, проверит SHA-256 и подпись Ed25519 ключом, закреплённым при регистрации, и перезапустится под управлением службы.
• Вручную. Запустите новый установщик, оставив поле токена пустым. Мастер остановит и заменит службу, регистрация сохранится.

Удаление

«Параметры → Приложения» (Apps & features) → Nythronix Agent → Удалить. Деинсталлятор выполняет service stop и service uninstall, удаляет файлы программы, но оставляет %ProgramData%\Nythronix с регистрацией — так повторная установка не требует нового токена. Удалите эту папку вручную, если машина больше не должна подключаться, и удалите запись машины в «Админ → Агенты».

Установленный мастером OpenSSH-сервер при удалении агента не трогается.