UniFi Network Monitoring Skill 是一款专为 UniFi 网络设备设计的本地监控工具，通过调用 UniFi OS 网关的只读 API（目前已在 Cloud Gateway Max 上完成测试），实现对整个网络状态的实时查询与可视化。该工具的核心价值在于为管理员提供无需复杂配置即可快速获取网络运行状况的能力，尤其适用于日常运维检查、故障排查以及远程状态汇报等场景。它不执行任何修改操作，所有请求均为安全的 GET 类型，确保不会对现有网络配置造成影响。用户只需在本地创建简单的凭据文件，填入网关地址和管理员账号信息，即可开始使用一系列预设脚本获取关键数据。无论是想了解当前连接设备的列表，还是掌握整体健康状态，亦或是分析带宽使用情况，该工具都能以清晰易读的方式呈现结果，极大提升了网络监控的效率与便捷性。
核心功能特点
- 支持通过本地 UniFi OS 网关 API 进行只读访问，安全可靠
- 可列出所有 UniFi 设备（包括 AP、交换机和网关）的状态与连接信息
- 实时显示活跃客户端列表，包含主机名、IP、MAC 地址及接入点详情
- 提供站点级健康概览，涵盖 WAN、LAN、WLAN 子系统状态与设备计数
- 基于 DPI 技术展示 Top 应用程序带宽消耗情况，助您识别流量大户
- 自动检索近期告警与事件日志，便于快速定位潜在问题
适用场景
在日常网络管理中，管理员经常需要快速确认网络是否正常运行。例如，当收到用户反馈网速缓慢或无法上网时，可以使用此工具先运行 `health.sh` 脚本来查看整体健康状态，判断是否存在断网、设备离线等问题。若发现异常，再结合 `alerts.sh` 查看最近的告警记录，精准定位故障源头。对于例行巡检，`dashboard.sh` 提供了一个完整的 ASCII 风格仪表盘，一次性展示健康指标、设备数量、在线客户端数、网络拓扑和 DPI 数据，非常适合在命令行终端中快速浏览。此外，在部署新设备后，可通过 `devices.sh` 脚本验证设备是否成功上线并被正确识别；而在进行网络优化前，利用 `top-apps.sh` 分析各应用的流量占比，有助于合理规划带宽分配策略。这些功能共同构成了一个轻量级但功能全面的网络监控解决方案，特别适合家庭实验室、小型企业或远程办公环境中的 IT 人员使用。