Сейчас доступна только голландская версия приложения. Английская версия появится в ближайшее время.

Руководство пользователя – Пассивный монитор Wi-Fi (ESSID + Фильтр по диапазону)

Юридическое и этическое уведомление (только для образования)

Только для образовательного и авторизованного тестирования. Вы несёте полную ответственность за использование этого инструмента. Преднамеренное нарушение работы сетей, которые вам не принадлежат или на тестирование которых у вас нет письменного разрешения, может быть незаконным в вашей юрисдикции. Даже один кадр деаутентификации, отправленный в чужую сеть, может быть противозаконным. Используйте только с явного разрешения и на свой страх и риск.

1) Назначение (кратко)

Это приложение обнаруживает целевой SSID, отображает соответствующие BSSID по диапазонам (2.4/5/6 ГГц) и пассивно отслеживает каждый BSSID для перечисления клиентов и, при наличии, захвата WPA-рукопожатий в файл .22000. Кнопки деаутентификации активно работают; выполняются активные деаутентификации.

2) Системные требования

ОС: Linux с iw, ip и systemd/NetworkManager.
Инструменты: airodump-ng (пакет aircrack-ng), airmon-ng, hcxpcapngtool, iw, ip, systemctl.
Права: Запуск от root (или с эквивалентными возможностями для инструментов захвата).
Wi-Fi адаптер: Должен поддерживать режим монитора и целевые диапазоны. Для 6 ГГц требуется современный чипсет/драйвер/ядро.

3) Первоначальная настройка

Проверьте установку инструментов: which airodump-ng, which hcxpcapngtool и т.д.
Запустите приложение: python3 your_script.py.
Если вы видите «Run this script as root», перезапустите с достаточными привилегиями.

Совет: Используйте Самодиагностику (см. §12) для быстрой проверки окружения.

4) Файлы и папки

