wifit3 安装教程:三步装好,5 分钟跑通 USB 无线审计
【免费下载链接】wifit3Wifite but USB-only & cross-platform.项目地址: https://gitcode.com/GitHub_Trending/wi/wifit3
wifit3 是一款跨平台的 USB Wi-Fi 审计 TUI 工具:自带用户态驱动栈,直接驱动网卡寄存器,不装内核驱动,也不依赖 aircrack-ng 或 reaver。这篇 wifit3 快速上手教程覆盖 🪟 Windows、🐧 Linux、🍎 macOS 三平台的安装、一次性授权与首跑验证。跑完之后,你的屏幕上会有周边 AP 的实时列表,并且能点进去抓 WPA 握手。
开始前的 30 秒自检
| 项目 | 要求 | 不满足会怎样 |
|---|---|---|
| USB 无线网卡 | ⚠️至少一张支持列表内的 USB 网卡(共 21 个芯片组,含 AR9271、MT7610U、RTL8821AU 等) | 网卡不会出现在启动界面列表里,装再多软件也白搭 |
| 网卡位置 | 必须是外置 USB 卡,笔记本内置 Wi-Fi 不支持 | wifit3 完全绕开系统 Wi-Fi 协议栈,直驱 USB 寄存器 |
| 系统版本 | Linux / Windows / macOS 均支持;源码运行需 Python ≥ 3.11 | 二进制版无此要求 |
| 提权账号 | 能过一次 UAC 或pkexec弹窗即可 | 无法完成一次性驱动部署 |
每款卡的 RX/TX 能力与评级(A–D)见 docs/SUPPORTED-HARDWARE.md,买卡或挑卡前先查这张矩阵。
安装主流程
第 1 步:拿到对应平台的预编译版
到仓库 Releases 页下载最新版,文件名对应关系:
| 平台 | 下载文件 | 一次性系统改动 |
|---|---|---|
| 🪟 Windows | wifit3-windows-x64.exe | UAC 授权一次,为网卡绑定 WinUSB 驱动 |
| 🐧 Linux | wifit3-linux-x64 | 提权一次,落盘 udev 访问规则与/etc/modprobe.d/内核驱动黑名单 |
| 🍎 macOS | wifit3-macos-universal2 | 无,系统授权弹窗点 Allow 即可 |
第 2 步:首次运行与一次性授权
按平台启动,然后选中网卡点START:
🐧 Linux(需加执行权限):
chmod +x wifit3-linux-x64 ./wifit3-linux-x64🍎 macOS(需先解除隔离属性):
xattr -d com.apple.quarantine wifit3-macos-universal2 chmod +x wifit3-macos-universal2 ./wifit3-macos-universal2🪟 Windows 直接双击 .exe 即可。随后:
- 在 splash 界面选中你的 USB 网卡,点
START。 - 过掉一次性提权弹窗:Windows 点 UAC「是」绑定 WinUSB;Linux 确认
pkexec/sudo,写入 udev 规则并拉黑对应内核驱动,防止系统驱动先抢走网卡;macOS 在系统弹窗选Allow。 - Linux 按提示重插一次网卡,让卡片回到冷启动状态。
这一步只做一次,之后日常运行直接进程序、不再提权。机制细节见 docs/LINUX-PERMISSIONS.md。
第 3 步:验收跑通
验收标准:画面出现你身边的 AP 列表且持续刷新,即部署成功 🎉
# 可选:确认环境没问题 echo done最小下一步玩法:单击任意一个 AP 进入聚焦模式,锁定单目标抓 WPA/WPA2 握手,导出.pcap与.hc22000文件。
可选进阶:从源码运行或自己打包
想读代码、跑测试或改驱动移植,用uv管理依赖(Python ≥ 3.11,声明见 pyproject.toml):
git clone https://gitcode.com/GitHub_Trending/wi/wifit3 cd wifit3 && uv sync && uv run wifit3自打包可分发二进制:uv run pyinstaller wifit3.spec --noconfirm --clean,产物在dist/。跑全量回归:uv run pytest(测试基于 mock USB,不依赖真卡)。驱动移植方法论在 docs/porting/METHODOLOGY.md。
回退与卸载:把网卡还给系统
- splash 界面选中该网卡,点
Uninstall并确认。 - 过提权弹窗(🪟 UAC / 🐧
pkexec),然后拔出并重新插入网卡。
各平台实际发生的事:Linux 删掉 wifit3 写的 udev 规则与 modprobe 黑名单;Windows 解除 WinUSB 绑定并触发 PnP 重扫,原驱动自己接回;macOS 原本就没写过任何东西,无回退动作。
排障速查
| 症状 | 大概率原因 | 处理动作 |
|---|---|---|
| 插了网卡却不出现在列表 | 芯片不在支持列表,或该 VID:PID 未覆盖 | 对照 docs/SUPPORTED-HARDWARE.md 矩阵,换卡或认命 |
| Linux 报权限错误 | 一次性驱动配置未生效 | 重进界面再点START触发规则写入,然后重插网卡 |
| 网卡有信号但不收包 | 系统内核驱动先绑定了卡片 | 走一遍 Uninstall 再START,重写黑名单后重启系统 |
| 在虚拟机里跑 | 设备未加入虚拟机 USB 过滤器 | 插入前先把网卡加进 VirtualBox 的 USB Filters |
| 没有硬件想验证安装 | 测试全基于 mock USB | uv run pytest,全绿即环境可用 |
收尾
wifit3 的卖点就三条:零运行时依赖、零内核驱动、三平台行为一致——从下载二进制到看见 AP 列表,通常不超过 5 分钟。
⚠️ wifit3 无内核护栏、直接操作 USB 硬件寄存器:只在你拥有或被明确授权审计的网络与设备上使用;用户态寄存器访问有小概率损坏硬件,风险自担。
【免费下载链接】wifit3Wifite but USB-only & cross-platform.项目地址: https://gitcode.com/GitHub_Trending/wi/wifit3
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考