Добавление ZennoPoster воркера

Порядок

  1. На машине с ZennoPoster запустите шаблон zpServer.zp.
  2. В логе выполнения появится строка регистрации — одна строка JSON:
{"machine":"WORKER-01","host":"192.168.0.10","external":"203.0.113.5","port":22222,"token":"9f3c...","firewall":"off","portRule":"no"}
  1. Скопируйте её целиком.
  2. Откройте 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 заново и скопируйте свежую строку.

Проверка

  1. Откройте ZP7.
  2. Убедитесь, что узел появился в списке.
  3. Проверьте загрузку состояния.
  4. Отправьте команду запуска или остановки.
  5. Откройте allLogs и traffic — узел должен отвечать в обоих окнах.

Версия z3n7 на узле

Версии z3n7 и ZennoPoster показаны в списке NODES под адресом узла. Берутся они с самого узла: GET /version при каждом обновлении списка. Пустая строка значит либо что узел не ответил, либо что на нём сборка z3n7.dll без роута /version — сам узел при этом рабочий.

Окно traffic запрашивает хвост файла параметром tail. Если узел отдаёт первые N записей вместо последних, значит на нём сборка z3n7.dll без поддержки tail: данные будут, но не те. Обновите сборку на узле.