SuperAPI AI 工具集

unifi-network

部署与运维

查看项目

更新于 11-02 01:23

技能介绍

UniFi Network Operations 提供面向 UniFi 网络的工具集,用于按站点管理客户端、网络与 VLAN、WiFi SSID、DHCP 保留、DNS 设置、WAN 连接和访客凭证。资料说明这些工具使用本地模式 API;ACL 规则和流量匹配列表也需要本地模式,并参见 unifi-security 与 unifi-system 技能。

主要能力

客户端管理:可列出当前连接客户端、按 MAC/IP/主机名/用户名搜索客户端、获取客户端详情与流量统计、阻断或解除阻断客户端、强制无线客户端重连、通过 captive portal 授权访客、对客户端应用上传/下载带宽限制。

网络与 VLAN:可列出站点内所有网络/VLAN、获取指定网络配置详情、获取整站流量统计(仅需 site_id)、获取子网与 IP 分配信息,并可创建、修改、删除网络(删除需要 confirm=True)。

WiFi(SSID):可列出无线网络、按 SSID 获取客户端数与流量统计,创建、修改(密码、频段、VLAN、访客策略等)和删除 SSID(删除需要 confirm=True)。

DHCP 保留:可列出站点内所有静态 DHCP 分配、获取指定保留、为 MAC 地址预留 IP、更新或删除保留。

DNS 管理:可列出 WAN DNS 服务器配置、更新 WAN 接口 DNS 服务器、获取 DNS 过滤/广告拦截设置、启用或禁用 DNS 过滤类别。

WAN 与互联网:可列出 WAN 接口及其状态。

访客凭证:可列出活跃访客凭证、获取指定凭证详情、生成新凭证(数量、时间限制分钟、数据用量限制 MB;名称和时间限制为必填)、删除单个凭证或批量删除凭证。

使用方式示例

查找并阻断可疑客户端:按主机名搜索客户端后执行阻断。 创建 IoT VLAN:创建名称为 IoT、VLAN ID 20、子网 192.168.20.0/24 的网络,然后在该 VLAN 上创建 SSID “IoT-WiFi”。 修复访客上网:使用 client_id aa:bb:cc:dd:ee:ff 授权访客,duration 14400 秒,data_usage_limit_mbytes 10240 MB。 为打印机分配静态 IP:为 MAC 00:11:22:33:44:55 创建 DHCP 保留,IP 为 192.168.1.100。

适用场景与限制

适用于通过工具化方式执行 UniFi 日常网络运维,包括客户端管控、VLAN 与 SSID 配置、DHCP 保留、DNS 与 WAN 设置以及访客凭证管理。资料未提供更多部署环境、认证方式、权限要求、平台兼容性、收费或价格信息,这些内容暂未提供。