captifi/unifi-device-scanner

# Captifi UniFi 设备扫描器 一款免费的桌面工具，能够发现网络中的每一台 Ubiquiti **UniFi** 设备，并允许您通过 SSH **set-inform、adopt、重启、运行诊断或恢复出厂设置** —— 所有操作均可在一个清晰的列表中完成。专为安装人员和 MSP 打造。支持在 **macOS 和 Windows** 上运行。 **➡ 下载地址：** https://www.captifi.io/unifi-device-scanner ## 功能介绍 - **发现所有设备** —— 结合 ARP、UniFi 发现和端口指纹识别技术，找出每一台 Ubiquiti 接入点、交换机和网关，包括位于其他 VLAN 或子网中的设备。 - **一键 / 批量 Set Inform** —— 将单台设备（或整个站点）指向您的 controller；系统会自动构建并运行确切的 `set-inform http://:8080/inform` 命令。 - **实时 SSH 终端** —— 实时查看每一条命令的执行情况，并提供“停止”按钮以便随时取消。 - **通过 SSH 重启和恢复出厂设置**，并提供带引导的**硬件重置操作指南**，适用于您不知道设备密码的情况。 - **即时诊断** —— 查看设备信息、正常运行时间、网关/互联网连接状态以及 DNS。 - **本地私密运行** —— 所有操作均在您的笔记本电脑上本地运行；它仅扫描您当前连接的网络，不会向云端发送任何数据。 ## 系统要求 - macOS 11+（Apple Silicon 或 Intel），或 Windows 10/11 - 与设备处于同一本地网络 - 设备的 SSH 登录凭据 —— 未采纳的设备默认使用 `ubnt / ubnt`，或者使用在您的 UniFi controller 中设置的 SSH 登录信息（设置 → 系统 → 设备 SSH 身份验证） ## 开发 / 从源码运行 ``` npm install npm run app # run the Electron desktop app npm start # run just the local server (open http://localhost:3847) npm test # run the test suite ``` ## 构建安装包 请参阅 [DISTRIBUTION.md](DISTRIBUTION.md)。 ``` npm run dist:mac # → dist/*.dmg (Apple Silicon + Intel) npm run dist:win-zip # → dist/*-win.zip (runnable, no Wine needed) npm run dist:win # → NSIS .exe installer (needs Windows or Wine) ``` ## 工作原理 它是一个 Electron 应用程序：[electron-main.js](electron-main.js) 在一个随机的 loopback 端口上启动本地扫描器服务器（[server.js](server.js)），并在原生窗口中显示 UI（[public/index.html](public/index.html)）。所有的发现和 SSH 操作都在安装了该软件的本地机器上运行 —— 无需托管任何服务。 ## 许可证 采用 [PolyForm Noncommercial License 1.0.0](LICENSE) 授权。 您可以出于任何**非商业**目的自由使用、复制、修改和分享本软件。严禁出售本软件，或将其作为付费/商业产品或服务的一部分使用。完整条款请参阅 [LICENSE](LICENSE) 文件。 版权所有 © CaptiFi Ltd (https://www.captifi.io)

标签：Docker 部署, Electron, MITM代理, SSH, UniFi, 云存储安全, 后端开发, 多模态安全, 数据可视化, 桌面应用, 网络扫描, 网络运维, 设备管理