Добавление ZennoPoster воркера
Порядок
- На машине с ZennoPoster запустите шаблон
zpServer.zp. - В логе выполнения появится строка регистрации — одна строка JSON:
{"machine":"WORKER-01","host":"192.168.0.10","external":"203.0.113.5","port":22222,"token":"9f3c...","firewall":"off","portRule":"no"}
- Скопируйте её целиком.
- Откройте ZP7, нажмите NODES и вставьте строку в поле добавления узла.
Узел появится в списке. Дальше Cronopus сам опрашивает его состояние.
Строка содержит токен доступа к узлу — обращайтесь с ней как с паролем.
Запуск при каждом старте ZennoPoster
zpServer.zp должен отработать после каждого запуска ZennoPoster: адрес
машины и состояние брандмауэра могут измениться, а регистрация их
фиксирует.
Способ выбираете сами — автозапуск шаблона средствами ZennoPoster либо расписание в Tasker. Повторный запуск поверх уже зарегистрированного узла ничего не ломает: запись обновляется, а не дублируется.
Что должно быть в строке
Разбор выполняет ZpNodeStore.TryParse.
Обязательны:
machine— имя машины, непустое;port— от 1 до 65535;hostилиexternal— достаточно любого из двух.
Необязательны: external, token, firewall, portRule.
Разбор не требует token, но узел с авторизацией без него отвечает 401:
строка без токена годится только для сборок z3n7.dll, где авторизации ещё
нет.
Вместо portRule принимается булево поле urlacl: true читается как yes,
false — как no.
Хвостовая одиночная кавычка отбрасывается перед разбором, поэтому строку можно копировать из лога как есть, не вычищая её вручную.
Что Cronopus делает дальше
Узел хранится в таблице zp_nodes текущей схемы. host и port идут в
запросы, token — в заголовок каждого из них:
GET http://HOST:PORT/state
POST http://HOST:PORT/command
GET http://HOST:PORT/log
GET http://HOST:PORT/traffic
GET http://HOST:PORT/version
Authorization: Bearer <token>
Токен хранится в столбце token таблицы zp_nodes и наружу, в /zp/nodes,
не отдаётся: в браузер приходит только результат пробы.
Логи и трафик узел отдаёт из файлов на своей машине; Cronopus их не хранит,
а пробрасывает запрос через GET /zp/log и GET /zp/traffic.
См. Logs и Traffic.
Токен сменился
Токен лежит на узле в ключе ZP_TOKEN файла .env рядом со сборкой. Если
файл не записался, после перезапуска ZennoPoster узел сгенерирует новый токен,
и сохранённый в Cronopus перестанет подходить.
Наблюдение в этом случае: узел в списке помечен Unauthorized, а запросы
к нему возвращают 401. Лечится повторной вставкой строки регистрации —
запустите zpServer.zp заново и скопируйте свежую строку.
Проверка
- Откройте ZP7.
- Убедитесь, что узел появился в списке.
- Проверьте загрузку состояния.
- Отправьте команду запуска или остановки.
- Откройте
allLogsиtraffic— узел должен отвечать в обоих окнах.
Версия z3n7 на узле
Версии z3n7 и ZennoPoster показаны в списке NODES под адресом узла.
Берутся они с самого узла: GET /version при каждом обновлении списка.
Пустая строка значит либо что узел не ответил, либо что на нём сборка
z3n7.dll без роута /version — сам узел при этом рабочий.
Окно traffic запрашивает хвост файла параметром tail. Если узел отдаёт
первые N записей вместо последних, значит на нём сборка z3n7.dll без
поддержки tail: данные будут, но не те. Обновите сборку на узле.