SuperAPI AI 工具集

unifi-devices

部署与运维

查看项目

更新于 11-02 01:23

技能介绍

UniFi 设备管理模块用于在 UniFi 站点中查询和控制网络设备,涵盖接入点、交换机、网关等类型。除另有说明外,所有工具均要求本地 API 模式。

设备清单与详情 提供按类型列出设备(ap、switch、gateway 等)、按名称/MAC/IP/型号搜索设备、获取设备完整配置与状态、读取 CPU、内存、运行时长与流量统计,以及列出等待接入的设备并按 MAC 完成接入。另可对指定设备端口执行操作。

设备控制 支持按 ID 或 MAC 重启设备、闪烁 LED 以物理定位设备、升级固件(支持 dry-run)。AP 方面可读取射频配置,并按指定频段设置信道与功率。

端口配置文件与交换 可列出站点内所有交换机端口配置文件,查询单个配置文件的详情,并创建、修改(原生 VLAN、标记 VLAN、PoE 等)和删除配置文件。可按 MAC 查找交换机,读取交换机逐端口配置覆盖,并对端口应用配置文件或 PoE 覆盖。

交换与堆叠 支持列出链路聚合组(LAG)并查看成员与状态详情,列出交换机堆叠并查看成员与角色,列出 MCLAG 域并查看其配置。

网络拓扑 可获取站点内全部设备的上行链路树、查询连接到某设备的设备、读取设备端口级连接映射、获取链路速率与利用率等拓扑统计,并将拓扑导出为 JSON 或 CSV。

诊断 包括触发 WAN 测速(需 confirm=True)、查询测速状态与历史结果、获取 AP 的 WiFi 频谱扫描数据、列出站点检测到的干扰源,以及获取网络对象之间的交叉引用。

示例工作流 定位慢速 AP:先查拓扑统计,再对干扰最高的 AP 做频谱扫描,然后将其信道设为较不拥塞的信道。维护准备:对指定 MAC 的设备先做 LED 闪烁定位,再重启。升级全部 AP:按类型 ap 列出设备,逐个升级(先 dry_run=True)。配置 trunk 端口:通过 port_overrides 列表对设备设置逐端口覆盖,每个条目包含端口索引与端口配置文件;没有单独的 port 或 profile 参数,且 merge=False 会替换所有现有覆盖。

限制 资料未提供具体安装步骤、免费或收费信息、支持平台版本等细节;工具可用性受本地 API 模式要求约束,测速需显式确认。