logs/<SAFE_ESSID>/session.log – текущий сессионный лог (ротация после ~5 МБ).
logs/<SAFE_ESSID>/discovery-01.csv – последний вывод сканирования диапазона.
logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – CSV мониторинга для каждого BSSID.
logs/<SAFE_ESSID>/aliases.json – читаемые псевдонимы для MAC-адресов клиентов.
logs/<SAFE_ESSID>/session.json – данные сессии (BSSID, клиенты, счётчики).
logs/<SAFE_ESSID>/*hs*.22000 – пассивно захваченные WPA-рукопожатия.

<SAFE_ESSID> – это очищенный от недопустимых символов вариант вашего ESSID, пригодный для имени файла.

5) Обзор главного окна

5.1 Верхняя панель (поля ввода)

Wi-Fi интерфейс Физическое устройство, например wlan1.
Имя монитора Имя, используемое в режиме монитора, например mon0. Приложение при необходимости переключит режим и переименует.
Диапазон (2.4 / 5 / 6 ГГц) Диапазон для сканирования целевого ESSID. 6 ГГц требует последних версий aircrack-ng и поддержки драйвера.
ESSID Точный SSID для поиска (чувствителен к регистру).
Уровень логирования basic (минимальный), verbose (подробнее), debug (максимально подробно).
Длительность поиска (с) Время сканирования диапазона.
Сканирование каждого BSSID (с) Время пассивного прослушивания каждого BSSID для перечисления клиентов.
Старт / СТОП Запускает или останавливает конвейер. СТОП завершает процессы и восстанавливает состояние NetworkManager/интерфейса, если это применимо.

5.2 Таблица поиска

Показывает все сети, обнаруженные во время сканирования (BSSID, канал, диапазон, ESSID).

Дополнительные фильтры (если включены в вашей версии):

Поле поиска фильтрует по части BSSID/ESSID.
«Скрыть скрытые SSID» удаляет строки с пустым или <hidden>.

5.3 Целевой BSSID и фильтрация по диапазону

Список BSSID, соответствующих вашему ESSID и выбранному диапазону, включая канал. Это позволяет определить точные точки доступа, принадлежащие вашему SSID.

5.4 Мониторинг каждого BSSID

Строка состояния – фаза, текущий BSSID и оставшееся время.
Индикатор прогресса – неопределённый во время поиска; обратный отсчёт при сканировании каждого BSSID.
Клиенты (текущий BSSID) – MAC-адреса клиентов в реальном времени; отображаются с псевдонимами, если они заданы.
Элементы управления пропуском – пропустить поиск или перейти к следующему BSSID.
Клиенты и рукопожатия… – открывает Центр клиентов (см. §6).

5.5 Панель логов

Логи с временными метками (команды, коды завершения, вывод конвертера, ошибки). Сохраняются в session.log с автоматической ротацией. Открыть папку логов открывает активную папку сессии.

6) Центр клиентов

6.1 Точки доступа (слева)

Отображает BSSID, соответствующие вашему ESSID и диапазону. Выберите один, чтобы увидеть его клиентов.

6.2 Клиенты (справа)

Список MAC-адресов клиентов в выбранном BSSID со временем Last seen.

Назначить псевдоним (двойной щелчок или контекстное меню → Name…) Сохранить читаемую метку для MAC (хранится в aliases.json). Удалить псевдоним через контекстное меню → Clear alias.

6.3 Панель действий

Начать мониторинг (BSSID) Запускает пассивный захват рукопожатия для выбранного BSSID. Показывает обратный отсчёт и индикатор EAPOL.
Остановить мониторинг Останавливает захват.
Broadcast / Client-targeted Только заполнители (активная деаутентификация в этой сборке отсутствует). Они запускают пассивный захват рукопожатия для того же BSSID.
Packets Значение UI для потенциальных лабораторных вариантов (здесь не используется для деаутентификации).
Экспорт клиентов Записывает CSV (и JSON, если включено) всех известных клиентов в папку логов сессии.

6.4 Панель .22000

Показывает первые строки последнего файла .22000.
Copy hash копирует текст в буфер обмена (в этой сборке автоочистка отсутствует).
Open folder открывает папку, содержащую .22000.

6.5 Строка состояния

⏳ Таймер – обратный отсчёт (или «running…», если бесконечно).
EAPOL – переключается на «yes», как только конвертер/stdout сообщает о рукопожатии.

7) Функциональный рабочий процесс (под капотом)

Предварительная проверка – Проверяет наличие необходимых бинарников; показывает явные ошибки при отсутствии.
Режим монитора – Переключает интерфейс в режим монитора и применяет указанное имя монитора; восстанавливает состояние системы при СТОП/выходе.
Поиск – Запускает airodump-ng --band <bg|a|6> в CSV; надёжный парсер на основе заголовков обрабатывает необычные ESSID/форматы CSV.
Выбор BSSID – Фильтрует по точному ESSID и выбранному диапазону.
Мониторинг каждого BSSID – Фиксирует канал (с запасным вариантом для 6 ГГц) и запускает airodump-ng --bssid … --channel …; анализирует раздел Stations CSV для отображения новых клиентов в реальном времени.
Рукопожатие (.22000) – Во время мониторинга (или через кнопки Центра клиентов) преобразует самый новый .cap с помощью hcxpcapngtool. Когда существует непустой .22000, он отображается и логируется. При возможности выдаются уведомления на рабочий стол.
Сторожевой таймер – Если airodump-ng замолкает, процесс чисто перезапускается для этого шага (поиск или мониторинг BSSID).
Inotify (опционально) – Использует inotify для немедленного анализа изменений файлов; при отсутствии использует лёгкий опрос mtime.
Логирование – Захватывает как stdout, так и stderr; автоматически выполняет ротацию session.log.

8) Быстрый старт

Настройка
- Выберите Wi-Fi интерфейс (например, wlan1).
- Укажите Имя монитора (например, mon0).
- Выберите Диапазон (2.4/5/6 ГГц).
- Введите ESSID (точно).
- Установите Поиск на 15–30 с и На каждый BSSID на 45–60 с.
- Выберите Уровень логирования verbose.
Запуск
- Нажмите Start. Наблюдайте за ходом поиска.
- После завершения просмотрите Таблицу поиска.
Просмотр BSSID
- Отфильтрованный по диапазону список показывает BSSID для вашего ESSID.
Клиенты каждого BSSID
- Приложение перебирает BSSID и отображает активные клиенты каждой точки доступа.
Центр клиентов
- Откройте Клиенты и рукопожатия….
- Выберите BSSID → просмотрите клиентов.
- Дважды щёлкните клиента, чтобы назначить псевдоним.
- Нажмите Начать мониторинг (BSSID) для пассивного захвата рукопожатия.
- В случае успеха: EAPOL: yes и отображается содержимое .22000.
- Используйте Copy hash и Open folder по мере необходимости.
Экспорт
- Нажмите Экспорт клиентов для создания CSV (и JSON, если включено).

9) Фильтры поиска (если включены)

Поиск – фильтр по части ESSID/BSSID.
Скрыть скрытые SSID – удаляет строки с пустым или <hidden>.
Очистите поиск и снимите флажок, чтобы сбросить представление.

10) Сохранение и возобновление сессии

Приложение постоянно записывает данные в session.json. Перезапуск с тем же ESSID восстанавливает:

известные BSSID,
клиентов и псевдонимы,
последние счётчики/настройки.

11) Форматы экспорта

CSV: clients.csv с BSSID, ESSID, Каналом, MAC клиента, Псевдонимом, Last seen.
JSON (опционально): те же данные в машиночитаемом формате. Файлы находятся в каталоге logs/<SAFE_ESSID>/.

12) Самодиагностика

Окно Самодиагностика показывает:

Расположение airodump-ng, hcxpcapngtool, iw, ip, systemctl.
Вывод iw dev (интерфейсы).
Возможности через iw list (диапазоны/ширина каналов, поддерживаемые вашим адаптером).

13) Уведомления и тёмная тема

Уведомление на рабочий стол отправляется при создании валидного .22000.
Тёмная тема переключает тёмный интерфейс, подходящий для длительных сессий.

14) Поведение сторожевого таймера

Если airodump-ng не выводит данные в течение разумного периода:

Процесс чисто завершается и перезапускается для этого шага.
События логируются с временными метками для отслеживания.

15) Inotify против опроса

С inotify изменения CSV анализируются немедленно.
Без inotify приложение использует малонагруженный опрос mtime.
Обнаружение клиентов становится более отзывчивым с inotify, но поддерживаются оба режима.

16) Устранение неполадок

Пустой поиск
- Проверьте выбор диапазона.
- Убедитесь, что адаптер поддерживает 5/6 ГГц (Самодиагностика → iw list).
- Убедитесь, что режим монитора активен (iw dev и логи приложения).
Нет результатов на 6 ГГц
- Может потребоваться более новое ядро/драйвер/прошивка.
- Для 6 ГГц часто нужен запасной вариант с частотой; приложение пытается его применить.
Нет клиентов
- Увеличьте Время на BSSID до 90–120 с.
- Попробуйте в более загруженное время.
Нет .22000
- Дайте больше времени; убедитесь, что существует трафик EAPOL.
- Просмотрите сообщения hcxpcapngtool в логе.
Интерфейс не отвечает / неопределённое состояние
- Нажмите STOP.
- Перезапустите приложение.
- Проверьте session.log для точной истории команд/кодов завершения.

17) Часто задаваемые вопросы

Выполняет ли приложение деаутентификацию? Нет. Кнопки деаутентификации — заполнители. Они запускают только пассивный захват.

Можно ли одновременно отслеживать несколько BSSID? Приложение сканирует последовательно каждый BSSID; статус показывает прогресс (например, «2/5»).

Очищает ли «Copy hash» буфер обмена автоматически? Нет. Содержимое буфера обмена сохраняется в этой сборке.

Где хранятся выходные данные? В каталоге logs/<SAFE_ESSID>/ (см. §4).

Можно ли быстро открыть всё? Используйте Открыть папку логов на главной панели логов.

18) Рекомендуемые практики

Начинайте с короткого Поиска (10–20 с) для быстрой обратной связи; при необходимости увеличьте.
Используйте Время на BSSID ≥ 45–60 с; увеличьте на тихих сетях.
Назначайте псевдонимы повторяющимся клиентам для быстрого распознавания.
Работайте по диапазонам (2.4/5/6 ГГц) для ясности.

19) Краткая справка

Запуск: задайте интерфейс, имя монитора, диапазон, ESSID → Start.
Поиск: просмотрите таблицу → при необходимости отфильтруйте.
BSSID: отфильтрованный по диапазону список → автоматически заполняется представление клиентов для каждого BSSID.
Центр клиентов: Начать мониторинг (BSSID) → ждите .22000 → Copy hash.
Экспорт: Экспорт клиентов (CSV/JSON).
Стоп: STOP для восстановления состояния системы.

Если что-то работает неожиданно, начните с session.log. В нём записаны каждая команда, начало вывода и код завершения, что обычно быстро указывает на проблему.

AirScout

Популярное