目前该应用只有荷兰语版本。英语版本即将推出。

用户指南 – Wi-Fi 被动监控（ESSID + 频段过滤）

---

法律与道德声明（教育用途）

仅供教育和授权测试使用。 您对如何使用此工具承担全部责任。故意干扰您不拥有或未经书面授权测试的网络，在您所在司法管辖区可能是非法的。即使只向他人网络发送一个去认证帧也可能违法。请仅在获得明确授权后使用，风险自负。

---

1) 目的（概览）

本应用发现目标 SSID，列出匹配的 BSSID 并按频段（2.4/5/6 GHz） 分组，然后被动监控每个 BSSID 以枚举客户端，如果存在则捕获 WPA 握手并保存为 .22000 文件。去认证按钮当前处于工作状态；会执行主动去认证。

---

2) 系统要求

• 操作系统： 安装了 iw、ip 和 systemd/NetworkManager 的 Linux。
• 工具： airodump-ng（aircrack-ng 套件）、airmon-ng、hcxpcapngtool、iw、ip、systemctl。
• 权限： 以 root 身份运行（或拥有捕获工具的等效能力）。
• Wi-Fi 适配器： 必须支持监控模式和目标频段。6 GHz 需要较新的芯片组/驱动/内核。

---

3) 首次设置

1. 验证工具已安装：which airodump-ng、which hcxpcapngtool 等。
2. 启动应用：python3 your_script.py。
3. 如果看到“Run this script as root”，请使用足够权限重新启动。

提示： 可使用自检（见第 12 节）快速验证环境。

---

4) 文件与文件夹

