derv82 / wifit3

查看原文 / View Original 编辑 / Edit

derv82 / wifit3

wifit3 is a standalone USB Wi-Fi auditor for Linux, Windows, and macOS. At least one of the supported USB adapters is required. wifit3 是一款适用于 Linux、Windows 和 macOS 的独立 USB Wi-Fi 审计工具。使用时至少需要一个受支持的 USB 无线网卡。

Why? / 为什么选择它？

  • Cross-Platform: Runs identically on Linux, macOS, and Windows. 跨平台： 在 Linux、macOS 和 Windows 上运行效果完全一致。
  • Wireless Driver Heaven: Built-in wireless stack avoids kernel driver versioning hell and Windows’ NDIS. 无线驱动天堂： 内置无线协议栈，避免了内核驱动版本冲突的“地狱”以及 Windows NDIS 的限制。
  • Zero Runtime Dependencies: No aircrack-ng or reaver, just pure Python with PyUSB & Textual libraries. 零运行时依赖： 无需 aircrack-ng 或 reaver，仅使用纯 Python 配合 PyUSB 和 Textual 库即可运行。

Features / 功能特性

Reconnaissance & Analysis / 侦察与分析

  • Multi-Card Aggregation: Capture packets across multiple adapters simultaneously; pick a dedicated card to inject. 多网卡聚合： 同时跨多个适配器捕获数据包；可指定特定网卡进行注入。
  • Real-time Scanner: 2.4GHz & 5GHz channel-hopping (split for multi-cards); tracks signal strength, encryption suites, WPA3/SAE transition modes. 实时扫描器： 支持 2.4GHz 和 5GHz 信道跳频（多网卡可分担）；追踪信号强度、加密套件及 WPA3/SAE 过渡模式。
  • AP & Client Identification: Fingerprints device vendors and categories; extracts router make and model from WPS beacons. AP 与客户端识别： 对设备厂商和类别进行指纹识别；从 WPS 信标中提取路由器品牌和型号。
  • VAP Decloaking: Identifies hidden networks by correlating their BSSIDs with known visible siblings. VAP 隐形网络探测： 通过将隐藏网络的 BSSID 与已知的可见关联网络进行关联，从而识别隐藏网络。
  • Packet Dashboard: Visualizes real-time beacon, data, injection, and deauthentication packet rates. 数据包仪表盘： 可视化实时信标、数据、注入和解除认证数据包的速率。

Attacks & Captures / 攻击与捕获

  • WPA/WPA2 Handshakes: Passive sniffing and targeted deauthentication; validates crackable pairs; exports .pcap and .hc22000 files. WPA/WPA2 握手包： 被动嗅探与定向解除认证；验证可破解的握手对；支持导出 .pcap 和 .hc22000 文件。
  • PMKID Harvesting: Active association harvest and passive sniffing for WPA/WPA2 PMKID key material (.hc22000). PMKID 采集： 通过主动关联采集和被动嗅探获取 WPA/WPA2 PMKID 密钥材料（.hc22000）。
  • EvilTwin WPA3 Downgrade: Clones the AP and evicts clients (via CSA, BTM, and de-auths) to capture handshakes. Works on single and multiple cards. 邪恶双子星 WPA3 降级攻击： 克隆 AP 并驱逐客户端（通过 CSA、BTM 和解除认证）以捕获握手包。支持单网卡或多网卡操作。
  • WPS Recovery Suite:
    • PixieDust (2 Modes): Instant offline PIN recovery exploiting Null Secret and Static Secret PRNG weaknesses.
    • PushButton (PBC): Detects physical WPS button presses and immediately extracts the plaintext WPA PSK.
    • PIN Brute-Force: Resumable WPS PIN cracking with known-PIN database and AP lock monitoring. WPS 恢复套件：
    • PixieDust（两种模式）： 利用 Null Secret 和静态随机数生成器（PRNG）漏洞实现即时离线 PIN 恢复。
    • PushButton (PBC)： 检测物理 WPS 按钮按下，并立即提取明文 WPA PSK。
    • PIN 暴力破解： 支持断点续传的 WPS PIN 破解，内置已知 PIN 数据库并监控 AP 锁定状态。
  • WEP Suite: Pure Python ARP replay, ChopChop, Fake Authentication, and PTW key recovery. WEP 套件： 纯 Python 实现的 ARP 重放、ChopChop、伪造认证及 PTW 密钥恢复。

Supported Hardware / 支持的硬件

Important: At least one supported USB wireless adapter is required. 重要提示： 至少需要一个受支持的 USB 无线网卡。

(Note: The original article lists various chipsets like Atheros AR9271, MediaTek MT7610U/7612U/7921AU/7925U, Realtek RTL8812AU/8814AU/8821AU/8821CU/8922AU/8822BU/8822CU/8187L/8188EUS, and Ralink RT2570/3070/5370/5372/5572. Please refer to the official documentation for the full list of specific models.) （注：原文列出了包括 Atheros AR9271、MediaTek 系列、Realtek 系列及 Ralink 系列在内的多种芯片组。具体型号列表请参考官方文档。）

Installation & Running / 安装与运行

Option 1: Download Prebuilt Binaries (Recommended) 选项 1：下载预编译二进制文件（推荐）

  • Windows: Download and run wifit3-windows-x64.exe. Windows： 下载并运行 wifit3-windows-x64.exe。
  • Linux (non-sudo): chmod +x wifit3-linux-x64 && ./wifit3-linux-x64 Linux (非 sudo)： chmod +x wifit3-linux-x64 && ./wifit3-linux-x64
  • macOS: (bypass quarantine) xattr -d com.apple.quarantine wifit3-macos-universal2, chmod +x wifit3-macos-universal2, ./wifit3-macos-universal2 macOS：（绕过隔离）执行 xattr -d com.apple.quarantine wifit3-macos-universal2，然后 chmod +x wifit3-macos-universal2，最后 ./wifit3-macos-universal2。

Option 2: Run from Source 选项 2：从源码运行 wifit3 uses Astral’s uv. sync sets up dependencies: wifit3 使用 Astral 的 uv 工具。使用 sync 安装依赖： uv sync uv run wifit3

How it Works: Mini-Drivers / 工作原理：微型驱动

wifit3 bypasses the operating system’s native Wi-Fi stack entirely. It ships with lightweight Python ports of Linux kernel drivers that directly control wireless devices over USB bulk and control transfers. Because register-level frame injection and monitor mode are performed entirely in user space, Windows NDIS restrictions and Linux kernel driver locking do not apply. wifit3 完全绕过了操作系统的原生 Wi-Fi 协议栈。它内置了轻量级的 Python 版 Linux 内核驱动（位于 src/wifit3/chips/*），通过 USB 批量传输和控制传输直接控制无线设备。由于寄存器级的帧注入和监听模式完全在用户空间执行，因此不受 Windows NDIS 限制和 Linux 内核驱动锁定的影响。

⚠️ Notice & Disclaimer / 注意事项与免责声明

For use only on networks and equipment you own or are explicitly authorized to audit. wifit3 operates directly on USB hardware registers without kernel guardrails; use at your own risk. 仅限用于您拥有或已获得明确授权进行审计的网络和设备。wifit3 直接操作 USB 硬件寄存器，且没有内核层面的保护机制；请自行承担使用风险。

← 返回新闻列表 / Back to news list