AirmonGUI

aircrack-ng 무선 도구 키트를 위한 로컬 웹 인터페이스입니다.

스크린샷 · 빠른 시작 · 기능 · 로드맵 · 기여하기

[!WARNING] 소유한 네트워크나 서면 허가를 받은 네트워크에서만 사용하십시오. 통제하지 않는 네트워크를 스캔하거나, 연결 해제(Deauth)하거나, 트래픽을 캡처하는 것은 대부분의 지역에서 불법입니다. 법적 및 책임 있는 사용을 참조하세요.

설명

AirmonGUI는 airmon-ng, airodump-ng, aireplay-ng, aircrack-ng를 하나의 웹 앱으로 묶어 사용자의 기기에서 실행합니다. 모니터 모드를 활성화하고, 네트워크를 스캔하고, WPA 핸드셰이크를 캡처하고, 플래그를 기억하는 대신 레이블이 지정된 양식을 클릭하여 크래킹할 수 있습니다.

어떤 도구도 다시 구현하지 않습니다. 백엔드는 실제 바이너리를 호출하고 그 출력을 파싱하므로, 보이는 것은 도구 모음이 실제로 수행한 결과입니다. UI는 127.0.0.1에 바인딩되며 API는 기기 외부로 나가지 않습니다.

왜 만들었는가

aircrack-ng 모음은 훌륭하지만, 작업 흐름은 네 개의 개별 명령어와 많은 플래그를 머릿속에 기억해야 합니다: 카드를 모니터 모드로 전환하고, 대상 찾기 위해 채널을 변경하고, BSSID에 고정하고, 올바른 채널에서 deauth를 발사하고, 4-way 핸드셰이크를 기다린 후 캡처를 워드리스트에 넣습니다. 채널을 놓치면 deauth는 무효가 됩니다. --bssid를 잊으면 캡처에 노이즈가 가득합니다.

저는 그 전체 과정을 일련의 화면으로 만들어 단계별로 안내하고, 공중에 무엇이 있는지 보여주며, 단계 사이의 상태를 정리하고 싶었습니다. 이것이 바로 그 결과물입니다. 공격이 실제로 어떻게 동작하는지 배우거나, 실습 작업 또는 승인된 평가 속도를 높이는 데 유용합니다.

기능

작동 방식

실행은 사이드바를 따라 위에서 아래로 진행됩니다. 각 화면은 다음과 같습니다.

아래 스크린샷의 네트워크, BSSID, 클라이언트는 실제 캡처가 아닌 합성 데모 데이터입니다.

1. 어댑터를 모니터 모드로 전환

인터페이스를 선택하고, 드라이버, 칩셋, PHY를 확인한 후 모니터 모드를 켭니다. 완료되면 해당 인터페이스만 해제합니다.

2. 공중 스캔

airodump-ng 작업을 시작하고 액세스 포인트와 클라이언트가 발견될 때 채워지는 것을 지켜봅니다. 테이블을 필터링한 후, 네트워크를 deauth 또는 핸드셰이크 작업 흐름으로 바로 보냅니다.

3. 대상 선택

신호 분석은 모든 액세스 포인트에 점수를 매겨 강력하고 보안이 약하며 활성 클라이언트가 있는 것들이 상위에 오도록 합니다. 또한 각 채널의 혼잡도와 주변 네트워크가 사용하는 보안을 보여줍니다. 자신의 장치는 실수로 대상이 되지 않도록 플래그가 지정됩니다.

4. 핸드셰이크 캡처

이 화면은 airodump-ng를 대상의 BSSID와 채널에 고정하고, 자동 deauth 엔진을 실행하여 클라이언트를 끊어서 다시 연결하도록 유도하며, 4-way 핸드셰이크가 캡처되는 즉시 녹색으로 변합니다.

5. 크래킹

캡처 파일과 워드리스트를 aircrack-ng에 지정합니다. 로그가 실행되는 동안 스트리밍되고, 암호가 목록에 있으면 상단에 표시됩니다.

