UniFi网络管理

技能简介

基于aiounifi库开发的UniFi网络管理工具，支持通过命令行对UDM Pro/SE、Dream Machine、Cloud Key Gen2+及自托管控制器进行统一操作。

能做什么

• 查看并重启、升级网络设备（AP、交换机、网关）
• 启用或禁用交换机端口，配置PoE供电模式
• 列出、阻断、解封网络客户端，强制重连
• 管理WiFi网络：启停、修改密码、生成二维码
• 配置流量规则、防火墙策略、端口转发
• 创建访客上网凭证，控制智能电源插座

使用说明

安装依赖

pip install aiounifi
# 或使用 uv
uv pip install aiounifi

配置步骤

1. 在UniFi控制器中创建专用本地管理员账号（关闭远程访问，避免多因素认证问题）
2. 在项目根目录创建.env文件，填入以下信息：

   UNIFI_HOST=https://192.168.1.1
   UNIFI_USERNAME=agent-api
   UNIFI_PASSWORD=your_password
   UNIFI_SITE=default
   UNIFI_IS_UDM=true

3. 执行命令格式：uv run scripts/unifi.py <command> [args]

常用命令示例：

# 查看所有设备
unifi.py devices

# 重启指定MAC地址的设备
unifi.py restart aa:bb:cc:dd:ee:ff

# 阻断客户端
unifi.py block aa:bb:cc:dd:ee:ff

# 修改WiFi密码并生成二维码
unifi.py wlan-password my-wlan-id NewPass123!
unifi.py wlan-qr my-wlan-id -o wifi.png

输入与输出

见下方输入与输出表格。

风险提示

• 需要Super Admin或Site Admin权限才能完整操作
• 硬重启（--hard）会切断PoE供电，可能导致下游设备断电
• 阻断客户端操作即时生效，可能影响正常业务
• 固件升级过程中请勿中断，避免设备变砖
• 建议为自动化任务创建独立账号，定期轮换密码

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/araa47/ez-unifi/SKILL.md
来源类型：GitHub仓库