How fluxionnetwork/fluxion works
Project type and purpose
• Fluxion is an open-source security auditing and social-engineering tool for executing MITM WPA/WPA2 attacks (phishing).
• It is a purely script-based CLI application (Bash) that orchestrates external wireless-attack utilities (aircrack-ng suite, hostapd, dnsmasq, iptables, etc.) and serves a captive-portal web interface to capture WPA keys.
File structure
• Top-level components:
– fluxion.sh: the main orchestrator
– bin/arch: packaging script for Arch Linux
– docs/man, misc: documentation & helper scripts
– language/: localization files for user prompts
– lib/: shared utility modules (ArrayUtils, IOUtils, InstallerUtils, SandboxUtils, InterfaceUtils, etc.)
– lib/installer: multiple package‐manager installers (apt, yum, pacman, etc.)
– attacks/: modular attack definitions
· Handshake Snooper: capture handshake
· Captive Portal: fake AP + web server + DNS + deauth jammer
– scripts/: smaller helper scripts (debug, diagnostics, preferences)
– preferences/: user’s stored configuration
• Patterns: modular, pluggable attacks under attacks/, shared helpers under lib/, single CLI entrypoint.
README
• Describes attack workflow:
1. Scan network
2. Handshake Snooper → capture handshake
3. Captive Portal → spawn rogue AP, DNS server, web server, deauth jammer
4. Validate submitted keys against captured handshake; log correct key
• Lists external dependencies: Kali Linux, Linux networking tools, aircrack-ng, hostapd, dnsmasq, etc.