wifit3 安装指南：免依赖，10 分钟搭起跨平台 USB Wi-Fi 审计环境-开发者社区

wifit3 安装指南：免依赖，10 分钟搭起跨平台 USB Wi-Fi 审计环境

【免费下载链接】wifit3Wifite but USB-only & cross-platform.项目地址: https://gitcode.com/GitHub_Trending/wi/wifit3

wifit3 安装只需一张受支持的 USB 网卡和一个二进制文件。wifit3 是仅限 USB 的 Wi-Fi 审计 TUI（Wireless Auditor TUI），在 Windows、Linux、macOS 三平台行为完全一致：内置多款主流芯片的用户态驱动，直接通过 USB 与网卡通信，运行时是纯 Python，不需要 aircrack-ng、reaver，也不走系统 Wi-Fi 栈。按本文操作，从下载二进制到进入实时扫描界面约 5 分钟，文末给出回退方法。

选路：预编译二进制还是源码

先花 10 秒定位自己该读哪一节：

你的情况	推荐方式	读哪节
只想用，机器上没装 Python	预编译二进制	主路径
开发者，要跑最新提交、跑测试	`uv`从源码运行	备选路径
想打包自己的可执行文件	`pyinstaller`构建	备选路径

两条路线共同的硬件前提：至少一张受支持的 USB 网卡，笔记本内置 Wi-Fi 不在适用范围内。常见组合：

MediaTek MT7610U / MT7612U（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

各芯片的 RX/TX/ACK 能力与评级明细见 docs/SUPPORTED-HARDWARE.md。

⚠️ 同一芯片不同 VID:PID 版本的支持情况可能不同，以硬件清单为准，买卡前先查表。

主路径：预编译二进制三步跑起来

从项目 Releases 页面下载对应平台的独立可执行文件：

平台	文件
Windows 🪟	`wifit3-windows-x64.exe`
Linux 🐧	`wifit3-linux-x64`
macOS 🍎	`wifit3-macos-universal2`

赋予执行权限并启动，命令按平台区分：

# Linux chmod +x wifit3-linux-x64 ./wifit3-linux-x64

chmod +x补上执行位，第二行直接拉起 TUI。Linux 下运行本身不需要 sudo。

# macOS xattr -d com.apple.quarantine wifit3-macos-universal2 chmod +x wifit3-macos-universal2 ./wifit3-macos-universal2

第一行移除系统给下载文件打的隔离属性，允许其执行；macOS 不随系统附带这些芯片的驱动，libusb 可直接接管设备，无需任何额外安装步骤——对应实现是一个空操作策略，见 src/wifit3/setup/macos.py。Windows 直接双击 exe 即可。

启动界面（Splash）选中网卡，点击START。首次点击会触发一次性驱动配置，完成后不再出现提权提示：

平台	点击 START 后发生了什么
Windows	UAC 弹窗，为你的网卡自动安装 WinUSB 驱动（绑定逻辑见 src/wifit3/setup/windows.py）
Linux	`pkexec`/`sudo`一次性写入 udev 权限规则与内核驱动黑名单（`/etc/modprobe.d/`），防止系统驱动抢占网卡（src/wifit3/setup/linux.py）
macOS	无安装动作，首次授权弹窗选 Allow 即可

这一步做完就不会再重复：udev 规则与黑名单持久化在磁盘上，WinUSB 绑定由系统记住，后续启动免提权。

备选路径：从源码运行

用 uv 跑源码

git clone https://gitcode.com/GitHub_Trending/wi/wifit3 cd wifit3 uv sync uv run wifit3

uv sync按 pyproject.toml 建立虚拟环境并安装全部依赖（要求 Python ≥ 3.11）；uv run wifit3在环境中启动程序。想顺手验证代码完好，可跑uv run pytest，全部测试基于模拟 USB，不需要真实硬件。

打包自己的二进制

uv run pyinstaller wifit3.spec --noconfirm --clean

可执行文件输出到dist/目录，构建配置在 wifit3.spec。

验证：成功标志清单

插入网卡并启动后，按顺序确认以下各项：

启动界面（Splash）中网卡出现且可被选中
点击START，通过首次提权（若有）后进入实时扫描器
扫描器中 2.4 GHz 与 5 GHz 的 AP 列表、信号强度条、加密套件在实时刷新
选中单一目标可进入 Focus 模式，界面能观察到握手捕获状态

若开启 WPS PBC 模式，按下路由器的物理 WPS 按钮即可提取 WPA 密码：

✅ 以上标志全部出现，即安装成功。

排障：常见现象、原因与解法

❓ 网卡插上了，启动界面里没有它原因：芯片或该 VID:PID 版本不在支持清单内。解法：对照 docs/SUPPORTED-HARDWARE.md 的矩阵确认型号与 VID:PID，清单外型号无需再排查其他配置。

❓ Linux 下点击 START 报权限错误原因：一次性驱动配置（udev 规则 + 驱动黑名单）尚未写入。解法：重新点击START触发pkexec提权完成写入；反复重插仍无效时，对照 docs/LINUX-PERMISSIONS.md 检查规则内容与设备节点权限。

❓ macOS 二进制启动即被拦截原因：隔离属性没有移除。解法：先执行xattr -d com.apple.quarantine wifit3-macos-universal2，再运行。

❓ 卸载后系统 Wi-Fi 仍不认这张网卡原因：驱动解绑后系统需要重新枚举设备。解法：拔出网卡再插入一次。

收尾：三平台操作对照与风险说明

平台	安装	一次性配置	回退（把网卡还给系统）
Windows	双击 exe	UAC 安装 WinUSB	启动界面选卡 →`Uninstall`→ 确认 → 拔插网卡
Linux	`chmod +x`后运行	`pkexec`写 udev/modprobe 规则	同上，删除已写入的 udev 与 modprobe 规则
macOS	`xattr`去隔离后运行	无，弹窗点 Allow	同上