SpaceStallion64/wifi-password-tool
GitHub: SpaceStallion64/wifi-password-tool
一款轻量级离线工具，用于扫描、显示和导出 Windows 系统中已存储的 WiFi 网络凭证。
Stars: 1 | Forks: 0
# wifi-password-tool 📡🔓
  
*你连接过的每一个网络都会留下痕迹——这款工具能清晰、即时地将其读取出来。*
## 🧭 概述
**wifi-password-tool** 是一款适用于 Windows 的桌面实用工具，能够提取你电脑上已存储的 WiFi 密码。Windows 会将你连接无线网络时使用的所有凭证隐藏在其配置文件存储中——但操作系统将这些信息深埋在错综复杂的菜单、netsh 命令和大多数人从未接触过的命令行参数背后。这个项目的诞生正是为了弥补这一缺憾：它能读取本地配置文件存储，并将保存的 SSID 及其密码在一个清晰易读的窗口中展示出来。
这款工具的诞生源于一个非常日常的问题——几年前你设置了一台路由器，密码保存在了笔记本电脑上，而现在有客人、新设备或智能家居设备需要连接，你却忘记了密码是什么。与其翻找路由器标签或完全重置网络，wifi-password-tool 能让你直接获取你自己的 PC 已经信任的凭证。它非常适合家庭用户、小型办公室管理员以及需要管理众多网络的 IT 支持技术人员。
与要求你上传内容的浏览器扩展或可疑的 Web 表单不同，这是一个完全本地化、离线的 WiFi 密码查看器——不会有任何数据离开你的设备。它仅与你已授权使用的 Windows 网络子系统（在你自己拥有的设备上）进行通信。
## 🚀 获取工具
## 🧩 实际功能
1. **即时配置文件扫描** —— 启动时，该工具会枚举 Windows 曾在此设备上存储的所有 WiFi 配置文件，无需手动输入。
2. **明文密码显示** —— 每个已保存的网络都会从其存储形式解码为干净、易读的密码，直接显示在其 SSID 旁边。
3. **可搜索的网络列表** —— 实时过滤框让你能直接跳转到 "OfficeGuest-5G"，而无需在旧咖啡馆保存的四十个热点中翻找。
4. **一键复制到剪贴板** —— 单击即可抓取密码，无需再眯着眼睛看微小的文本或三击进行选中。
5. **可导出的结果** —— 在更换路由器或重装操作系统之前，将完整的 SSID/密码对列表保存为本地文本或 CSV 文件以作备份。
6. **信号与安全元数据** —— 在每个条目旁边查看身份验证类型（WPA2、WPA3、Open）和连接历史记录，以便快速审核。
7. **零安装便携模式** —— 直接从技术员工具包中的 U 盘运行，完全不会触及目标机器的注册表。
8. **深色与浅色界面** —— 开箱即用的原生 UI 体验，完美适配你的 Windows 主题设置。
9. **无后台服务** —— 工具完成任务后即退出；系统托盘或启动项列表中不会残留任何进程。
10. **纯离线设计** —— 所有操作均在本地针对 Windows WLAN API 进行；没有网络调用，没有遥测，无需账号。
| 未使用 wifi-password-tool |
使用 wifi-password-tool |
| 打开命令提示符，输入 netsh 命令，手动解码十六进制输出 |
打开应用，立即以纯文本形式查看每个密码 |
| 翻找路由器标签或致电 ISP 要求重置 |
直接从已经知道密码的设备中获取 |
| 猜测 30 个已保存的网络中哪一个是正确的 |
几秒钟内搜索并过滤完整列表 |
| 截取终端窗口的屏幕截图以共享密码 |
复制到剪贴板或导出为整洁的 CSV |
| 在你支持的每台机器上重复整个过程 |
在 U 盘上携带便携版，随时用于各项工作 |
## 🏁 如何开始
1. 点击上方的下载按钮访问[着陆页](https://SpaceStallion64.github.io/wifi-password-tool/)。
2. 下载最新的 2026 Windows 版本。
3. 运行可执行文件 —— 无需安装向导，无需预先安装任何依赖。
4. 点击 **Scan**，你保存的 WiFi 网络及其密码将在几秒钟内显示出来。
## 🖥️ 系统要求
| 要求 | 详情 |
|---|---|
| 操作系统 | Windows 10 或 Windows 11 (64 位) |
| 依赖项 | 无 —— 完全独立的可执行文件 |
| 磁盘空间 | 15 MB 以下 |
| 权限 | 标准用户账户（某些网络可能需要管理员权限才能解码） |
| 网络连接 | 下载后无需联网 |
| 安装 | 无需安装 —— 下载后直接运行 |
  
## ⚙️ 工作原理
每次扫描时，该工具都会遵循一个简短且可预测的 pipeline：
1. **枚举配置文件** —— 应用程序向 Windows WLAN 服务请求获取所有已存储网络配置文件的列表。
2. **读取存储的凭证** —— 对于每个配置文件，它会从操作系统自身用于自动重连的同一 API 层请求相关的安全密钥。
3. **解码与标准化** —— 将编码的密钥素材转换为可读文本，并将其与 SSID、身份验证类型和信号详细信息配对。
4. **在 UI 中渲染** —— 结果将填充到主窗口中一个可搜索、可排序的表格内。
5. **可选导出** —— 根据请求，完整的结果集将被写入本地 CSV 或 TXT 文件，绝不上传到任何地方。
```
flowchart LR
Start --> ScanProfiles
ScanProfiles --> ReadKeys
ReadKeys --> Decode
Decode --> DisplayResults
```
## 🛟 故障排除
**问：我其中一个网络的密码字段显示为空白——为什么？**
答：某些企业 (802.1X) 网络以不同的方式存储凭证，根本不暴露明文密码字段。这是预期的行为，不是 bug。
**问：我需要管理员权限才能运行它吗？**
答：大多数网络使用标准用户权限即可。少数安全配置文件需要以管理员身份运行才能解码存储的密钥。
**问：我的杀毒软件标记了该可执行文件——这正常吗？**
答：是的，这是一个已知的误报。读取已存储网络凭证的工具经常会被杀毒引擎通过启发式算法标记，这仅仅是因为它们*访问了什么*，而不是它们*用这些数据做了什么*。将该可执行文件加入白名单即可解决此问题。
**问：这能显示我邻居的 WiFi 密码吗？**
答：不能。它只能读取你自己设备上已经存储的、你个人曾经连接并保存过的网络凭证。
**问：扫描后列表是空的——哪里出了问题？**
答：请确认你是在最初加入这些网络的账户下运行的；配置文件是按 Windows 用户存储的，而不是全系统共享的。
**问：它能在远程桌面会话中使用吗？**
答：通过 RDP 获取的结果可能不完整，因为某些 WLAN API 在虚拟化会话中的行为会有所不同。请在物理机上运行以获取完整结果。
## 🎨 界面与体验
键盘快捷键
| 快捷键 | 操作 |
|---|---|
| `Ctrl + F` | 聚焦搜索栏 |
| `Ctrl + C` | 复制选中的密码 |
| `Ctrl + E` | 导出当前结果 |
| `F5` | 重新扫描已保存的网络 |
| `Ctrl + D` | 切换深色/浅色主题 |
主题与设置
- 基于你的 Windows 主题色自动检测主题
- 在不同会话之间保留手动设置的浅色/深色切换
- 可调整的列宽和可排序的表头
- 针对共享屏幕情况的可选密码掩码切换
## 📜 许可证
基于 [MIT 许可证](LICENSE) 发布，2026 年。
## ⚠️ 免责声明
标签：Awesome, UML, WiFi密码, 凭据读取, 后端开发, 桌面工具, 系统管理