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

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

Подключение

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

Служба живая? 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. Даже веб-терминал консоли работает через обратный туннель агента — входящий SSH на сервере не нужен вовсе.

Автолечение

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

Кнопкой на вкладке «Авто» в карточке сервера. Выключено — агент проходит полный цикл и показывает в карточке аварии, что нужно сделать. Включено — низкий и средний риск по вашей политике (по умолчанию сначала спрашивают), высокий всегда ждёт вашего подтверждения. Сам агент запускает только часть сценариев — упавшие службы, время, DNS на Debian и Ubuntu, узлы Kubernetes; набор зависит от ОС и растёт с каждым выпуском. Остальное лечение (например, освободить место на диске) агент готовит и выполняет после вашего «да». Диски, RAID, LVM, firewall и маршруты он не меняет никогда — только подсказывает. Выключить можно в любой момент той же кнопкой.

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

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

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

Рядом стоит 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 /var/log/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) или окно в режиме инкогнито.