从模块到命令行:结合wifi-password-cli在终端快速获取WiFi密码的实战教程
2026/8/25 10:50:37 网站建设 项目流程

从模块到命令行:结合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,再取密码:

平台实现文件底层原理
Windowslib/win.js调用系统命令netsh wlan show profile并解析「Key Content」
macOSlib/osx.js从钥匙串(Keychain)中按 AirPort 网络密码条目检索
Linuxlib/linux.js读取 NetworkManager 的连接配置文件并解析 psk 字段

依赖声明见 package.json(核心依赖仅execawifi-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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询