iKuai 流量报表

从 iKuai 路由器的 ikuai-cli 输出生成可视化 HTML 流量报表（5标签页、Canvas 动画图表、全静态无依赖）。

数据收集

执行以下 ikuai-cli 命令收集数据：

# 系统状态
~/.local/bin/ikuai-cli monitor system --format json

# 流量总览
~/.local/bin/ikuai-cli monitor traffic-summary --format json

# 应用流量
~/.local/bin/ikuai-cli monitor app-traffic-summary --format json

# 协议分布
~/.local/bin/ikuai-cli monitor protocols --format json

# 在线客户端
~/.local/bin/ikuai-cli monitor clients-online --format json

# 物理网口
~/.local/bin/ikuai-cli monitor interfaces-physical --format json

# WAN / LAN / DNS
~/.local/bin/ikuai-cli network wan --format json
~/.local/bin/ikuai-cli network lan list --format json
~/.local/bin/ikuai-cli network dns get --format json

# 安全规则
~/.local/bin/ikuai-cli security acl list --format json
~/.local/bin/ikuai-cli qos ip list --format json
~/.local/bin/ikuai-cli log system --format json --human-time

报表结构

数据注入字段映射

输出

报表输出到 /tmp/ikuai-report.html，用浏览器打开：

open /tmp/ikuai-report.html

故障排查

ikuai-cli 返回空数据（exit 0 但 body 为 {"data":[]}）

1. 路由器 LAN IP 不对或不可达 — ping 10.10.10.253 确认连通性
2. ikuai-cli 未配置正确地址 — ikuai-cli config list 查看目标地址
3. 认证失败（401/403）— 固件 4.0.x 可能需要登录 token
4. API 版本不匹配 — 固件 4.0.210 使用 /api/v1/session/login 认证

快速验证：

curl -s --connect-timeout 3 http://10.10.10.253:80/api/v1/monitor/system 2>&1 | head -c 200

返回 JSON 说明 API 可达；返回 HTML 说明需要认证。