더 많은 스크린샷: deauth, 캡처, 로그

채널 잠금, 실행 기록 및 파싱된 이벤트 출력이 포함된 독립형 deauth:

캡처 파일 관리:

세션 명령 기록:

빠른 시작

Linux, 루트 권한, 모니터 모드를 지원하는 무선 어댑터, $PATH에 aircrack-ng 모음이 필요합니다. 전체 목록은 요구 사항을 참조하세요.

# 0. 모음 설치 (Debian, Ubuntu, Kali)
sudo apt update && sudo apt install aircrack-ng wireless-tools

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

# 2. 백엔드 (터미널 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. 프론트엔드 (터미널 2)
cd frontend
npm install
npm run dev

http://localhost:5173을 엽니다. UI는 127.0.0.1:8000과만 통신합니다.

첫 번째 연결 시 UI는 API 토큰을 요청합니다. 백엔드는 시작 시 콘솔에 다음과 같이 토큰을 출력합니다:

======================================================================
AirmonGUI API 토큰 (이 실행에 대해 생성됨):

    Xy3k...긴-랜덤-문자열...

메시지가 표시되면 AirmonGUI 웹 UI에 붙여넣으세요.
======================================================================

해당 토큰을 잠금 해제 화면에 붙여넣습니다. 재시작 간에 고정 토큰을 유지하려면 backend/.env에 AIRMON_GUI_AUTH_TOKEN을 설정하십시오 (백엔드는 시작 시 이 파일을 로드합니다). 상태 확인을 제외한 모든 API 경로는 이 토큰이 필요하며, 이는 로컬 프로세스나 방문 중인 웹 페이지가 사용자 모르게 무선 도구를 구동하는 것을 방지합니다. 백엔드를 127.0.0.1 이외의 주소에 바인딩하기 전에 토큰을 명시적으로 설정해야 합니다. 그렇지 않으면 시작을 거부합니다.

프롬프트가 단일 사용자 상자에서 불편하다면 AIRMON_GUI_AUTH_ENABLED=false로 설정하여 인증을 완전히 끌 수 있습니다. 그러면 UI가 잠금 해제 화면을 건너뜁니다. 인증이 꺼져 있으면 백엔드는 루프백 이외의 주소에는 바인딩을 거부합니다. API_HOST를 127.0.0.1 이외의 값으로 지정하면 시작되지 않습니다.

루트 권한이 필요한 이유는 airmon-ng, airodump-ng, aireplay-ng가 raw 소켓을 사용하기 때문입니다. 일반 uvicorn 대신 .venv/bin/uvicorn을 직접 호출하십시오. sudo는 PATH를 재설정하여 virtualenv를 찾지 못할 수 있으므로 -E 플래그는 설정한 AIRMON_GUI_* 변수를 유지합니다. 서버를 루트로 실행하지 않으려면 해당 특정 바이너리에 대해 비밀번호 없는 sudo를 설정하고 backend/app/utils.py를 조정하십시오.

cd frontend
npm run build   # 정적 파일을 frontend/dist/에 작성

기술 스택

아키텍처

AirmonGUI
├── backend/    FastAPI REST API 및 WebSocket, 도구당 하나의 라우트 모듈
│               app/routes/ (interfaces, airodump, aireplay, aircrack, handshake, captures)
│               app/models.py (검증된 Pydantic I/O), app/state.py (인-프로세스 작업 레지스트리)
│               app/utils.py (서브프로세스 및 sudo 로직), app/config.py (환경 설정)
│
├── frontend/   Vue 3 싱글 페이지 앱, 제어 콘솔
│               views/ (Overview, Monitor, Scan, Signal, Deauth, Handshake, Crack, Captures, Reports, Terminal, Logs)
│               composables/ (반응형 작업 및 상태 로직), api/ (fetch 래퍼)
│
└── website/    독립형 React 랜딩 사이트 (선택 사항)

