Skip to content

node-accelerator v3.1 — na-diagnose CLI + na-report forensics#9

Merged
jestivald merged 2 commits into
mainfrom
v3.1-cli-forensics
Jun 15, 2026
Merged

node-accelerator v3.1 — na-diagnose CLI + na-report forensics#9
jestivald merged 2 commits into
mainfrom
v3.1-cli-forensics

Conversation

@jestivald

Copy link
Copy Markdown
Owner

Наблюдаемость: нода отдаёт стабильный машинный интерфейс для внешнего мониторинга/панели. Поведение защиты/тюнинга не меняется.

🩺 na-diagnose — persisted CLI

curl|bash гоняет модули из временной папки → после установки на ноде НЕ оставалось постоянной команды диагностики. Панелям/Zabbix/SSH-поллингу нужен стабильный na-diagnose --json.

  • common.sh: NA_LIB_DIR=/usr/local/lib/node-accelerator
  • install.sh: persist_toolkit() копирует diagnose.sh+lib/common.sh в NA_LIB_DIR и ставит обёртку /usr/local/sbin/na-diagnose; вызывается из optimize/protect (bare diagnose остаётся read-only). DRY_RUN-safe.
  • Новый сабкоманд install.sh persist — (пере)создать CLI без полного прогона.
  • rollback.sh: remove_cli_if_orphaned() снимает CLI только когда не осталось ни одного установленного модуля.

🔥 na-report --json — форензика атак (read-only)

Из данных, которые уже есть на ноде: журнал ядра ([na portscan|synflood|ssh-flood|badflags]), nft-сеты (autoban/suspect/blocklist), решения CrowdSec.

Выдаёт: events_total, ban_rate_5m, drops_by_reason, timeline[12] (последний час), top_ips (вердикт attacker/suspect + confidence), top_asn. ASN/гео — best-effort через Team Cymru whois (нет whois/сети → поле пустое, остальное работает). Флаги: --hours N, --top N, --ip <addr>.

✅ Проверка

  • Валидировано live на реальной ноде: na-diagnose --json и na-report --json (71k portscan/24ч, корректный таймлайн и top-источники).
  • shellcheck --severity=error чист на всех скриптах.
  • CI smoke-матрица расширена: install.sh persist (na-diagnose создаётся и отдаёт JSON), DRY_RUN без эффектов, rollback снимает CLI.

Концепция форензик-слоя вдохновлена наработками коллеги-оператора (по его просьбе — без имени).

🤖 Generated with Claude Code

jestivald and others added 2 commits June 15, 2026 23:04
curl|bash гоняет модули из временной папки → после установки на ноде НЕ
оставалось постоянной команды диагностики. Панели/Zabbix/SSH-поллингу нужен
стабильный `na-diagnose --json` без повторного curl|bash.

- common.sh: NA_LIB_DIR=/usr/local/lib/node-accelerator (персист скриптов)
- install.sh: persist_toolkit() копирует diagnose.sh+lib/common.sh в NA_LIB_DIR и
  ставит обёртку /usr/local/sbin/na-diagnose; вызывается из optimize/protect (bare
  diagnose остаётся read-only). DRY_RUN-safe. Хук под na-report (v3.1) уже заложен.
- install.sh: новый сабкоманд `persist` — (пере)создать CLI без полного прогона.
- rollback.sh: remove_cli_if_orphaned() снимает CLI и NA_LIB_DIR только когда не
  осталось ни одного установленного модуля (частичный откат не убивает нужную команду).
- ci: smoke-шаги — na-diagnose создаётся и отдаёт JSON, DRY_RUN без эффектов, rollback убирает.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Read-only форензика из данных, которые уже есть на ноде: журнал ядра
([na portscan|synflood|ssh-flood|badflags]), nft-сеты (autoban/suspect/blocklist),
решения CrowdSec. Выдаёт events_total, ban_rate_5m, drops_by_reason, timeline[12]
(последний час), top_ips (вердикт attacker/suspect + confidence) и top_asn.
ASN/гео — best-effort через Team Cymru whois (нет whois/сети → пусто, остальное ок).
Флаги: --json, --hours N, --top N, --ip <addr> (вердикт по одному IP).

persist_toolkit (v3.1) уже ставит na-report как CLI, если модуль присутствует.
Концепция форензик-слоя вдохновлена наработками коллеги-оператора (по его просьбе — без имени).
docs: CHANGELOG v3.1 + README (na-diagnose/na-report).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@jestivald jestivald merged commit 8f441df into main Jun 15, 2026
5 checks passed
@jestivald jestivald deleted the v3.1-cli-forensics branch June 15, 2026 20:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant