FAQ и решение проблем

Типовые вопросы и разбор проблем. Не нашли ответ — info@warpfleet.ru или чат на главной.

Подключение

Сервер не появился в консоли

Служба живая? systemctl status warpfleet-agent — должно быть active (running).
Логи: journalctl -u warpfleet-agent -n 50 — ошибки сети/токена видны сразу.
Исходящий HTTPS: curl -sI https://app.warpfleet.ru с самой ноды. Прокси/фаервол, режущий исходящий 443, — самая частая причина.
На RHEL/Rocky после ручной замены бинаря проверьте SELinux-контекст: restorecon /opt/warpfleet/bin/warpfleet-agent.

Серверы за NAT — нужно что-то пробрасывать?

Нет. Агент сам инициирует все соединения по исходящему HTTPS. Даже web-терминал консоли работает через обратный туннель агента — входящий SSH на ноде не нужен вовсе.

Автолечение

Как включить или выключить

Политикой в консоли. Выключено — агент проходит полный цикл и показывает в инциденте, что именно он бы исполнил (режим наблюдения). Включено — низкий риск чинится сам, высокий ждёт вашего подтверждения. Отключить можно в любой момент, на любом уровне: нода / класс проблем / весь парк.

Что будет, если починка не сработала

Агент верифицирует результат. Проблема осталась — исполняется откат по шагам плейбука (или восстановление из снятого до вмешательства бэкапа), инцидент остаётся открытым и эскалируется вам. Повторные попытки ограничены cooldown-ом — «молотить» сервер агент не будет.

Совместимость

Рядом стоит Kaspersky (KESL / klnagent)

Network Agent (klnagent) агенту не мешает. Для KESL добавьте в политику KSC исключения: доверенная зона на каталог /opt/warpfleet/, доверенные процессы warpfleet-agent и warpfleet-bridge. Особое внимание — путям самообновления (замена бинаря в /opt/warpfleet/bin/): поведенческий анализ EDR может счесть их подозрительными.

Сколько ресурсов потребляет агент

Единицы процентов CPU на снятие снимка раз в 30 секунд; память ограничена systemd-лимитом жёстко (1 ГБ max, типичное потребление в разы меньше). Никаких интерпретаторов и зависимостей на сервер не ставится — один статический бинарь.

Данные и доступ

Где хранятся данные и сколько

Состояние ноды — локально на ней (SQLite). В облако уходят сжатые снимки метрик и инцидентов. Хранение метрик: 30 дней на тарифе «Наблюдение», 90 дней на платных тарифах; в Self-hosted срок задаёте вы. Облако размещено в РФ. Self-hosted не отправляет наружу ничего — данные идут только на ваш сервер.

Как полностью удалить агента

Штатно из консоли (нода → удалить) либо вручную:

systemctl disable --now warpfleet-agent
systemctl disable --now warpfleet-probe.socket warpfleet-probe.service warpfleet-exec.socket warpfleet-exec.service 2>/dev/null
rm -f /etc/systemd/system/warpfleet-agent.service /etc/systemd/system/warpfleet-probe.* /etc/systemd/system/warpfleet-exec.*
rm -rf /opt/warpfleet /var/lib/warpfleet
userdel warpfleet 2>/dev/null
if [ -f /etc/systemd/journald.conf.d/99-warpfleet.conf ]; then
  rm -f /etc/systemd/journald.conf.d/99-warpfleet.conf
  systemctl restart systemd-journald
fi
systemctl daemon-reload

Последний блок убирает настройки журнала, которые писали версии установщика до 23.10.2026. Затем отзовите ноду в консоли — её токен перестанет действовать.

Как запретить агенту что-либо исполнять

Выполните sudo warpfleet-agent mode monitor --actions=off --terminal=off --heal=off --files=off — агент продолжит наблюдать без root, а службы, которая исполняет команды консоли, на сервере не будет. Подробно — в «Безопасности».

Интерфейс

Не вижу свежих изменений консоли в браузере

Консоль — PWA, старая версия может залипнуть в кэше service worker. Жёсткое обновление (Ctrl+Shift+R / Cmd+Shift+R) или окно в режиме инкогнито.