AirmonGUI

Локальный веб-интерфейс для набора беспроводных инструментов aircrack-ng.

Скриншоты · Быстрый старт · Возможности · Дорожная карта · Участие в разработке

[!WARNING] Используйте это только на сетях, которыми вы владеете или на тестирование которых у вас есть письменное разрешение. Сканирование, деаутентификация или перехват трафика сетей, которыми вы не управляете, в большинстве мест незаконны. См. Правовое и ответственное использование.

Что это такое

AirmonGUI объединяет airmon-ng, airodump-ng, aireplay-ng и aircrack-ng в одном веб-приложении, которое работает на вашей собственной машине. Вы включаете режим монитора, сканируете сети, захватываете WPA-рукопожатие и взламываете его, переходя по подписанным формам, вместо того чтобы запоминать флаги.

Оно не переписывает ни один из инструментов. Бэкенд вызывает настоящие бинарники и разбирает их вывод, так что вы видите именно то, что реально сделал набор. Интерфейс привязан к 127.0.0.1, и API никогда не выходит за пределы вашей машины.

Почему я это создал

Набор aircrack-ng отличный, но рабочий процесс разбит на четыре отдельные команды и множество флагов, которые нужно держать в голове: перевести карту в режим монитора, переключать каналы, чтобы найти цель, зафиксироваться на BSSID, запустить деаутентификацию на правильном канале, дождаться четырёхстороннего рукопожатия, а затем скормить захват словарю. Промахнётесь с каналом — и деаутентификация уйдёт в никуда. Забудете --bssid — и ваш захват будет полон шума.

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

Возможности

Как это работает

Рабочий процесс идёт сверху вниз по боковой панели. Вот каждый экран.

Сети, BSSID и клиенты на скриншотах ниже — это синтетические демонстрационные данные, а не реальный захват.

1. Переведите адаптер в режим монитора

Выберите интерфейс, проверьте его драйвер, чипсет и PHY и включите режим монитора. Когда закончите, освободите именно этот интерфейс.

2. Просканируйте эфир

Запустите задание airodump-ng и наблюдайте, как таблица заполняется точками доступа и клиентами по мере их обнаружения. Отфильтруйте таблицу, затем отправьте любую сеть прямо в процесс деаутентификации или захвата рукопожатия.

3. Выберите цель

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

4. Захватите рукопожатие

Этот экран фиксирует airodump-ng на BSSID и канале цели, запускает движок автоматической деаутентификации, чтобы сбросить клиентов и заставить их переподключиться, и становится зелёным в тот момент, когда захвачено четырёхстороннее рукопожатие.

5. Взломайте его

Направьте aircrack-ng на захват и словарь. Журнал транслируется по мере работы, и если парольная фраза есть в вашем списке, она появится вверху.

Дополнительные экраны: деаутентификация, захваты, журналы

Отдельная деаутентификация с фиксацией канала, историей запусков и разобранным выводом событий:

Управление файлами захвата:

История команд сеанса:

Быстрый старт

Вам понадобятся Linux, root, беспроводной адаптер с поддержкой режима монитора и набор aircrack-ng в вашем $PATH. Полный список см. в разделе Требования.

# 0. Install the suite (Debian, Ubuntu, Kali)
sudo apt update && sudo apt install aircrack-ng wireless-tools

# 1. Clone
git clone https://github.com/ELHart05/AirmonGUI.git
cd AirmonGUI

# 2. Backend (terminal 1)
cd backend
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
sudo -E .venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

# 3. Frontend (terminal 2)
cd frontend
npm install
npm run dev

Откройте http://localhost:5173. Интерфейс общается только с 127.0.0.1:8000.

При первом подключении интерфейс запрашивает API-токен. Бэкенд выводит его в консоль при запуске, примерно так:

======================================================================
AirmonGUI API token (generated for this run):

    Xy3k...long-random-string...

Paste it into the AirmonGUI web UI when prompted.
======================================================================

Вставьте этот токен в экран разблокировки. Чтобы сохранить фиксированный токен между перезапусками, задайте AIRMON_GUI_AUTH_TOKEN в backend/.env (бэкенд загружает этот файл при запуске). Каждый маршрут API, кроме проверки состояния, требует этот токен — именно он не позволяет случайному локальному процессу или веб-странице, которую вы просматриваете, управлять беспроводными инструментами за вашей спиной. Вы должны явно задать токен, прежде чем привязывать бэкенд к чему-либо, кроме 127.0.0.1, — иначе он откажется запускаться.

Если запрос токена — лишь лишнее препятствие на однопользовательской машине, задайте AIRMON_GUI_AUTH_ENABLED=false, чтобы полностью отключить аутентификацию; тогда интерфейс пропустит экран разблокировки. При выключенной аутентификации бэкенд отказывается привязываться куда-либо, кроме loopback: укажите API_HOST на что-то отличное от 127.0.0.1, и он не запустится.