• logs/<SAFE_ESSID>/session.log – 滚动会话日志（约 5 MB 后自动轮转）。
• logs/<SAFE_ESSID>/discovery-01.csv – 最新的频段发现输出。
• logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – 每个 BSSID 的监控 CSV。
• logs/<SAFE_ESSID>/aliases.json – 您为客户端 MAC 设置的可读别名。
• logs/<SAFE_ESSID>/session.json – 会话数据（BSSID、客户端、计数）。
• logs/<SAFE_ESSID>/*hs*.22000 – 被动捕获的 WPA 握手。

<SAFE_ESSID> 是经过处理、适合文件名的 ESSID 版本。

---

5) 主窗口概览

5.1 顶部栏（输入）

• Wi-Fi 接口 物理设备，例如 wlan1。

• 监控名称 监控模式中使用的名称，例如 mon0。应用会根据需要切换模式并重命名。

• 频段（2.4 / 5 / 6 GHz） 扫描目标 ESSID 的频段。6 GHz 需要较新的 aircrack-ng 和驱动支持。

• ESSID 目标 SSID 的精确拼写（区分大小写）。

• 日志级别 basic（最少）、verbose（更多细节）、debug（最大细节）。

• 发现持续时间（秒） 频段发现阶段的持续时间。

• 每个 BSSID 扫描时间（秒） 每个 BSSID 被动监听以枚举客户端的时间。

• 开始 / 停止 运行或停止整个流程。停止时终止进程并恢复 NetworkManager/接口状态（如适用）。

5.2 发现表格

显示发现期间看到的所有网络（BSSID、信道、频段、ESSID）。

可选过滤器（如果在您的构建中启用）：

• 搜索字段可按部分 BSSID/ESSID 过滤。
• “隐藏隐藏的 SSID” 可移除空白/<hidden> 行。

5.3 目标与 BSSID 选择（按频段过滤）

列出匹配您的 ESSID 且匹配所选频段的 BSSID，包括信道。这标识了属于您 SSID 的精确 AP。

5.4 每个 BSSID 的监控

• 状态行 – 阶段、当前 BSSID 和剩余时间。
• 进度条 – 发现期间为不确定；每个 BSSID 扫描期间为倒计时。
• 客户端（当前 BSSID） – 实时客户端 MAC；已设置别名的会显示别名。
• 跳过控制 – 跳过发现或前进到下一个 BSSID。
• 客户端与握手… – 打开客户端中心（见第 6 节）。

5.5 日志面板

带时间戳的日志（命令、退出码、转换器输出、错误）。持久化到 session.log 并自动轮转。 打开日志目录 可打开当前会话文件夹。

---

6) 客户端中心

6.1 接入点（左侧）

显示匹配您的 ESSID 和频段的 BSSID。选择一个以查看其客户端。

6.2 客户端（右侧）

列出所选 BSSID 下的客户端 MAC，附带最后看到时间。

• 分配别名（双击或右键菜单 → 名称…） 为 MAC 保存一个可读标签（存储在 aliases.json 中）。 通过右键菜单 → 清除别名 可移除别名。

6.3 操作栏

• 开始监控（BSSID） 为所选 BSSID 启动被动握手捕获。显示倒计时和 EAPOL 指示。

• 停止监控 停止捕获。

• 广播 / 定向客户端 仅占位符（此版本中无主动去认证）。它们会启动同一 BSSID 的被动握手捕获。

• 数据包 用于潜在实验室变体的 UI 值（此处不用于去认证）。

• 导出客户端 将所有已知客户端写入CSV（以及启用情况下的 JSON）到会话日志文件夹。

6.4 .22000 面板

• 显示最新 .22000 文件的前几行。
• 复制哈希 将文本复制到剪贴板（此版本中不会自动清除）。
• 打开文件夹 打开包含 .22000 的目录。

6.5 状态栏

• ⏳ 计时器 – 倒计时（如果是无限期则为“运行中…”）。
• EAPOL – 一旦转换器/标准输出提示有握手，则切换为“是”。

---

7) 功能工作流程（底层）

• 预检 – 验证必需的二进制文件；如果缺失则显示明确错误。
• 监控模式 – 将接口切换到监控模式并应用您的监控名称；在停止/退出时恢复系统状态。
• 发现 – 运行 airodump-ng --band <bg|a|6> 输出到 CSV；健壮的基于标头的解析器可处理奇特的 ESSID/CSV 格式。
• BSSID 选择 – 按精确 ESSID 和所选频段过滤。
• 每个 BSSID 的监控 – 固定信道（带 6 GHz 频率回退）并运行 airodump-ng --bssid … --channel …；解析 CSV 的 Stations 部分以实时显示新客户端。
• 握手（.22000） – 在监控期间（或通过客户端中心按钮），使用 hcxpcapngtool 转换最新的 .cap 文件。如果存在非空的 .22000，则显示并记录。在支持的地方发送桌面通知。
• 看门狗 – 如果 airodump-ng 长时间没有输出，则该步骤的进程会被干净地重启（发现或每个 BSSID）。
• Inotify（可选） – 使用 inotify 立即解析文件更改；如果不可用则回退到轻量级 mtime 轮询。
• 日志记录 – 捕获标准输出和标准错误；自动轮转 session.log。
• 会话持久化 – 持续将 BSSID/客户端/别名/计数器写入 session.json，并在同一 ESSID 启动时重新加载。

---

8) 快速入门

1. 配置

   • 选择 Wi-Fi 接口（例如 wlan1）。
   • 设置 监控名称（例如 mon0）。
   • 选择 频段（2.4/5/6 GHz）。
   • 输入 ESSID（精确）。
   • 将 发现持续时间 设为 15–30 秒，每个 BSSID 扫描时间 设为 45–60 秒。
   • 选择 日志级别 verbose。

2. 运行

   • 点击 开始。观察发现进度。
   • 完成后查看发现表格。

3. 查看 BSSID

   • 按频段过滤的列表会显示您的 ESSID 对应的 BSSID。

4. 每个 BSSID 的客户端

   • 应用会遍历 BSSID 并列出每个 AP 的实时客户端。

5. 客户端中心

   • 打开 客户端与握手…。
   • 选择一个 BSSID → 查看客户端。
   • 双击某个客户端以分配别名。
   • 点击 开始监控（BSSID） 进行被动握手捕获。
   • 成功时：EAPOL: yes 且 .22000 内容出现。
   • 根据需要复制哈希和打开文件夹。

6. 导出

   • 点击 导出客户端 以生成 CSV（以及启用情况下的 JSON）。

7. 停止

   • 点击 停止 以结束进程并恢复系统状态。

---

9) 发现过滤器与搜索（如果启用）

• 搜索 – 按部分 ESSID/BSSID 过滤。
• 隐藏隐藏的 SSID – 移除空白/<hidden> 行。
• 清除搜索并取消勾选复选框以重置视图。

---

10) 会话保存与恢复

应用会持续写入 session.json。以相同 ESSID 重新启动时会重新加载：

• 已知的 BSSID，
• 客户端和别名，
• 上次的计数器/设置。

---

11) 导出格式

• CSV： clients.csv 包含 BSSID、ESSID、信道、客户端 MAC、别名、最后看到时间。
• JSON（可选）： 相同数据的机器友好格式。 文件位于 logs/<SAFE_ESSID>/。

---

12) 自检（诊断）

自检窗口显示：

• airodump-ng、hcxpcapngtool、iw、ip、systemctl 的位置。
• iw dev 输出（接口）。
• 通过 iw list 查看能力（适配器支持的频段/信道宽度）。

---

13) 通知与深色模式

• 当生成有效的 .22000 时，会发送桌面通知。
• 深色模式可切换适合长时间使用的深色主题。

---

14) 看门狗行为

如果 airodump-ng 在合理时间内没有输出：

• 该进程会被干净地终止并为该步骤重启。
• 事件会以时间戳记录以便追踪。

---

15) Inotify vs. 轮询

• 使用 inotify，CSV 更改会立即被解析。
• 没有 inotify 时，应用使用低开销的 mtime 轮询。
• inotify 下客户端发现更灵敏，但两种模式都支持。

---

16) 故障排除

• 发现为空

  • 验证频段选择。
  • 确认适配器支持 5/6 GHz（自检 → iw list）。
  • 确保监控模式已激活（iw dev 和应用日志）。

• 6 GHz 无结果

  • 可能需要较新的内核/驱动/固件。
  • 6 GHz 通常需要频率设置回退；应用会尝试此操作。

• 无客户端

  • 将每个 BSSID 扫描时间增加到 90–120 秒。
  • 尝试在更繁忙的时段使用。

• 无 .22000

  • 多等待一些时间；确保存在 EAPOL 流量。
  • 在日志中查看 hcxpcapngtool 消息。

• UI 无响应 / 状态不确定

  • 点击 停止。
  • 重启应用。
  • 检查 session.log 中的精确命令/退出码历史。

---

17) 常见问题

应用会执行去认证吗？ 不会。去认证按钮只是占位符。它们只启动被动捕获。

可以同时监控多个 BSSID 吗？ 应用按 BSSID 顺序扫描；状态会显示进度（例如“2/5”）。

“复制哈希”会自动清除剪贴板吗？ 不会。此版本中剪贴板内容保持。

输出存储在哪里？ 位于 logs/<SAFE_ESSID>/ 下（见第 4 节）。

可以快速打开所有内容吗？ 使用主日志面板中的打开日志目录。

---

18) 推荐操作实践

• 从较短的发现时间（10–20 秒）开始以快速获得反馈；根据需要延长。
• 使用每个 BSSID 扫描时间 ≥ 45–60 秒；在安静网络中增加。
• 为重复出现的客户端分配别名以便更快识别。
• 按频段（2.4/5/6）分别操作以保持清晰。

---

19) 快速参考

• 运行： 设置 接口、监控名称、频段、ESSID → 开始。
• 发现： 查看表格 → 按需过滤。
• BSSID： 按频段过滤的列表 → 填充每个 BSSID 的客户端视图。
• 客户端中心： 开始监控（BSSID） → 等待 .22000 → 复制哈希。
• 导出： 导出客户端（CSV/JSON）。
• 停止： 停止 以恢复系统状态。

---

如果任何行为出乎意料，请先查看 session.log。它记录了每条命令、输出头部和退出码，通常能快速定位问题。