从模块到命令行:结合wifi-password-cli在终端快速获取WiFi密码的实战教程
【免费下载链接】wifi-passwordGet current wifi password项目地址: https://gitcode.com/gh_mirrors/wifi/wifi-password
忘记WiFi密码时,你是否还要重启路由器或翻找便签?wifi-password是一个轻量级 Node.js 库,用于直接获取当前已连接的 WiFi 密码;配合其命令行工具wifi-password-cli,你可以在终端中一键查出密码,支持 Windows、macOS 和 Linux 三大平台。本教程带你从安装到实战,1 分钟完成上手。
👀 WiFi密码获取工具适合哪些场景?
- 📱 新设备配网、给访客分享 WiFi 时不想口述密码
- 💻 系统重装后,想恢复之前连接过的网络
- 🤖 编写脚本自动读取网络配置,实现批量部署
- ✅ 一个库同时覆盖 Windows / macOS / Linux,无需切换方案
🚀 wifi-password 一键安装步骤
方式一:从源码获取(适合想读源码的开发者)
git clone https://gitcode.com/gh_mirrors/wifi/wifi-password cd wifi-password npm install方式二:直接用 npm 安装模块
npm install wifi-password方式三:安装命令行工具(本教程重点)
npm install --global wifi-password-cli💻 三行代码:作为 Node.js 模块使用
安装后,模块用法极其简洁——调用函数并拿到 Promise 即可:
const wifiPassword = require('wifi-password'); wifiPassword().then(password => console.log(password)); // => 'your-wifi-secret'小技巧:传入一个「已知网络名称」参数,还能查询历史连接过的其他网络密码,而不只是当前网络。
⚡ 最快获取方法:终端命令行查询
这是面向普通用户最顺手的用法。全局安装后,在任意终端执行:
# 获取当前连接网络的密码 wifi-password-cli # 查询指定网络(必须是本机连接过的网络) wifi-password-cli MyHomeWiFi如果没装全局,也可以用npx wifi-password-cli临时运行,无需修改任何配置,一条命令、一个结果。
🔍 它是怎么工作的?(三大平台原理解析)
入口文件 index.js 会根据系统平台自动路由到对应实现,无参调用时先通过wifi-name依赖探测当前连接的 SSID,再取密码:
| 平台 | 实现文件 | 底层原理 |
|---|---|---|
| Windows | lib/win.js | 调用系统命令netsh wlan show profile并解析「Key Content」 |
| macOS | lib/osx.js | 从钥匙串(Keychain)中按 AirPort 网络密码条目检索 |
| Linux | lib/linux.js | 读取 NetworkManager 的连接配置文件并解析 psk 字段 |
依赖声明见 package.json(核心依赖仅execa与wifi-name两个),逻辑干净,源码不到百行,非常适合新手阅读。
🛠️ 常见问题排查清单
- ⚠️提示 "Could not get password":该网络未在本机连接过,或密码未被系统保存。请换一个连接过的网络名再试。
- ⚠️macOS 提示 "Your network doesn't have a password":说明该网络本身是免密开放网络,没有密码可取,属正常现象。
- ⚠️Linux 下无权限:读取 NetworkManager 配置文件需要管理员权限,请以 sudo 权限运行。
- ⚠️Windows 下无输出:确认系统已安装 WLAN 组件且当前用户具有读取网络配置的权限。
📁 核心文件导航
index.js—— 模块入口,负责按平台路由(第 5~19 行)lib/win.js—— Windows 平台实现,基于 netsh 命令lib/osx.js—— macOS 平台实现,基于钥匙串检索lib/linux.js—— Linux 平台实现,解析 NetworkManager 配置test.js—— 基于 ava 的冒烟测试用例package.json—— 版本与依赖声明readme.md—— 官方使用说明文档
✅ 小结
wifi-password把「查 WiFi 密码」这件小事做到了极致:模块 API 三行代码搞定,命令行工具一条命令出结果。记住两个要点——查询目标网络必须「本机连接过」,Linux 平台需要管理员权限。学会这两点,终端里取密码就是秒级操作。
🔒 温馨提示:密码属于敏感信息,请仅在自己的设备上使用,不要随意截图外传。
【免费下载链接】wifi-passwordGet current wifi password项目地址: https://gitcode.com/gh_mirrors/wifi/wifi-password
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考