{"id":14437970,"url":"https://github.com/baihengaead/wifi-crack-tool","last_synced_at":"2026-02-07T10:02:52.428Z","repository":{"id":244268772,"uuid":"488143619","full_name":"baihengaead/wifi-crack-tool","owner":"baihengaead","description":"WiFi密码暴力破解工具-图形界面，支持WPA/WPA2/WPA3、多开并发、自动破解、自定义密码本、自动生成密码字典","archived":false,"fork":false,"pushed_at":"2024-10-30T09:24:34.000Z","size":23913,"stargazers_count":3399,"open_issues_count":21,"forks_count":403,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-08-27T05:18:13.915Z","etag":null,"topics":["crack","pyside6","python","pywifi","tool","wifi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/baihengaead.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-03T09:13:15.000Z","updated_at":"2025-08-27T04:54:32.000Z","dependencies_parsed_at":"2024-07-26T10:30:00.080Z","dependency_job_id":"ed2d76de-82ca-4acf-910e-7fb26fb17ea3","html_url":"https://github.com/baihengaead/wifi-crack-tool","commit_stats":null,"previous_names":["baihengaead/wifi-crack-tool"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/baihengaead/wifi-crack-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baihengaead%2Fwifi-crack-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baihengaead%2Fwifi-crack-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baihengaead%2Fwifi-crack-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baihengaead%2Fwifi-crack-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/baihengaead","download_url":"https://codeload.github.com/baihengaead/wifi-crack-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baihengaead%2Fwifi-crack-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29191991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T07:37:03.739Z","status":"ssl_error","status_checked_at":"2026-02-07T07:37:03.029Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crack","pyside6","python","pywifi","tool","wifi"],"created_at":"2024-08-31T10:00:43.055Z","updated_at":"2026-02-07T10:02:52.422Z","avatar_url":"https://github.com/baihengaead.png","language":"Python","funding_links":[],"categories":["逆向破解","Python"],"sub_categories":[],"readme":"# WiFi暴力破解工具\n\n## 免责声明\n\n**本项目所涉及的技术、思路和工具仅供学习交流，任何人不得将其用于非法用途和盈利，不得将其用于非授权渗透测试，否则后果自行承担，与本项目无关。使用本项目前请先阅读[法律法规](https://github.com/baihengaead/Awesome-Laws)。**\n\n## 项目介绍\n\nwifi_crack_tool是一款基于Python开发的拥有图形界面的WiFi密码暴力破解工具，支持多平台，使用本项目应遵循[MIT许可](https://github.com/baihengaead/wifi-crack-tool/blob/main/LICENSE)，可使用自定义密码本，且拥有自动保存破解成功后的WiFi SSID与密码到本地密码字典、在有多个无线网卡的情况下可以多开工具并行破解同一个或不同的WiFi。\n\n支持 WPA、WPAPSK、WPA2、WPA2PSK、WPA3、WPA3SAE 安全协议\n\n## 如何使用\n\n#### 简单使用\n\n##### 使用\n\n首先测试你的无线网卡在 扫描wifi 和 连接wifi 时最佳的延时时长（以能成功扫描和成功连接为准），然后设置 扫描时间 和 连接时间。\n\n接下来正常使用就可以啦。\n\n##### 结果\n\n破解的结果会在日志中显示，破解完成后会弹窗提示，并自动将破解得到的密码复制到剪切板。\n\n#### 自动运行\n\n##### 介绍\n\n自动破解扫描到的所有WiFi\n\n##### 使用\n\n1. 选择你要使用的无线网卡\n2. 扫描WiFi\n3. WiFi名称选择 ——全部——\n4. 开始破解\n\n##### 结果\n\n破解的结果会在日志中显示，全部破解完成后会弹窗提示。\n\n结果示例：\n\n```txt\n(1)   wifi名称1   密码1\n(2)   wifi名称2   密码2\n...\n```\n\n#### 多开并发\n\n##### 要求\n\n电脑至少有2个无线网卡，且都可以正常使用\n\n##### 使用\n\n以有2个无线网卡为例\n\n1. 打开2次 `wifi_crack_tool.exe`或者 `python wifi_crack_tool.py`\n2. 选择不同的无线网卡\n3. 扫描WiFi\n4. 选择需要破解的WiFi\n5. 开始破解\n\n##### 结果\n\n见 简单使用 / 自动运行\n\n#### 密码本\n\n##### 默认文件路径\n\n```cmd\n./passwords.txt\n```\n\n##### 文件格式\n\n```txt\npassword1\npassword2\npassword3\n...\n```\n\n#### 密码字典\n\n##### 文件路径\n\n```cmd\n./dict/pwdict.json\n```\n\n##### 文件格式\n\n```json\n[\n    {\n        \"ssid\":\"wifi_1\",\n        \"pwd\":\"password1\"\n    },\n    {\n        \"ssid\":\"wifi_2\",\n        \"pwd\":\"password2\"\n    },\n    {\n        \"ssid\":\"wifi_3\",\n        \"pwd\":\"password3\"\n    },\n]\n```\n\n#### 日志\n\n##### 文件路径\n\n```cmd\n./log/wifi_crack_log_{datetime}.txt\n```\n\n## 开发环境\n\nPython ≥ 3.11.x（推荐：3.11.9）\n\n## 核心模块\n\n- Windows / Linux：[pywifi](https://github.com/baihengaead/pywifi)、pyside6\n- macOS：pyside6、pyperclip（WiFi 操作使用内置的 `wifi_macos.py` 模块，无需 pywifi）\n\n## 系统要求\n\n- Windows 10 及以上\n- Ubuntu 22.04 及以上版本 **（实验性）**\n- 其它支持 Python 3.11.x 以上的Linux系统 **（实验性）**\n- macOS 12 (Monterey) 及以上\n\n## 如何修改GUI\n\n1. [下载 Python 3.11.9](https://www.python.org/downloads/release/python-3119/) 并安装\n2. 安装所需模块\n\n   ```cmd\n   pip install -r requirements.txt\n   ```\n3. 启动QT Designer pyside6-designer\n\n   ```cmd\n   pyside6-designer\n   ```\n4. 在QT Designer中打开wifi_crack_tool_gui.ui\n5. 使用设计器对UI进行调整\n\n## 如何运行以及打包\n\n### Windows\n\n1. [下载 Python 3.11.9](https://www.python.org/downloads/release/python-3119/) 并安装\n\n2. 安装所需模块\n\n   ```cmd\n   pip install -r requirements_win.txt\n   ```\n\n3. 编译 wifi_crack_tool_gui.ui\n\n   ```cmd\n   pyside6-uic wifi_crack_tool_gui.ui -o wifi_crack_tool_gui.py\n   ```\n\n4. 编译运行 wifi_crack_tool.py\n\n   ```cmd\n   python -u wifi_crack_tool.py\n   ```\n\n5. 打包 wifi_crack_tool.py\n\n   ```cmd\n   pyinstaller -F -w wifi_crack_tool.py\n   ```\n\n### Linux（以 Ubuntu 24.04 为例）\n\n1. 更新软件包\n\n   ```shell\n   sudo apt update\n   sudo apt upgrade\n   ```\n\n2. 安装QT GUI依赖库 以及 剪切板依赖库\n\n   ```shell\n   sudo apt install libxcb-cursor0\n   sudo apt install xclip\n   ```\n\n3. 安装python3虚拟环境库\n\n   ```shell\n   sudo apt install python3-venv\n   ```\n\n4. 创建python3虚拟环境\n\n   ```shell\n   python3 -m venv wifi-crack-tool-venv\n   ```\n\n5. 激活python3虚拟环境\n\n   ```shell\n   source wifi-crack-tool-venv/bin/activate\n   ```\n\n6. 安装所需模块\n\n   ```shell\n   pip3 install -r requirements_linux.txt\n   ```\n\n7. 编译 wifi_crack_tool_gui.ui\n\n   ```shell\n   pyside6-uic wifi_crack_tool_gui.ui -o wifi_crack_tool_gui.py\n   ```\n\n8. 编译运行 wifi_crack_tool.py\n\n   ```shell\n   python3 -u wifi_crack_tool.py\n   ```\n\n9. 打包 wifi_crack_tool.py\n\n   ```shell\n   pyinstaller -F -w wifi_crack_tool.py\n   ```\n\n### macOS\n\n1. [下载 Python 3.11.9](https://www.python.org/downloads/release/python-3119/) 并安装\n\n2. 安装所需模块（macOS 使用独立的依赖文件，无需 pywifi）\n\n   ```shell\n   pip3 install -r requirements_macos.txt\n   ```\n\n3. 编译 wifi_crack_tool_gui.ui\n\n   ```shell\n   pyside6-uic wifi_crack_tool_gui.ui -o wifi_crack_tool_gui.py\n   ```\n\n4. 编译运行 wifi_crack_tool.py\n\n   ```shell\n   python3 -u wifi_crack_tool.py\n   ```\n\n5. 打包 wifi_crack_tool.py\n\n   ```shell\n   pyinstaller -F -w wifi_crack_tool.py\n   ```\n\n\u003e **注意**：macOS 上 WiFi 操作使用内置的 `wifi_macos.py` 模块，通过 `networksetup` 和 `system_profiler` 命令实现，无需安装 [pywifi](https://github.com/baihengaead/pywifi)。首次运行时系统可能会弹出权限请求，请允许终端/应用访问网络设置。\n\n## 更新日志\n\n### v1.2.5-maconly\n- **[新增]** 实现 macOS 平台下的 WiFi 扫描、连接、断开等功能 [wifi_macos.py](https://github.com/baihengaead/wifi-crack-tool/blob/main/wifi_macos.py) ([#60](https://github.com/baihengaead/wifi-crack-tool/pull/60)) (@dawdadsd)\n- **[修改]** 增加 macOS 平台检测和适配逻辑 [wifi_crack_tool.py](https://github.com/baihengaead/wifi-crack-tool/blob/main/wifi_crack_tool.py) ([#60](https://github.com/baihengaead/wifi-crack-tool/pull/60)) (@dawdadsd)\n- **[修改]** 适配 macOS 平台 [wifi_crack_tool_gui.py](https://github.com/baihengaead/wifi-crack-tool/blob/main/wifi_crack_tool_gui.py) ([#60](https://github.com/baihengaead/wifi-crack-tool/pull/60)) (@dawdadsd)\n- **[新增]** macOS 平台依赖列表 [requirements_macos.txt](https://github.com/baihengaead/wifi-crack-tool/blob/main/requirements_macos.txt) ([#60](https://github.com/baihengaead/wifi-crack-tool/pull/60)) (@dawdadsd)\n\n### v1.2.5\n\n- **[新增]** 支持在破解过程中**暂停**。([#26](https://github.com/baihengaead/wifi-crack-tool/issues/26))\n- **[修复]** 在设备的**WLAN功能关闭**时，**扫描WiFi会抛出意外错误**的问题。([#28](https://github.com/baihengaead/wifi-crack-tool/issues/28))\n- **[修复]** 在自动破解全部WiFi的情况下，连接完成一个WiFi后，所有**按钮的状态会被重置**的问题。\n\n### v1.2.4\n\n- **[新增]** 对**WPA3**的支持（Linux）。\n\n### v1.2.3\n\n- **[新增]** 对**WPA3**的支持（Windows）。\n- **[新增]** **自动获取**安全类型的功能（Windows）。\n- **[优化]** SSID的utf-8**编码转换**（Windows）。\n\n### v1.2.2\n\n- **[修复]** 在多网卡的情况下**意外的提示**了 “应用程序的另一个实例已经在运行。” 的问题。([#13](https://github.com/baihengaead/wifi-crack-tool/issues/13))\n- **[修复]** 在部分情况下，进行utf-8**编码转换**时，出现转换**异常**的问题。([#13](https://github.com/baihengaead/wifi-crack-tool/issues/13))\n- **[修复]** 在破解中文WiFi后，连接的**中文WiFi名称乱码**的问题。\n\n### v1.2.1\n\n- **[优化]** 对Linux平台支持。\n\n### v1.2.0\n\n- **[新增]** 对扫描到的所有WiFi进行**自动破解**。([#10](https://github.com/baihengaead/wifi-crack-tool/issues/10))\n\n### v1.1.1\n\n- **[修复]** 部分已知问题。\n\n### v1.1.0\n\n- **[重构]** GUI框架从**tkinter**更换为了**pyside6**，对UI进行了调整。\n- **[新增]** 在UI可以设置**扫描时间**、**连接时间**以及选择**无线网卡**的功能。\n- **[新增]** 打开**读取配置**文件，关闭**保存配置**文件的功能。\n- **[新增]** 破解成功将**SSID与密码保存在本地密码字典**中，并在破解WiFi时优先从本地密码字典检索相关密码进行破解。\n- **[新增]** 在拥**有多个无线网卡**的情况下，可以**多开工具**并选择不同网卡**并行破解**。\n- **[修复]** 在搜索不到WiFi时报错的问题。\n- **[优化]** 消息框中出现**破解成功**、**破解失败**以及**异常报错**的消息时，**单独**以不同颜色**高亮显示**。\n- **[优化]** 部分功能。\n\n### v1.0.0\n\n- **[新增]** 日志输出、破解成功后**自动将密码复制到剪切板**。\n- **[修复]** WiFi**中文名称乱码**，**无法正常破解**的问题。\n- **[优化]** 部分功能。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaihengaead%2Fwifi-crack-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaihengaead%2Fwifi-crack-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaihengaead%2Fwifi-crack-tool/lists"}