华硕路由器管理

通过 asusrouter Python 库管理华硕路由器。支持运行原厂 AsusWRT、AsusWRT-Merlin 或 Merlin/GNUton 固件（且暴露本地 AsusWRT Web API）的任意路由器。

安装配置

1. 安装依赖项

pip install asusrouter aiohttp

2. 创建配置文件

将 config.example.yaml 复制为 config.yaml，并填写您的路由器信息：

cp skills/asus-router/config.example.yaml skills/asus-router/config.yaml

编辑 config.yaml，填入路由器的 IP 地址、用户名和密码。

3. 验证连接

python3 skills/asus-router/router.py status

支持的路由器型号

所有具备 AsusWRT Web 管理界面的华硕路由器均受支持：

• ZenWiFi（XT8、XT12、XD6 等）——完整支持 AiMesh
• RT-AX 系列（如 RT-AX86U、RT-AX88U 等）
• GT-AX 游戏系列
• ExpertWiFi / Wi-Fi 7 型号（需暴露 AsusWRT 5 / 3.0.0.6 API）
• Merlin 固件 各种变体
• AiMesh 节点（如 RP-AX56、RP-AX58 等）

命令列表

所有命令均通过 router.py 执行。若使用虚拟环境，请先激活。

快速状态查询

python3 router.py status          # WAN 状态、CPU 使用率、内存占用、AiMesh 节点数、客户端总数
python3 router.py status --json   # 输出机器可读格式（JSON）

列出已连接设备

python3 router.py clients              # 列出全部设备
python3 router.py clients --online     # 仅在线设备
python3 router.py clients --filter "iphone"   # 按设备名/IP/MAC 地址搜索
python3 router.py clients --sort speed --limit 10  # 当前带宽占用最高的前 10 台设备
python3 router.py clients --sort signal            # 按 Wi-Fi 信号强度排序（弱/强信号设备）
python3 router.py clients --json       # JSON 格式输出

谁在家（存在检测）

python3 router.py who

检查 config.yaml 中定义的已知设备，判断哪些人当前在家。

WAN 详细信息

python3 router.py wan          # 公网 IP、网关、DNS、DHCP 租约、双 WAN 状态
python3 router.py wan --json

AiMesh 拓扑结构

python3 router.py mesh         # 显示各客户端所连接的 AiMesh 节点
python3 router.py mesh --json

查找设备

python3 router.py find "samsung"
python3 router.py find "192.168.1.100"
python3 router.py find "AA:BB:CC:DD:EE:FF"

网络延迟检测

python3 router.py ping

固件 / 端口 / VPN / 健康状态

python3 router.py firmware          # 固件版本、系统信息、发布说明数据（若固件暴露该信息）
python3 router.py ports             # 以太网端口及链路状态
python3 router.py vpn               # OpenVPN、WireGuard、VPN 客户端状态（JSON 格式输出）
python3 router.py health            # 面向告警优化的综合健康状态（WAN/CPU/RAM/固件/端口/VPN）
python3 router.py raw firmware      # 按名称导出任意 AsusData 数据集

raw 命令被有意保留，以便在 AsusWRT 5 / ExpertWiFi / Guest Network Pro / VLAN 等新固件版本通过 asusrouter 暴露新的数据集时，本工具无需等待新增“美化命令”即可直接使用。
ping 命令默认检测 config.yaml 中定义的目标（默认为：网关 + Cloudflare + Google）。

重启路由器

python3 router.py reboot --confirm

⚠️ 必须显式指定 --confirm 参数。执行后将导致 2–3 分钟不可用。

常见任务

“网络断了吗？”

1. status — 检查 WAN 链路状态
2. ping — 检测到外部 IP 的延迟
3. wan — 检查 DHCP 租约与 DNS 设置

“什么占用了带宽？”

clients --online --json — 查看 rx_speed/tx_speed 字段

“谁在家？”

who — 检查 config.yaml 中 known_devices 下列出的设备

“Wi-Fi 为什么慢？”

1. mesh — 检查客户端在各 AiMesh 节点间的分布情况
2. status — 检查 CPU 与内存使用率（高 CPU 表示过载）
3. find — 查看设备信号强度（RSSI）

配置说明

所有设置均位于 config.yaml 文件中。完整模板请参考 config.example.yaml。

关键配置项：

• router.host — 路由器 IP 地址
• router.username — 管理员用户名
• router.password — 管理员密码
• router.ssl — 启用 HTTPS（默认：false）
• router.port — 可选的 Web UI/API 端口；HTTPS 本地访问常用端口为 8443
• known_devices — 用于存在检测的设备列表
• ping_targets — 自定义延迟检测目标

对于新型路由器，建议在稳定前提下优先启用 HTTPS 本地访问：在 AsusWRT 界面中进入 Administration → System → Local Access Config → Authentication Method 启用 HTTPS，随后在配置中设置 ssl: true 及对应端口号。

JSON 输出格式

在任意命令后添加 --json 参数，即可获得机器可读的 JSON 输出。适用于定时任务（cron）、心跳检测与告警集成等场景。

与 Home Assistant 集成

如需长期持续监控，还可通过 HACS 安装 ha-asusrouter：
https://github.com/Vaskivskyi/ha-asusrouter