xdrew87/wifi-auditor
GitHub: xdrew87/wifi-auditor
跨平台 Wi-Fi 审计与侦察工具包，统一封装三大操作系统的原生无线命令，提供配置管理、附近网络扫描、安全风险评分和数据导出功能。
Stars: 0 | Forks: 0
# OSINT 情报 WiFi Profile Auditor
**适用于 Windows、macOS 和 Linux 的跨平台 Wi-Fi 审计与侦察工具包。**
[](https://github.com/xdrew87/wifi-auditor)
[](https://www.python.org/)
[](./LICENSE)
[](#features)
*由 [xdrew87](https://github.com/xdrew87) 开发 · OSINT Intelligence*
## 概述
每个平台上的原生 Wi-Fi 工具功能强大，但在交互使用时非常繁琐。本工具将 `netsh` (Windows)、`airport` + `networksetup` (macOS) 和 `nmcli` (Linux) 封装为一个对操作员友好的终端工作流，用于审计、侦察、导出和本地 Wi-Fi 管理。
平台在启动时会自动检测——无需配置。
## 功能
| 类别 | 能力 |
|---|---|
| **Profiles** | 列出、查看、搜索、复制密码、连接、删除 |
| **Scanning** | 附近网络的 BSSID、信号、信道、频段、无线电类型 |
| **Connection** | 实时当前连接状态 |
| **Audit** | 针对脆弱的已保存配置进行风险评分 |
| **Compare** | 已保存网络与附近网络的并排对比视图 |
| **Export** | JSON, CSV, TXT — profiles、扫描结果和完整报告 |
| **Logging** | 运行时日志写入 `logs/` |
## 环境要求
- Python `3.10+`
- 无线网卡
| 平台 | 后端 | 额外要求 |
|---|---|---|
| **Windows** | `netsh wlan` | 无 |
| **macOS** | `airport`, `networksetup`, `security` | 无（macOS 自带） |
| **Linux** | `nmcli` | NetworkManager (`sudo apt install network-manager`) |
## 快速开始
**Windows**
```
git clone https://github.com/xdrew87/wifi-auditor.git
cd wifi-auditor
py main.py
```
**macOS**
```
git clone https://github.com/xdrew87/wifi-auditor.git
cd wifi-auditor
python3 main.py
```
**Linux**
```
git clone https://github.com/xdrew87/wifi-auditor.git
cd wifi-auditor
sudo python3 main.py
```
## 菜单
```
+------------------------------------------------------------------+
| MAIN MENU |
+------------------------------------------------------------------+
| [1] List Saved Profiles [9] Export Saved Profiles |
| [2] View Profile Details [10] Export Scan Results |
| [3] Search Profiles [11] Export Full Report |
| [4] Scan Nearby Networks [12] Copy Saved Password |
| [5] Current Connection [13] Connect to Profile |
| [6] Compare Saved vs Nearby [14] Disconnect Wi-Fi |
| [7] Security Audit [15] Delete Saved Profile |
| [8] System Information [16] Exit |
+------------------------------------------------------------------+
```
## 安全审计
已保存的 profiles 会使用本地启发式方法进行评分，并分配一个风险等级：
| 标志 | 增加的风险分 |
|---|---|
| 开放认证 | +90 |
| WEP 加密 | +80 |
| 未知/不常见的认证 | +50 |
| WPA2 | +25 |
| 无可恢复密码 | +15 |
| 密码少于 12 个字符 | +20 |
| TKIP 加密 | +20 |
| WPA3 | +10 |
这是一种本地辅助筛查手段，并非正式的无线安全评估框架。
## 导出
所有输出均写入 `exports/` 文件夹。
| 类型 | 格式 |
|---|---|
| 已保存的 profiles | `JSON`, `CSV`, `TXT` |
| 附近扫描结果 | `JSON`, `CSV`, `TXT` |
| 完整环境快照 | `JSON` |
## 注意事项
- **Windows** — 解析器需要英文的 `netsh` 输出标签。非英文的 Windows 区域设置可能会产生意外结果。
- **macOS** — 密码检索会读取系统 Keychain；可能会弹出输入登录密码的提示。
- **Linux** — 需要 NetworkManager (`nmcli`)。密码检索可能需要 `sudo`。必须安装 `xclip` 才能支持剪贴板。
- 在所有平台上，连接、断开和删除操作都会立即影响本地计算机。
## 仓库结构
```
wifi-auditor/
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ └── PULL_REQUEST_TEMPLATE.md
├── exports/
├── logs/
├── .gitattributes
├── .gitignore
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── SECURITY.md
└── main.py
```
## 安全
有关漏洞报告指南，请参阅 [SECURITY.md](./SECURITY.md)。
## 许可证
采用自定义的 [Attribution License](./LICENSE) 授权 — 您可以自由使用、克隆和修改此项目，但您必须保留原作者的署名，并且不得声称此作品为您本人所有。标签：Python, WiFi审计, 后渗透, 无后门, 网络安全, 逆向工具, 隐私保护