10 分钟部署 wifit3:跨平台 USB Wi-Fi 审计工具快速安装指南
【免费下载链接】wifit3Wifite but USB-only & cross-platform.项目地址: https://gitcode.com/GitHub_Trending/wi/wifit3
从拿到文件到进入扫描界面,通常只要几分钟。wifit3是一款在 Windows、Linux 与 macOS 三平台行为完全一致的跨平台 USB Wi-Fi 审计工具:它把 19 款无线芯片的用户态驱动实现内置在纯 Python 程序里,不依赖 aircrack-ng、reaver 等任何外部工具,插上受支持的 USB 网卡即可开工。本文按「硬件自检 → 按平台部署 → 验证 → 还原」的顺序,走完 wifit3 安装、驱动配置与卸载全流程。
wifit3 支持哪些网卡:硬件自检速查
内置的用户态驱动栈覆盖 19 款芯片,常见选择如下:
| 芯片组 | 频段 | 典型网卡 |
|---|---|---|
| MediaTek MT7610U | 2.4 / 5 GHz | ALFA AWUS036ACHM、Panda PAU0B |
| Realtek RTL8821AU | 2.4 / 5 GHz | ALFA AWUS036ACS、TP-Link Archer T2U Plus |
| Realtek RTL8188EUS | 2.4 GHz | TP-Link TL-WN722N v2/v3 |
| Atheros AR9271 | 2.4 GHz | ALFA AWUS036NHA |
各芯片收发能力与评级明细见 docs/SUPPORTED-HARDWARE.md。
⚠️ 笔记本内置 Wi-Fi 不适用。wifit3 必须搭配至少一张受支持的USB 无线网卡,且同一芯片的不同 VID:PID 版本支持情况可能不同,以官方矩阵为准。
Windows 一键启动
- 从 Releases 页面下载
wifit3-windows-x64.exe,双击运行。 - 首次启动弹出 UAC 提示,点「是」——wifit3 会自动为网卡安装WinUSB驱动(绑定逻辑见 src/wifit3/setup/windows.py)。
- 回到启动界面,选中网卡,点
START进入扫描界面。
Linux 无 sudo 部署
chmod +x wifit3-linux-x64 ./wifit3-linux-x64首次点START时,wifit3 经pkexec/sudo一次性写入两条规则:一条udev权限规则,一条内核驱动黑名单(防止系统驱动抢占网卡);之后运行无需再提权。实现见 src/wifit3/setup/linux.py,设计说明见 docs/LINUX-PERMISSIONS.md。
macOS 免驱运行
macOS 不附带这些芯片的驱动,libusb可直接接管设备,没有任何额外安装步骤:
xattr -d com.apple.quarantine wifit3-macos-universal2 chmod +x wifit3-macos-universal2 ./wifit3-macos-universal2首次授权弹窗选择Allow即可。
wifit3 源码运行与自打包
依赖由 Astral 的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/目录。
三步验证扫描界面
- 插入 USB 网卡,启动 wifit3。
- 在启动界面选中网卡,点击
START。 - 进入实时扫描器,看到 2.4 / 5 GHz 的 AP 列表,部署即成功 🎉
卸载 wifit3:还原系统 Wi-Fi
不打算继续使用时,把网卡还给系统的 Wi-Fi 栈:
- 在启动界面选中该网卡。
- 点击
Uninstall并确认。 - 接受提权提示(Windows 为 UAC,Linux 为
pkexec)。 - 拔出再插入网卡。
Linux 下这一步会删除 wifit3 写入的udev与modprobe规则;Windows 下会解除 WinUSB 绑定并触发 PnP 重扫,旧驱动自动恢复。
故障速查
| 症状 | 常见原因 | 处理 |
|---|---|---|
| 网卡插上了但未被识别 | 芯片组或 VID:PID 版本不在支持矩阵中 | 对照 SUPPORTED-HARDWARE.md 确认,必要时换支持清单内的网卡 |
| Linux 下提示权限错误 | 一次性驱动配置未生效 | 重新点击START触发 udev 规则写入;仍失败则参考 LINUX-PERMISSIONS.md |
| 想跑测试但没有真实网卡 | 误以为需要硬件环境 | 全部测试基于模拟 USB,直接uv run pytest即可 |
平台汇总
| 平台 | 安装方式 | 一次性配置 |
|---|---|---|
| Windows | 双击.exe | UAC 安装 WinUSB |
| Linux | chmod +x后运行 | pkexec 一次性写入 udev/modprobe 规则 |
| macOS | 去除 quarantine 后运行 | 无,弹窗点 Allow |
wifit3 直接操作 USB 硬件寄存器,请仅在你拥有或已获明确授权的网络上使用。
【免费下载链接】wifit3Wifite but USB-only & cross-platform.项目地址: https://gitcode.com/GitHub_Trending/wi/wifit3
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考