Root необходим, потому что airmon-ng, airodump-ng и aireplay-ng используют сырые сокеты. Вызывайте .venv/bin/uvicorn напрямую, а не просто uvicorn, поскольку sudo сбрасывает PATH и иначе не найдёт виртуальное окружение; флаг -E сохраняет все заданные вами переменные AIRMON_GUI_*. Если вы предпочитаете не запускать сервер от root, настройте sudo без пароля для этих конкретных бинарников и внесите изменения в backend/app/utils.py.

cd frontend
npm run build   # writes static files to frontend/dist/

Технологический стек

Архитектура

AirmonGUI
├── backend/    FastAPI REST API and WebSocket, one route module per tool
│               app/routes/ (interfaces, airodump, aireplay, aircrack, handshake, captures)
│               app/models.py (validated Pydantic I/O), app/state.py (in-process job registry)
│               app/utils.py (subprocess and sudo logic), app/config.py (env config)
│
├── frontend/   Vue 3 single-page app, the control console
│               views/ (Overview, Monitor, Scan, Signal, Deauth, Handshake, Crack, Captures, Reports, Terminal, Logs)
│               composables/ (reactive job and state logic), api/ (fetch wrappers)
│
└── website/    Standalone React landing site (optional)

Бэкенд предоставляет REST API по адресу http://127.0.0.1:8000/api и терминальный WebSocket по адресу /ws/terminal (защищён API-токеном; отключается с помощью AIRMON_GUI_TERMINAL_ENABLED=0). В режиме разработки dev-сервер Vite на :5173 проксирует оба на бэкенд.

Требования

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

"Could not lock wlan0 to channel N" или скан без сетей. Почти всегда интерфейс всё ещё находится в управляемом режиме. Именно режим монитора позволяет адаптеру захватывать трафик и менять каналы. Сначала включите его на вкладке Monitor (или командой airmon-ng start wlan0), затем сканируйте на интерфейсе монитора — часто это wlan0mon, хотя некоторые драйверы сохраняют исходное имя. Сканирование отклоняет управляемый интерфейс именно с такой подсказкой, а одноканальное сканирование больше не прерывается, если предварительную фиксацию канала не удалось проверить, поскольку airodump-ng сам настраивает канал.

Сети видны при первом запуске, но не при втором. Оставшийся интерфейс монитора или NetworkManager, снова захвативший адаптер между запусками, могут оставить его в зависшем состоянии. Запустите airmon-ng check kill (кнопка Check Kill) перед сканированием и останавливайте сканирование перед запуском нового на том же интерфейсе.

Дорожная карта

Помощь с любым из этих пунктов приветствуется. См. Участие в разработке.

• Запуск одной командой (цель Makefile или Docker Compose) для бэкенда и фронтенда
• Передача в hashcat для взлома на GPU
• Захват и атака PMKID
• Графики клиентов и точек доступа во времени
• Представление Reports: завершённое и экспортируемое
• Готовый релиз и скрипт установки

Есть идея? Откройте issue. Запросы функций и вопросы приветствуются.

Участие в разработке

Pull request'ы приветствуются: чем меньше и сфокусированнее изменение, тем лучше.

1. Прочитайте CONTRIBUTING.md о настройке, проверке и правилах безопасности.
2. Сделайте форк, создайте ветку и ограничьте изменение одной задачей.
3. Проверьте, что бэкенд (uvicorn) и фронтенд (npm run dev) оба запускаются без ошибок.
4. Откройте PR, в котором указано, что изменилось и почему.

В каждой папке есть свой README с примечаниями: backend, frontend, website.

Если проект вам полезен, звезда поможет другим людям найти его и подскажет мне, что стоит продолжать.

История звёзд

Правовое и ответственное использование

AirmonGUI предназначен для авторизованного тестирования беспроводных сетей, исследований и обучения на сетях, которыми вы владеете или на оценку которых у вас есть письменное разрешение.

Перехват трафика и деаутентификация сетей или устройств, которыми вы не управляете, незаконны в большинстве юрисдикций. Значения по умолчанию не зря держат и API, и dev-сервер на loopback — не открывайте их в общей или публичной сети. Авторы не несут ответственности за неправомерное использование. Используя это программное обеспечение, вы подтверждаете, что у вас есть разрешение на каждую сеть и устройство, к которым вы обращаетесь.

Используйте его, чтобы понимать и защищать сети, а не атаковать сети, которые вам не принадлежат.

Лицензия

MIT, см. LICENSE. Создан на основе проекта aircrack-ng, который выполняет всю основную работу.