백엔드는 http://127.0.0.1:8000/api에서 REST API를 제공하고 /ws/terminal에서 터미널 WebSocket을 제공합니다(API 토큰으로 게이트됨; AIRMON_GUI_TERMINAL_ENABLED=0으로 끌 수 있음). 개발 중에는 :5173의 Vite dev 서버가 둘 다 백엔드로 프록시합니다.

요구 사항

문제 해결

"Could not lock wlan0 to channel N" 또는 네트워크가 표시되지 않는 스캔. 인터페이스가 거의 항상 여전히 관리 모드(managed mode)에 있습니다. 모니터 모드는 어댑터가 캡처하고 채널을 변경할 수 있게 합니다. 먼저 Monitor 탭에서 모니터 모드를 활성화하거나 (airmon-ng start wlan0)한 다음, 모니터 인터페이스(보통 wlan0mon, 일부 드라이버는 원래 이름 유지)에서 스캔하십시오. 스캔은 이 정확한 힌트와 함께 관리 모드 인터페이스를 거부하며, 단일 채널 스캔은 사전 잠금을 확인할 수 없는 경우 더 이상 중단되지 않습니다. airodump-ng가 채널을 자체적으로 조정하기 때문입니다.

첫 번째 실행에서는 네트워크가 보이지만 두 번째 실행에서는 보이지 않음. 남아 있는 모니터 인터페이스 또는 NetworkManager가 실행 사이에 어댑터를 다시 가져가는 경우 인터페이스가 중단된 상태에 남을 수 있습니다. 스캔 전에 airmon-ng check kill (Check Kill 버튼)을 실행하고, 같은 인터페이스에서 다른 스캔을 시작하기 전에 현재 스캔을 중지하십시오.

로드맵

이 중 어떤 것에 대한 도움도 환영합니다. 기여하기를 참조하세요.

• 원클릭 런처 (Makefile 타겟 또는 Docker Compose) 백엔드 및 프론트엔드
• GPU 크래킹을 위한 hashcat 연동
• PMKID 캡처 및 공격
• 시간 경과에 따른 클라이언트 및 AP 그래프
• Reports 보기 완성 및 내보내기 가능
• 패키지 릴리스 및 설치 스크립트

아이디어가 있나요? 이슈 열기. 기능 요청 및 질문도 괜찮습니다.

기여하기

풀 리퀘스트를 환영하며, 작고 집중적일수록 좋습니다.

1. 설정, 확인 및 안전 규칙에 대해 CONTRIBUTING.md를 읽으세요.
2. 포크, 브랜치 생성, 변경 범위를 한 가지로 유지하세요.
3. 백엔드 (uvicorn)와 프론트엔드 (npm run dev)가 모두 깨끗하게 시작되는지 확인하세요.
4. 무엇이 변경되었고 왜 변경되었는지 설명하는 PR을 열어주세요.

각 폴더에는 자체 README와 노트가 있습니다: backend, frontend, website.

프로젝트가 유용하다면, 스타는 다른 사람들이 찾는 데 도움이 되고 제게 계속할 가치가 있음을 알려줍니다.

스타 기록

법적 및 책임 있는 사용

AirmonGUI는 소유한 네트워크 또는 평가를 위해 서면 허가를 받은 네트워크에서 승인된 무선 테스트, 연구 및 교육을 위한 것입니다.

통제하지 않는 네트워크 또는 장치의 트래픽을 가로채거나 연결을 해제하는 것은 대부분의 관할권에서 불법입니다. 기본값은 API와 개발 서버를 루프백으로 유지하는 이유가 있습니다. 공유 네트워크나 공용 네트워크에 노출하지 마십시오. 저자는 오용에 대해 책임을 지지 않습니다. 이 소프트웨어를 사용함으로써 귀하는 접촉하는 모든 네트워크 및 장치에 대한 허가를 확인하는 것입니다.

네트워크를 이해하고 방어하기 위해 사용하십시오. 귀하의 것이 아닌 네트워크를 공격하는 데 사용하지 마십시오.

라이선스

MIT, LICENSE 참조. 실제 작업을 수행하는 aircrack-ng 프로젝트 위에 구축되었습니다.