From 88a35ea42722be479db30871114fd6032b038886 Mon Sep 17 00:00:00 2001 From: Sakurasan <26715255+Sakurasan@users.noreply.github.com> Date: Tue, 13 Oct 2026 23:37:04 +0800 Subject: [PATCH] =?UTF-8?q?Initial:=20DHCP=20=E5=AE=A2=E6=88=B7=E7=AB=AF?= =?UTF-8?q?=E7=9B=91=E6=8E=A7=E5=8F=8C=E6=A8=A1=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - client 模式抓取水星 MW305R DHCP 列表,记录上下线,本地看板 - server 模式收上报,按站点分组持久化,多站点看板,7天滚动 - ESP8266 低功耗固件抓原始 HTML 上报 /api/raw,服务器端解析 - 部署脚本+systemd 单元+文档,交叉编译 Linux 二进制 --- .gitignore | 11 + README.md | 212 +++++++ deploy/README.md | 114 ++++ deploy/dhcp-mon-server.service | 22 + deploy/install-server.sh | 51 ++ firmware/esp8266/.gitignore | 8 + firmware/esp8266/README.md | 106 ++++ firmware/esp8266/platformio.ini | 18 + firmware/esp8266/src/main.cpp | 184 ++++++ firmware/esp8266/src/secrets.h.example | 27 + go.mod | 5 + go.sum | 2 + main.go | 770 +++++++++++++++++++++++++ main_test.go | 111 ++++ raw_test.go | 238 ++++++++ report.go | 109 ++++ server.go | 531 +++++++++++++++++ server_test.go | 142 +++++ web/dashboard.html | 195 +++++++ web/index.html | 151 +++++ 20 files changed, 3007 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 deploy/README.md create mode 100644 deploy/dhcp-mon-server.service create mode 100644 deploy/install-server.sh create mode 100644 firmware/esp8266/.gitignore create mode 100644 firmware/esp8266/README.md create mode 100644 firmware/esp8266/platformio.ini create mode 100644 firmware/esp8266/src/main.cpp create mode 100644 firmware/esp8266/src/secrets.h.example create mode 100644 go.mod create mode 100644 go.sum create mode 100644 main.go create mode 100644 main_test.go create mode 100644 raw_test.go create mode 100644 report.go create mode 100644 server.go create mode 100644 server_test.go create mode 100644 web/dashboard.html create mode 100644 web/index.html diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..30a4740 --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +# 构建产物 +/dhcp-mon +/dhcp-mon-linux-amd64 +/dhcp-mon-linux-arm64 +/dhcpclient + +# 运行时数据 (设备MAC/IP/事件, 含隐私, 勿提交) +/data/ + +# macOS +.DS_Store \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..db1c3a2 --- /dev/null +++ b/README.md @@ -0,0 +1,212 @@ +# DHCP 客户端监控 + 数据上报看板 + +抓取水星 MW305R 路由器(192.168.1.1)的 DHCP 客户端列表,记录每个设备的**上线/下线时间**,支持**本地展示**和**公网多站点看板**。数据滚动保留 7 天。 + +## 架构 + +``` +┌─ 本地(树莓派等) ─────────────────────────┐ ┌─ 公网服务器 ────────────────────────┐ +│ 路由器(192.168.1.1) │ │ │ +│ │ DHCP列表(每60s抓取) │ │ dhcp-mon -mode server │ +│ ▼ │ │ ├─ POST /api/report ←─ 接收上报 │ +│ dhcp-mon -mode client │ │ │ (带 token 认证) │ +│ ├─ 判定上线/下线 → events.csv/devices.json│ │ ├─ 按 site 分组存储(7天保留) │ +│ └─ 上报 (事件增量+设备快照) ─────────────┼──▶│ └─ 多站点看板 :8080(公网访问) │ +└───────────────────────────────────────────┘ └────────────────────────────────────┘ +``` + +- **一个二进制 `dhcp-mon`**,两种模式 +- **client(采集端)**:抓路由器 DHCP 列表,判定上下线,本地存数据,按周期上报 +- **server(看板端)**:公网接收上报,按站点分组存储,提供多站点看板页 +- **上报内容**:增量事件 + 全量设备快照,服务器据此精确还原当前在线状态 +- **认证**:client 用 `-token` 上报,server 用 `-stoken` 校验,不匹配拒绝;看板也需 token 访问 +- **低功耗采集端**:ESP8266 可只抓原始页面 POST 到 `POST /api/raw`,由服务器端解析 + 判定(见下文) + +## 服务器端部署(公网) + +```bash +# 服务器上,反向代理或直接端口 +./dhcp-mon -mode server -web :8080 -data /srv/dhcp-data -stoken '你的令牌' -retain 7 + +# 浏览器访问(需token) +# http://<服务器IP>:8080/?token=你的令牌 +``` + +看板功能: +- 站点切换栏(每个上报的 site 一个按钮,显示在线/总数) +- 统计卡片:在线/离线/总数/事件数 +- 设备表:状态、MAC、IP、首次/最近上线/下线、在线次数、累计在线 +- 事件流:上下线事件,最新在前 +- 每 5 秒自动刷新 + +## 采端端部署(树莓派/本地) + +```bash +# 树莓派上(能访问到路由器 192.168.1.1) +./dhcp-mon -mode client \ + -host 192.168.1.1 \ + -password 123456 \ + -site home \ + -report http://<服务器IP>:8080/api/report \ + -token '你的令牌' \ + -data /home/pi/dhcp-data + +# 后台常驻(systemd / nohup 均可) +nohup ./dhcp-mon -mode client -host 192.168.1.1 -password 123456 \ + -site home -report http://<服务器IP>:8080/api/report -token '你的令牌' \ + > /home/pi/dhcp-mon.log 2>&1 & +``` + +多个采集点:每台树莓派给不同的 `-site`(如 home/office/shop),看板自动分组展示。 + +采集端不配 `-report` 时仅在本地工作(保留原来单机功能)。 + +## 低功耗采集:ESP8266 + 服务器端解析 + +想做到极致低功耗(深度睡眠,一天耗电 <0.1Wh),用 ESP8266 只做「登录 → 抓页面 → 把原始 HTML POST 给服务器」,**解析和上下线判定全部放服务器端**,不移植 Go 代码,固件极简: + +``` +ESP8266 (每15分钟深度睡眠唤醒) + ├─ HTTP 登录路由器:设 Cookie `Authorization=Basic base64("admin:"+密码)`,带浏览器UA + ├─ GET /userRpm/AssignedIpAddrListRpm.htm → 拿到原始 HTML + └─ POST http://服务器:8080/api/raw (Header X-Token + X-Site, body=原始HTML) + 服务器: 解析 DHCPDynList → 判定上线/下线 → 记录事件 → 持久化 +``` + +### /api/raw 上报协议 + +- **方法**:`POST` +- **认证**:`Header X-Token: <令牌>`(或 query `?token=`),与 server 的 `-stoken` 一致 +- **站点**:`Header X-Site: home`(或 query `?site=home`) +- **body**:原始路由器页面 HTML(`/userRpm/AssignedIpAddrListRpm.htm` 的完整响应),可直接上传,无需转码 + +**响应**(JSON): +```json +{"ok": true, "site": "home", "clients": 3, "device_count": 4, "time": "2026-10-12T13:15:18+08:00"} +``` + +**错误响应**: +| HTTP | 含义 | +|---|---| +| `401` | token 不匹配 | +| `400` | 缺 site / body 为空 / 页面无法解析 | +| `502` | 路由器返回认证失败页(403/密码错误)——ESP8266 应据此重新登录或换密码 | + +**判定规则**:与 client 模式一致——设备首次出现记上线事件;连续 2 次上报缺席判定下线(防抖,等价 `-absent 2`);按 X-Site 独立状态机,互不干扰。 + +**注**:节点上报的原始页面包含完整 HTTP 头(UTF-8 或 GBK 均可,服务器端自动转码)。 + +### ESP8266 关键注意点 + +1. **认证 cookie 必须无引号**:`Authorization=Basic xxx`,不能用标准 cookie 编码(会加引号导致 403) +2. **必须带浏览器 User-Agent + Referer**,否则水星路由器返回 403 +3. **上线判定**:首次抓到的当前在线设备会记一条上线事件,服务器端快照以最近一次上报为准 +4. 网络/服务器不可达时 ESP8266 内部应保留原始页面上报失败重试(简单起见可直接丢弃,下轮再抓;上下线判定在服务器端做,不漏事件) + +### ESP8266 固件(PlatformIO 刷写) + +固件在 `firmware/esp8266/`(源码 + 详细接线/排查见其 README),功能: +WiFi 连接 → 登录路由器抓原始 DHCP 页面 → POST `/api/raw` → 深度睡眠(默认 15 分钟)。 + +```bash +# 1. 配置: 编辑 firmware/esp8266/src/secrets.h +# (WiFi / SERVER_URL / X_TOKEN=X stoken / X_SITE / ROUTER_PASS / SLEEP_SECONDS) + +# 2. 编译 +~/.platformio/penv/bin/pio run -d firmware/esp8266 + +# 3. 上传(串口已接好,如 /dev/cu.usbserial-1430) +~/.platformio/penv/bin/pio run -d firmware/esp8266 -t upload \ + --upload-port /dev/cu.usbserial-1430 + +# 4. 串口日志确认(115200) +~/.platformio/penv/bin/pio device monitor -p /dev/cu.usbserial-1430 -b 115200 +``` + +要点: +- 登录 cookie 必须无引号(固件已按 `Authorization=Basic xxx` 手动设置),必须带浏览器 UA + Referer +- **定时深睡唤醒需把 GPIO16(D0) 短接到 RST**,否则只靠手动复位触发 +- ESP8266 仅支持 2.4GHz WiFi +- 上报成功日志示例:`{"ok":true,"site":"home","clients":3,...}` + +## 参数 + +| 参数 | 默认 | 说明 | +|---|---|---| +| `-mode` | `client` | `client`(采集上报)/ `server`(接收+看板) | +| `-host` | `192.168.1.1` | 路由器管理地址(client) | +| `-password` | `123456` | 路由器管理员密码(client) | +| `-https` | `false` | 使用 https 访问路由器 | +| `-timeout` | `10` | HTTP 超时秒数 | +| `-interval` | `60s` | 抓取间隔(clent) | +| `-data` | `./data` | 数据目录 | +| `-web` | `:8080` | Web 监听地址(server 看板 / client 本地页) | +| `-retain` | `7` | 数据保留天数(滚动清理) | +| `-absent` | `2` | 连续缺席多少次判定下线(防抖) | +| `-site` | 空 | 站点标识(client 上报用) | +| `-report` | 空 | 上报地址 `http://server:8080/api/report`(空=不上报) | +| `-token` | 空 | client 上报令牌(需与 server `-stoken` 一致) | +| `-stoken` | 空 | server 接收/看板令牌 | +| `-once` | `false` | 仅抓取一次打印列表 | +| `-quiet` | `false` | 安静模式 | + +## Web API + +**server 模式**: +| 端点 | 说明 | +|---|---| +| `GET /` | 多站点看板页面(需 token) | +| `POST /api/report` | 采集端上报(事件+快照),带 token | +| `POST /api/raw` | ESP8266 原始页面上报(Header X-Token/X-Site,body=原始HTML),服务器端解析判定 | +| `GET /api/sites` | 站点列表(在线数/设备数/最近上报) | +| `GET /api/site?site=X` | 单站点详情(设备+事件) | + +**client 模式**(本地): +| 端点 | 说明 | +|---|---| +| `GET /` | 本地展示页面 | +| `GET /api/devices` | 设备 JSON | +| `GET /api/events` | 事件 JSON | + +## 数据保留(滚动清理) + +默认 7 天(`-retain`),每天清理一次: +- `events.csv`:删除超期事件 +- `devices.json`:移除离线超 7 天的设备(在线永远保留) +- server 端按站点目录存储(`data/sites//`),同样 7 天滚动 + +## 下线时间误差说明 + +**DHCP 租约默认 10 分钟**:设备断开后路由器 DHCP 列表仍保留直到租约到期才移除,因此**检测到的下线时间比真实晚 0~10 分钟**。这是 DHCP 列表监控的固有限制。`-absent 2` 的防抖(缺 2 次判定下线)避免误判。 + +## 输出文件(client 端) + +**events.csv**: +``` +timestamp,event,mac,ip,name,detail +2026-10-12T13:15:18+08:00,online,40-AC-BF-D2-B0-1E,192.168.1.100,K23879676,00:05:52 +2026-10-12T13:23:04+08:00,offline,A2-C5-F2-03-A9-EA,192.168.1.112,PgyBox_X1-2111,在线时长 00h00m; 下线检测误差≤10m(DHCP租约) +``` + +**devices.json**: +```json +{ + "40-AC-BF-D2-B0-1E": { + "mac": "40-AC-BF-D2-B0-1E", "name": "K23879676", + "last_ip": "192.168.1.100", "status": "online", + "first_seen": "2026-10-12T13:15:18+08:00", + "last_online": "2026-10-12T13:15:18+08:00", + "last_offline": "2026-10-12T13:23:04+08:00", + "online_count": 2, "total_online_seconds": 3600 + } +} +``` + +server 端存储结构:`data/sites//devices.json` + `events.csv`。 + +## 实现要点 + +- 路由器认证:设置 `Authorization` cookie = `Basic base64("admin:"+密码)`,必须带浏览器 User-Agent,否则 403 +- 数据源:`/userRpm/AssignedIpAddrListRpm.htm` 页面的 `DHCPDynList` JS 数组,每 4 元素 = 一条记录(名/MAC/IP/租约) +- 上报协议(树莓派采集端):`POST /api/report` body = `{site, token, events[], snapshot:{devices[]}}`,失败自动重传 +- 上报协议(ESP8266 采集端):`POST /api/raw` body = 原始路由器页面 HTML,Header 带 `X-Token` + `X-Site`,服务器端解析 `DHCPDynList` 并做上下线判定 \ No newline at end of file diff --git a/deploy/README.md b/deploy/README.md new file mode 100644 index 0000000..996c501 --- /dev/null +++ b/deploy/README.md @@ -0,0 +1,114 @@ +# VPS 部署 dhcp-mon server(收集 + 看板) + +server 模式:公网监听 HTTP 端口,接收采集端(树莓派 client / ESP8266 raw)上报,按站点分组存储,提供多站点看板。 + +## 一、本机交叉编译(已产出) + +```bash +# 在项目根目录 +GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o dhcp-mon-linux-amd64 . +GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o dhcp-mon-linux-arm64 . +``` + +产物: +- `dhcp-mon-linux-amd64` —— x86_64 静态编译,绝大多数 VPS 用这个 +- `dhcp-mon-linux-arm64` —— ARM64 静态编译(如 AWS Graviton / 树莓派 4) + +> 静态编译(`CGO_ENABLED=0`),无需服务器装 Go,直接拷上去就能跑。 + +## 二、拷贝到 VPS + +```bash +scp dhcp-mon-linux-amd64 deploy/dhcp-mon-server.service deploy/install-server.sh \ + user@:/tmp/ +``` + +## 三、服务器上执行部署 + +```bash +sudo bash /tmp/install-server.sh /tmp/dhcp-mon-linux-amd64 你的令牌 8080 +``` + +脚本会: +1. 把二进制装到 `/opt/dhcp-mon/dhcp-mon` +2. 创建专用用户 `dhcpmon` + 数据目录 `/srv/dhcp-data` +3. 写配置 `/etc/dhcp-mon-server.env`(仅 root 可读,含令牌) +4. 安装并启动 systemd 服务,开机自启 + +部署完成会打印: +- **看板地址**:`http://<服务器IP>:8080/?token=你的令牌` +- **令牌**(上报与看板共用) +- 查看状态/日志的命令 + +### systemd 单元(/etc/systemd/system/dhcp-mon-server.service) + +```ini +[Service] +User=dhcpmon +EnvironmentFile=/etc/dhcp-mon-server.env +ExecStart=/opt/dhcp-mon/dhcp-mon -mode server -web $WEB_ADDR -data $DATA_DIR -stoken $STOKEN -retain $RETAIN_DAYS +Restart=always +RestartSec=5 +``` + +`/etc/dhcp-mon-server.env`: +``` +WEB_ADDR=:8080 +DATA_DIR=/srv/dhcp-data +STOKEN=你的令牌 +RETAIN_DAYS=7 +``` + +## 四、验证 + +```bash +systemctl status dhcp-mon-server # 应显示 active (running) +curl -s 'http://127.0.0.1:8080/?token=你的令牌' | head # 看到看板 HTML +curl -s 'http://127.0.0.1:8080/api/sites?token=你的令牌' # 站点列表(初始 {sites:[],...}) +``` + +## 五、放行端口 + +```bash +# firewalld +sudo firewall-cmd --add-port=8080/tcp --permanent && sudo firewall-cmd --reload +# ufw +sudo ufw allow 8080/tcp +``` + +若走公网/有域名,建议在 Nginx/Caddy 反代并上 HTTPS(见下文)。 + +## 六、采集端配置(ESP8266 secrets.h) + +`firmware/esp8266/src/secrets.h`: +``` +SERVER_URL = "http://<服务器IP>:8080/api/raw" +X_TOKEN = 与 STOKEN 一致 +X_SITE = 站点名(如 home) +``` + +树莓派 client 模式上报对应 `-report http://:8080/api/report -token STOKEN -site home`。 + +## 七、(可选)Nginx 反代 + HTTPS + +```nginx +server { + listen 80; + server_name dhcp.example.com; + return 301 https://$host$request_uri; +} +server { + listen 443 ssl; + server_name dhcp.example.com; + ssl_certificate /etc/letsencrypt/live/dhcp.example.com/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/dhcp.example.com/privkey.pem; + + location / { + proxy_pass http://127.0.0.1:8080; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + } +} +``` + +> 看板与上报用同一 token 保护;反代仅加密传输,不改变令牌机制。ESP8266 的 `SERVER_URL` 改用 `https://...` 即可(需固件支持 TLS,当前固件为 HTTP 直连,如走 HTTPS 需评估内存)。 \ No newline at end of file diff --git a/deploy/dhcp-mon-server.service b/deploy/dhcp-mon-server.service new file mode 100644 index 0000000..39e2249 --- /dev/null +++ b/deploy/dhcp-mon-server.service @@ -0,0 +1,22 @@ +[Unit] +Description=dhcp-mon server (DHCP client monitor dashboard) +After=network-online.target +Wants=network-online.target + +[Service] +Type=simple +User=dhcpmon +Group=dhcpmon +EnvironmentFile=/etc/dhcp-mon-server.env +ExecStart=/opt/dhcp-mon/dhcp-mon -mode server \ + -web ${WEB_ADDR} \ + -data ${DATA_DIR} \ + -stoken ${STOKEN} \ + -retain ${RETAIN_DAYS} +Restart=always +RestartSec=5 +# 数据目录持久化 +# 建议同时做数据目录备份(可 cron 定期 rsync) + +[Install] +WantedBy=multi-user.target diff --git a/deploy/install-server.sh b/deploy/install-server.sh new file mode 100644 index 0000000..a7282d6 --- /dev/null +++ b/deploy/install-server.sh @@ -0,0 +1,51 @@ +#!/usr/bin/env bash +# dhcp-mon server 一键部署脚本(VPS) +# 用法: +# sudo ./install-server.sh [stoken] [端口] +# 示例: +# sudo ./install-server.sh ./dhcp-mon-linux-amd64 MySecretToken 8080 +# (stoken 缺省时自动生成并打印) +set -euo pipefail + +BIN="${1:?用法: sudo ./install-server.sh <二进制路径> [stoken] [端口]}" +STOKEN="${2:-$(openssl rand -hex 16)}" +PORT="${3:-8080}" +APP=/opt/dhcp-mon +DATA=/srv/dhcp-data +USER=dhcpmon + +echo "==> 安装二进制到 $APP" +install -d "$APP" +install -m 0755 "$BIN" "$APP/dhcp-mon" +"$APP/dhcp-mon" -h >/dev/null 2>&1 || true # 顺手验证可执行(server 模式参数见 README) + +echo "==> 创建专用用户与数据目录" +id "$USER" >/dev/null 2>&1 || useradd -r -s /usr/sbin/nologin "$USER" +install -d -o "$USER" -g "$USER" -m 0755 "$DATA" + +echo "==> 写入环境配置 /etc/dhcp-mon-server.env (权限 600)" +install -d /etc +umask 077 +cat > /etc/dhcp-mon-server.env < 安装 systemd 单元" +SRC="$(cd "$(dirname "$0")" && pwd)/dhcp-mon-server.service" +install -m 0644 "$SRC" /etc/systemd/system/dhcp-mon-server.service +systemctl daemon-reload +systemctl enable --now dhcp-mon-server + +echo +echo "✅ 部署完成" +echo " 令牌(上报与看板共用): $STOKEN" +echo " 看板: http://<服务器IP>:${PORT}/?token=${STOKEN}" +echo " 状态: systemctl status dhcp-mon-server" +echo " 日志: journalctl -u dhcp-mon-server -f" +echo +echo " ⚠️ 把令牌记好/改掉: 可随时编辑 /etc/dhcp-mon-server.env 后 systemctl restart dhcp-mon-server" diff --git a/firmware/esp8266/.gitignore b/firmware/esp8266/.gitignore new file mode 100644 index 0000000..d56fc65 --- /dev/null +++ b/firmware/esp8266/.gitignore @@ -0,0 +1,8 @@ +# PlatformIO build artifacts +.pio/ +.vscode/ +.pioenvs/ +.piolibdeps/ + +# 用户配置(含 WiFi 密码/上报令牌),勿提交 +src/secrets.h diff --git a/firmware/esp8266/README.md b/firmware/esp8266/README.md new file mode 100644 index 0000000..bcd8261 --- /dev/null +++ b/firmware/esp8266/README.md @@ -0,0 +1,106 @@ +# ESP8266 低功耗 DHCP 采集固件 + +极简固件:**登录水星 MW305R 路由器 → 抓取 DHCP 客户端页面的原始 HTML → POST 给 +`dhcp-mon server` 的 `/api/raw` → 深度睡眠 15 分钟**。解析与上下线判定全部在 +服务器端,固件不移植任何 Go 逻辑。 + +## 原理 + +``` + ESP8266 (每 SLEEP_SECONDS 秒深睡唤醒) + ├─ WiFi 连接(仅 2.4GHz) + ├─ HTTP 登录路由器: Cookie = Authorization=Basic base64("admin:"+密码) ← 无引号! + │ 带浏览器 User-Agent + Referer(缺一 403) + ├─ GET /userRpm/AssignedIpAddrListRpm.htm → 拿到原始 HTML(GBK 也可) + └─ POST http://服务器:8080/api/raw (Header X-Token + X-Site, body=原始HTML) + 服务器: 解析 DHCPDynList → 判定上线/下线 → 事件 → 持久化 +``` + +## 文件 + +| 文件 | 说明 | +|---|---| +| `platformio.ini` | PlatformIO 工程配置(NodeMCU v2 / espressif8266) | +| `src/main.cpp` | 源码: WiFi → 登录抓页 → 上报 → 深睡 | +| `src/secrets.h` | **用户配置**: WiFi / 服务器 / 令牌 / 站点 / 路由器密码 / 间隔 | +| `src/secrets.h.example` | 提交到 git 的配置模板(不含真实凭据),复制为 secrets.h 填写 | + +## 配置 + +首次使用: `cp src/secrets.h.example src/secrets.h`,然后把 `src/secrets.h` 里的占位符换成你的真实值: + +```cpp +WIFI_SSID / WIFI_PASS // ESP8266 只能连 2.4GHz +SERVER_URL // 例 http://192.168.1.200:8080/api/raw +X_TOKEN // 与 server 的 -stoken 一致 +X_SITE // 站点名,如 home +ROUTER_HOST // 默认 192.168.1.1 +ROUTER_PASS // 路由器管理员密码(用户名固定 admin) +SLEEP_SECONDS // 采集间隔,默认 900(15分钟) +``` + +## 接线 + +NodeMCU/ESP8266 板基本免接线即可刷写与运行: + +- **供电**:USB 供电即可;独立使用时接 3.3V-G 对 (VIN-GND)。 +- **板载 LED**:每次唤醒点亮 150ms 提示工作正常。 +- **深睡唤醒跳线(可选,才真正做到定时深睡)**:把 `GPIO16(D0)` 短接到 `RST`, + ESP8266 才能自动唤醒。**不接这条线时**模组会持续运行到底(loop 里兜底深睡立即 + 恢复),此时每次间隔靠 RST 复位触发,低功耗效果打折。 +- 深睡期间电流约 20µA,一天耗电可 <0.1Wh。 + +## 刷写(PlatformIO) + +本项目没把 `pio` 放进 PATH,用完整路径: + +```bash +# 1. 编译 +~/.platformio/penv/bin/pio run -d firmware/esp8266 + +# 2. 查看串口(macOS) +ls /dev/cu.usbserial-* + +# 3. 上传到模组(自动找串口;指定端口可加 --upload-port) +~/.platformio/penv/bin/pio run -d firmware/esp8266 -t upload \ + --upload-port /dev/cu.usbserial-1430 + +# 4. 串口监视(看日志,115200 波特率) +~/.platformio/penv/bin/pio device monitor -p /dev/cu.usbserial-1430 -b 115200 +``` + +固件产物: `firmware/esp8266/.pio/build/nodemcuv2/firmware.bin` +(可手动用 esptool 刷: `esptool.py --port ... write_flash 0x0 firmware.bin`) + +## 串口日志示例 + +``` +=== ESP8266 DHCP 采集固件 === +[wifi] 连接 你的WiFi名称 ... +[wifi] 已连接,IP=192.168.1.150 +[router] 抓到页面 2145 字节 +[report] POST /api/raw -> HTTP 200 +{"ok":true,"site":"home","clients":3,"device_count":4,"time":"2026-10-12T13:15:18+08:00"} +[sleep] 深度睡眠 900 秒 +``` + +### 常见日志 → 排查 + +| 日志 | 含义 / 处理 | +|---|---| +| `[wifi] 连接超时` | WiFi 名/密码错,或连了 5G 频段(必须 2.4G) | +| `[router] 根页面访问失败 / DHCP 页面抓取失败` | 路由器不可达,检查 `ROUTER_HOST`、供电、网线 | +| `[router] 认证被拒绝(403)` | 密码被改 / 路由器锁定 / 被管理页面限制 | +| `[router] 认证失败: 密码不正确或已锁定` | `ROUTER_PASS` 不对,或在路由器上换密码 | +| `[report] POST -> HTTP 401` | `X_TOKEN` 与 server `-stoken` 不一致 | +| `[report] POST -> HTTP 400` | body 为空 / 页面没解析出数据(服务器返回详情) | +| `[report] POST -> HTTP 502` | 服务器判定刚才的页面是认证失败页(见上) | +| `HTTP -1` | 服务器不可达(网络/地址错),本轮丢弃,下轮再试 | + +## 功耗/间隔 + +`SLEEP_SECONDS` 即深睡时长: WiFi 连接 + 两次网页抓取 + 一次上报,一次完整流程约 +2~5 秒,其余时间深睡。15 分钟间隔下一天约 96 次采集,总耗电极低。 + +> 注意: ESP8266 单次 `ESP.deepSleep` 上限约 **3.5 小时**。若间隔 >3.5h, +> 需要在深睡唤醒后判断时间再决定是否深睡多段(本固件未做,间隔默认 15 分钟远小于上限)。 \ No newline at end of file diff --git a/firmware/esp8266/platformio.ini b/firmware/esp8266/platformio.ini new file mode 100644 index 0000000..a62b8ab --- /dev/null +++ b/firmware/esp8266/platformio.ini @@ -0,0 +1,18 @@ +; PlatformIO 工程: 低功耗 DHCP 抓取固件(ESP8266 NodeMCU) +; 刷写: ~/.platformio/penv/bin/pio run -t upload +; 串口监视: ~/.platformio/penv/bin/pio device monitor -b 115200 + +[env:nodemcuv2] +platform = espressif8266 +board = nodemcuv2 +framework = arduino + +; 二进制在编译时不变(用固定的区段),理论上可配合 OTA,本工程用串口刷写 +; 上传端口: 若 pio 未自动识别,用 --upload-port 指定 +; upload_port = /dev/cu.usbserial-1430 + +; 串口监视波特率 +monitor_speed = 115200 + +; 编译输出固件 +; .pio/build/nodemcuv2/firmware.bin diff --git a/firmware/esp8266/src/main.cpp b/firmware/esp8266/src/main.cpp new file mode 100644 index 0000000..df2c71c --- /dev/null +++ b/firmware/esp8266/src/main.cpp @@ -0,0 +1,184 @@ +// ESP8266 低功耗 DHCP 抓取固件 +// 功能: 登录水星 MW305R 路由器 → GET /userRpm/AssignedIpAddrListRpm.htm +// 拿到原始页面 HTML → POST 给 dhcp-mon server 的 /api/raw +// → 深度睡眠 SLEEP_SECONDS 秒。 +// +// 解析和上下线判定全部在服务器端(与 README 的 /api/raw 协议一致), +// 本固件只做「登录 → 抓页面 → 原样转发」,逻辑极简。 +// +// 关键注意点(来自实测): +// 1. 认证 Cookie 必须是无引号的 "Authorization=Basic xxx"(标准 cookie +// 编码会加引号 → 路由器 403),因此这里手动设置 Cookie 头。 +// 2. 必须带浏览器 User-Agent + Referer,否则路由器返回 403。 +// 3. ESP8266 只能连 2.4GHz WiFi。 +// +// 刷写: 见 firmware/esp8266/README.md + +#include +#include +#include + +#include "secrets.h" + +// 与 Go 端 main.go 的 defaultUA 保持一致 +static const char *UA = + "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 " + "(KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36"; + +// 简单 base64 编码(避免依赖核心版本的 base64.h,量很小且确定) +static const char B64[] = + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; + +static String base64Encode(const String &in) { + String out; + out.reserve((in.length() + 2) / 3 * 4); + const uint8_t *d = (const uint8_t *)in.c_str(); + size_t i = 0; + size_t len = in.length(); + while (i + 3 <= len) { + uint32_t n = (d[i] << 16) | (d[i + 1] << 8) | d[i + 2]; + out += B64[(n >> 18) & 63]; + out += B64[(n >> 12) & 63]; + out += B64[(n >> 6) & 63]; + out += B64[n & 63]; + i += 3; + } + size_t rem = len - i; + if (rem == 1) { + uint32_t n = d[i] << 16; + out += B64[(n >> 18) & 63]; + out += B64[(n >> 12) & 63]; + out += "=="; + } else if (rem == 2) { + uint32_t n = (d[i] << 16) | (d[i + 1] << 8); + out += B64[(n >> 18) & 63]; + out += B64[(n >> 12) & 63]; + out += B64[(n >> 6) & 63]; + out += '='; + } + return out; +} + +// 向路由器发 GET,返回响应体(原始字节,可能 GBK);失败返回空字符串 +static String routerGet(HTTPClient &http, WiFiClient &wifi, + const String &url, const String &referer, + const String &authCookie) { + http.begin(wifi, url); + http.setTimeout(8000); + http.addHeader("User-Agent", UA); + http.addHeader("Referer", referer); + // 关键: 手动设置 Cookie,避免库对 cookie 值加引号 + http.addHeader("Cookie", "Authorization=" + authCookie); + int code = http.GET(); + if (code != HTTP_CODE_OK) { + Serial.printf("[router] GET %s -> HTTP %d\n", url.c_str(), code); + http.end(); + return String(); + } + String body = http.getString(); + http.end(); + return body; +} + +// 登录路由器并抓取 DHCP 客户端页面的原始 HTML +static String fetchRouterPage(WiFiClient &wifi) { + String auth = "Basic " + base64Encode(String(ROUTER_ADMIN) + ":" + ROUTER_PASS); + + HTTPClient http; + // 先访问根页面建立会话(与 Go 端 fetch() 行为一致) + String root = routerGet(http, wifi, "http://" + String(ROUTER_HOST) + "/", + "http://" + String(ROUTER_HOST) + "/", auth); + if (root.length() == 0) { + Serial.println("[router] 根页面访问失败"); + return String(); + } + + String page = routerGet( + http, wifi, + "http://" + String(ROUTER_HOST) + "/userRpm/AssignedIpAddrListRpm.htm", + "http://" + String(ROUTER_HOST) + "/userRpm/MenuRpm.htm", auth); + if (page.length() == 0) { + Serial.println("[router] DHCP 页面抓取失败"); + return String(); + } + if (page.indexOf("403 Forbidden") >= 0 || + page.indexOf("You have no authority") >= 0) { + Serial.println("[router] 认证被拒绝(403): 检查密码或路由器锁定"); + return String(); + } + if (page.indexOf("httpAutErrorArray") >= 0 || + page.indexOf("pcPassword") >= 0) { + Serial.println("[router] 认证失败: 密码不正确或已锁定"); + return String(); + } + Serial.printf("[router] 抓到页面 %d 字节\n", page.length()); + return page; +} + +// 把原始页面 POST 给服务器 /api/raw +static int reportPage(WiFiClient &wifi, const String &page) { + HTTPClient http; + http.begin(wifi, SERVER_URL); + http.setTimeout(10000); + http.addHeader("Content-Type", "text/html; charset=GBK"); + http.addHeader("X-Token", X_TOKEN); + http.addHeader("X-Site", X_SITE); + int code = http.POST(page); + String resp = http.getString(); + http.end(); + Serial.printf("[report] POST /api/raw -> HTTP %d\n", code); + if (code > 0) { + Serial.println(resp); + } + return code; +} + +void setup() { + Serial.begin(115200); + Serial.println(); + Serial.println("=== ESP8266 DHCP 采集固件 ==="); + + // 短暂点亮板载 LED 提示本次唤醒 + pinMode(LED_BUILTIN, OUTPUT); + digitalWrite(LED_BUILTIN, LOW); + delay(150); + digitalWrite(LED_BUILTIN, HIGH); + + // 连接 WiFi(ESP8266 仅支持 2.4GHz) + WiFi.mode(WIFI_STA); + WiFi.begin(WIFI_SSID, WIFI_PASS); + Serial.printf("[wifi] 连接 %s ...\n", WIFI_SSID); + uint32_t t0 = millis(); + while (WiFi.status() != WL_CONNECTED) { + if (millis() - t0 > 20000) { + Serial.println("[wifi] 连接超时,直接进入深度睡眠"); + ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT); + return; // 不会到达 + } + delay(500); + } + Serial.printf("[wifi] 已连接,IP=%s\n", WiFi.localIP().toString().c_str()); + + WiFiClient wifi; + // 登录路由器 + 抓页面 + String page = fetchRouterPage(wifi); + if (page.length() > 0) { + // 原样转发原始 HTML(服务器端解析 DHCPDynList + 上下线判定) + reportPage(wifi, page); + } else { + Serial.println("[report] 无页面可上报,跳过本轮"); + } + + // 深度睡眠到下一轮(固定间隔,低功耗) + // 注: 自动唤醒需 GPIO16(D0) 短接到 RST;无跳线则按 RST 唤醒。 + // 单次深睡上限约 3.5 小时,间隔超过请拆成多段循环。 + Serial.printf("[sleep] 深度睡眠 %u 秒\n", SLEEP_SECONDS); + Serial.flush(); + ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT); +} + +void loop() { + // setup() 里已深睡,不会到这里;安全兜底再睡一次 + ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT); + delay(1000); +} diff --git a/firmware/esp8266/src/secrets.h.example b/firmware/esp8266/src/secrets.h.example new file mode 100644 index 0000000..c0c4cf8 --- /dev/null +++ b/firmware/esp8266/src/secrets.h.example @@ -0,0 +1,27 @@ +// 用户配置 —— 复制本文件为 secrets.h 并填入真实值。 +// 真正生效的是 secrets.h(已被 .gitignore 忽略),本文件只是提交的模板示例。 +// 本文件含敏感信息(令牌/密码),请勿在 secrets.h 中提交真实凭据。 + +#pragma once + +// ---- WiFi(ESP8266 连接的网络)---- +// 注意: ESP8266 只能连 2.4GHz 网络,5G 不支持。 +static const char *WIFI_SSID = "你的WiFi名称"; +static const char *WIFI_PASS = "你的WiFi密码"; + +// ---- 上报服务器(dhcp-mon server 模式)---- +// 指向跑 dhcp-mon -mode server 的机器,例: http://your-vps-ip:8080 +// 必须是 ESP8266 能访问到的地址(同网段或公网域名)。 +static const char *SERVER_URL = "http://your-vps-ip:8080/api/raw"; + +// ---- 认证与站点(需与 server 的 -stoken 一致)---- +static const char *X_TOKEN = "与server的-stoken一致"; +static const char *X_SITE = "home"; // 站点名,如 home/office/shop + +// ---- 路由器(Mercury 水星 MW305R)---- +static const char *ROUTER_HOST = "192.168.1.1"; +static const char *ROUTER_ADMIN = "admin"; +static const char *ROUTER_PASS = "123456"; + +// ---- 采集间隔(秒): 深度睡眠时长,默认 15 分钟 ---- +static const uint32_t SLEEP_SECONDS = 900; \ No newline at end of file diff --git a/go.mod b/go.mod new file mode 100644 index 0000000..224a87f --- /dev/null +++ b/go.mod @@ -0,0 +1,5 @@ +module dhcpclient + +go 1.27 + +require golang.org/x/text v0.21.0 diff --git a/go.sum b/go.sum new file mode 100644 index 0000000..0d8f5b2 --- /dev/null +++ b/go.sum @@ -0,0 +1,2 @@ +golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo= +golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= diff --git a/main.go b/main.go new file mode 100644 index 0000000..ee6905a --- /dev/null +++ b/main.go @@ -0,0 +1,770 @@ +// DHCP客户端监控守护进程 +// 适用于 Mercury 水星 MW305R 等路由器管理页面 +// +// 行为: +// - 常驻运行,每隔 interval(默认60s)抓取一次 DHCP 客户端列表 +// - 记录每个设备的 上线/下线 时间,追加写入 events.csv +// - 设备状态持久化到 devices.json(防重启丢失) +// - 内置 Web 展示页面(默认 :8080),自动刷新 +// - 事件数据滚动保留 retainDays 天(默认7天),超出自动清理 +// - 下线时间说明:DHCP 租约默认10分钟,设备断开后列表仍可能保留 +// 至租约到期,因此检测到的下线时间比真实时间晚 0~10 分钟。 +// +// 登录方式: 设置 Authorization cookie = "Basic " + base64("admin:"+密码), 需浏览器UA +// 数据来源: /userRpm/AssignedIpAddrListRpm.htm 页面中的 DHCPDynList JS 数组 +// 数组格式: 每4个元素一组: [客户端名, MAC地址, IP地址, 有效时间], 末尾以 0,0 结束 +package main + +import ( + "embed" + "encoding/base64" + "encoding/csv" + "encoding/json" + "flag" + "fmt" + "io" + "net/http" + "net/http/cookiejar" + "os" + "path/filepath" + "regexp" + "sort" + "strconv" + "strings" + "sync" + "text/tabwriter" + "time" + + "golang.org/x/text/encoding/simplifiedchinese" +) + +//go:embed web/index.html +var webFS embed.FS + +const defaultUA = "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36" + +const ( + evOnline = "online" + evOffline = "offline" +) + +// Client 表示抓取到的 DHCP 客户端 +type Client struct { + Name string + MAC string + IP string + LeaseDur string +} + +// Event 表示一条上下线事件 +type Event struct { + Timestamp time.Time `json:"timestamp"` + Event string `json:"event"` // online / offline + MAC string `json:"mac"` + IP string `json:"ip"` + Name string `json:"name"` + Detail string `json:"detail"` +} + +// Device 表示一个被监控的设备(MAC 为主键) +type Device struct { + MAC string `json:"mac"` + Name string `json:"name"` + LastIP string `json:"last_ip"` + FirstSeen time.Time `json:"first_seen"` + LastOnline *time.Time `json:"last_online,omitempty"` + LastOffline *time.Time `json:"last_offline,omitempty"` + Status string `json:"status"` // online / offline + OnlineCount int `json:"online_count"` + TotalOnline int64 `json:"total_online_seconds"` + // absent 是连续缺席的抓取次数(仅内存,不持久化) + absent int `json:"-"` +} + +var dhcpDynListRe = regexp.MustCompile(`(?s)var\s+DHCPDynList\s*=\s*new\s+Array\((.*?)\)\s*;`) +var stringElemRe = regexp.MustCompile(`"([^"]*)"`) + +// gbkToUTF8 将 GBK 编码的字节转为 UTF-8 字符串 +func gbkToUTF8(b []byte) string { + s, err := simplifiedchinese.GBK.NewDecoder().Bytes(b) + if err != nil { + return string(b) + } + return string(s) +} + +// Daemon 守护进程 +type Daemon struct { + dataDir string // 数据目录(events.csv / devices.json) + interval time.Duration + absentToOffline int // 连续缺席多少次判定下线(防抖) + retainDays int // 事件数据保留天数(滚动清理) + + baseURL string + auth string + client *http.Client + + mu sync.Mutex + devices map[string]*Device + evFile *os.File + evCSV *csv.Writer + events []Event // 内存事件(已含7天滚动清理) + evRotate time.Time + + // 上报(client 模式) + reportURL string + reportToken string + site string + lastReportedAt time.Time + + startTime time.Time + lastPollOk time.Time + verbose bool +} + +func (d *Daemon) logf(format string, args ...interface{}) { + t := time.Now().Format("2006-01-02 15:04:05") + fmt.Printf("[%s] %s\n", t, fmt.Sprintf(format, args...)) +} + +// fetch 抓取当前 DHCP 客户端列表 +func (d *Daemon) fetch() ([]Client, error) { + // 先访问根页面(与浏览器 reload 逻辑一致,建立会话) + if _, err := d.doGet(d.baseURL+"/", d.baseURL+"/"); err != nil { + return nil, fmt.Errorf("访问根页面: %w", err) + } + pageURL := d.baseURL + "/userRpm/AssignedIpAddrListRpm.htm" + body, err := d.doGet(pageURL, d.baseURL+"/userRpm/MenuRpm.htm") + if err != nil { + return nil, fmt.Errorf("抓取页面: %w", err) + } + text := string(body) + if strings.Contains(text, "403 Forbidden") || strings.Contains(text, "You have no authority") { + return nil, fmt.Errorf("认证被拒绝(403): 请检查密码,或路由器处于登录锁定") + } + if strings.Contains(text, "httpAutErrorArray") || strings.Contains(text, "pcPassword") { + return nil, fmt.Errorf("认证失败: 密码不正确,或路由器因密码错误多次被暂时锁定") + } + + return parseDHCPPage(body) +} + +// parseDHCPPage 从原始路由器页面 HTML 中解析 DHCP 客户端列表(采集端与服务器端复用)。 +// body 为 /userRpm/AssignedIpAddrListRpm.htm 的响应体。 +func parseDHCPPage(body []byte) ([]Client, error) { + m := dhcpDynListRe.FindSubmatch(body) + if m == nil { + return nil, fmt.Errorf("未找到 DHCPDynList 数据,页面结构可能不同") + } + raw := string(m[1]) + var elems []string + for _, sm := range stringElemRe.FindAllStringSubmatch(raw, -1) { + elems = append(elems, gbkToUTF8([]byte(sm[1]))) + } + clients := make([]Client, 0, len(elems)/4) + for i := 0; i+3 < len(elems); i += 4 { + clients = append(clients, Client{ + Name: elems[i], + MAC: strings.ToUpper(elems[i+1]), + IP: elems[i+2], + LeaseDur: elems[i+3], + }) + } + return clients, nil +} + +// doGet 发起带认证 cookie 的 GET 请求并返回响应体 +func (d *Daemon) doGet(url, referer string) ([]byte, error) { + req, err := http.NewRequest("GET", url, nil) + if err != nil { + return nil, err + } + req.Header.Set("User-Agent", defaultUA) + req.Header.Set("Referer", referer) + // 注意: 不能使用 req.AddCookie,Go 会对含空格的 cookie 值加引号, + // 路由器要求 Cookie 头为形如 Authorization=Basic xxx 的无引号形式 + req.Header.Set("Cookie", "Authorization="+d.auth) + resp, err := d.client.Do(req) + if err != nil { + return nil, err + } + defer resp.Body.Close() + var buf strings.Builder + if _, err := io.Copy(&buf, resp.Body); err != nil { + return nil, err + } + return []byte(buf.String()), nil +} + +// poll 单次轮询: 抓取 + 状态判定 + 落盘 +func (d *Daemon) poll() { + d.mu.Lock() + defer d.mu.Unlock() + + now := time.Now() + clients, err := d.fetch() + if err != nil { + d.logf("抓取失败: %v", err) + return + } + d.lastPollOk = now + + seen := make(map[string]bool, len(clients)) + for _, c := range clients { + mac := c.MAC + if mac == "" { + continue + } + dev := d.devices[mac] + if dev == nil { + dev = &Device{MAC: mac, Status: evOffline} + d.devices[mac] = dev + } + dev.Name = c.Name + dev.LastIP = c.IP + if dev.FirstSeen.IsZero() { + dev.FirstSeen = now + } + + if dev.Status == evOffline { + // 上线事件 + dev.Status = evOnline + dev.OnlineCount++ + t := now + dev.LastOnline = &t + dev.absent = 0 + d.recordEvent(now, evOnline, mac, c.IP, c.Name, c.LeaseDur) + d.logf("设备上线: %s (%s) %s", c.Name, mac, c.IP) + } + seen[mac] = true + } + + // 判定下线: 本次未出现的在线设备 + for mac, dev := range d.devices { + if dev.Status != evOnline || seen[mac] { + continue + } + dev.absent++ + if dev.absent >= d.absentToOffline { + dev.Status = evOffline + t := now + dev.LastOffline = &t + if dev.LastOnline != nil { + dur := now.Sub(*dev.LastOnline) + dev.TotalOnline += int64(dur.Seconds()) + h := int(dur.Hours()) + m := int(dur.Minutes()) % 60 + detail := fmt.Sprintf("在线时长 %02dh%02dm; 下线检测误差≤%s(DHCP租约)", h, m, "10m") + d.recordEvent(now, evOffline, mac, dev.LastIP, dev.Name, detail) + d.logf("设备下线: %s (%s) %s %s", dev.Name, mac, dev.LastIP, detail) + } else { + d.recordEvent(now, evOffline, mac, dev.LastIP, dev.Name, "") + } + } + } + d.save() +} + +// recordEvent 追加写一条事件到 events.csv 并加入内存 +func (d *Daemon) recordEvent(t time.Time, ev, mac, ip, name, detail string) { + // 内存事件(用于 web 展示) + d.events = append(d.events, Event{Timestamp: t, Event: ev, MAC: mac, IP: ip, Name: name, Detail: detail}) + if d.evCSV == nil { + return + } + row := []string{t.Format(time.RFC3339), ev, mac, ip, name, detail} + if err := d.evCSV.Write(row); err != nil { + fmt.Fprintf(os.Stderr, "写入事件失败: %v\n", err) + return + } + d.evCSV.Flush() + // 每次写入后顺势清理内存中的过期事件(保持内存有界) + cutoff := time.Now().Add(-time.Duration(d.retainDays) * 24 * time.Hour) + if i := firstEventAfter(d.events, cutoff); i > 0 { + d.events = append([]Event(nil), d.events[i:]...) + } +} + +// firstEventAfter 返回第一个 Timestamp >= cutoff 的下标 +func firstEventAfter(evs []Event, cutoff time.Time) int { + for i, e := range evs { + if !e.Timestamp.Before(cutoff) { + return i + } + } + return len(evs) +} + +// pruneEvents 滚动清理:去掉超过 retainDays 的旧事件(CSV重写) +func (d *Daemon) pruneEvents() { + cutoff := time.Now().Add(-time.Duration(d.retainDays) * 24 * time.Hour) + // 内存清理 + if i := firstEventAfter(d.events, cutoff); i > 0 { + d.events = append([]Event(nil), d.events[i:]...) + } + // CSV 文件清理:重写整个文件 + if d.evCSV == nil { + return + } + path := filepath.Join(d.dataDir, "events.csv") + rows, err := readCSV(path) + if err != nil { + return + } + keep := [][]string{rows[0]} // 表头 + pruned := 0 + for _, r := range rows[1:] { + if len(r) < 1 { + continue + } + t, err := time.Parse(time.RFC3339, r[0]) + if err != nil || !t.Before(cutoff) { + keep = append(keep, r) + } else { + pruned++ + } + } + if pruned == 0 { + return + } + // 关掉当前 writer,重写文件,再重新打开 + d.evCSV.Flush() + d.evFile.Close() + if err := writeCSV(path, keep); err != nil { + d.logf("清理旧事件失败: %v", err) + } + d.evFile, _ = os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644) + d.evCSV = csv.NewWriter(d.evFile) + d.logf("事件滚动清理: 移除 %d 条超过 %d 天的旧事件", pruned, d.retainDays) +} + +// readCSV 读取 CSV 全部行 +func readCSV(path string) ([][]string, error) { + f, err := os.Open(path) + if err != nil { + return nil, err + } + defer f.Close() + return csv.NewReader(f).ReadAll() +} + +// writeCSV 重写 CSV 文件 +func writeCSV(path string, rows [][]string) error { + tmp := path + ".tmp" + f, err := os.Create(tmp) + if err != nil { + return err + } + w := csv.NewWriter(f) + if err := w.WriteAll(rows); err != nil { + f.Close() + return err + } + w.Flush() + if err := f.Close(); err != nil { + return err + } + return os.Rename(tmp, path) +} + +// pruneDevices 清理离线超过 retainDays 的设备记录 +func (d *Daemon) pruneDevices() { + cutoff := time.Now().Add(-time.Duration(d.retainDays) * 24 * time.Hour) + removed := 0 + for mac, dev := range d.devices { + if dev.Status == evOnline { + continue + } + last := dev.LastOffline + if last == nil { + last = &dev.FirstSeen + } + if last.Before(cutoff) { + delete(d.devices, mac) + removed++ + } + } + if removed > 0 { + d.logf("设备记录清理: 移除 %d 台离线超过 %d 天的设备", removed, d.retainDays) + d.save() + } +} + +// save 持久化设备状态到 devices.json +func (d *Daemon) save() { + if d.devices == nil { + return + } + path := filepath.Join(d.dataDir, "devices.json") + data, err := json.MarshalIndent(d.devices, "", " ") + if err != nil { + fmt.Fprintf(os.Stderr, "序列化设备状态失败: %v\n", err) + return + } + tmp := path + ".tmp" + if err := os.WriteFile(tmp, data, 0644); err != nil { + fmt.Fprintf(os.Stderr, "写设备状态失败: %v\n", err) + return + } + os.Rename(tmp, path) +} + +// load 从 devices.json 加载设备状态 +func (d *Daemon) load() { + path := filepath.Join(d.dataDir, "devices.json") + data, err := os.ReadFile(path) + if err != nil { + return // 首次运行,无历史 + } + if err := json.Unmarshal(data, &d.devices); err != nil { + fmt.Fprintf(os.Stderr, "解析 devices.json 失败(忽略): %v\n", err) + } +} + +// printReport 打印设备汇总表 +func (d *Daemon) printReport(w io.Writer) { + devs := make([]*Device, 0, len(d.devices)) + for _, dev := range d.devices { + devs = append(devs, dev) + } + sort.Slice(devs, func(i, j int) bool { + di, dj := devs[i], devs[j] + if di.Status != dj.Status { + return di.Status == evOnline + } + if di.LastOnline != nil && dj.LastOnline != nil { + return di.LastOnline.After(*dj.LastOnline) + } + return di.MAC < dj.MAC + }) + + tw := tabwriter.NewWriter(w, 0, 4, 2, ' ', 0) + fmt.Fprintln(tw, "状态\t设备名\tMAC\tIP\t首次发现\t最近上线\t最近下线\t在线次数\t累计在线") + for _, dev := range devs { + st := "在线" + if dev.Status == evOffline { + st = "离线" + } + lo := "-" + if dev.LastOnline != nil { + lo = dev.LastOnline.Format("01-02 15:04:05") + } + lf := "-" + if dev.LastOffline != nil { + lf = dev.LastOffline.Format("01-02 15:04:05") + } + fs := "-" + if !dev.FirstSeen.IsZero() { + fs = dev.FirstSeen.Format("01-02 15:04:05") + } + name := dev.Name + if name == "" { + name = "-" + } + dur := time.Duration(dev.TotalOnline) * time.Second + onStr := fmt.Sprintf("%dh%02dm", int(dur.Hours()), int(dur.Minutes())%60) + fmt.Fprintf(tw, "%s\t%s\t%s\t%s\t%s\t%s\t%s\t%d\t%s\n", + st, name, dev.MAC, dev.LastIP, fs, lo, lf, dev.OnlineCount, onStr) + } + tw.Flush() +} + +// ---------- Web 服务 ---------- + +// startWeb 启动内嵌的展示页面和 JSON API +func (d *Daemon) startWeb(addr string) { + mux := http.NewServeMux() + mux.HandleFunc("/", d.handleIndex) + mux.HandleFunc("/api/devices", d.handleDevices) + mux.HandleFunc("/api/events", d.handleEvents) + srv := &http.Server{Addr: addr, Handler: mux} + go func() { + d.logf("Web 展示页启动: http://%s (数据保留 %d 天)", addr, d.retainDays) + if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed { + d.logf("Web 服务错误: %v", err) + } + }() +} + +func (d *Daemon) handleIndex(w http.ResponseWriter, r *http.Request) { + if r.URL.Path != "/" { + http.NotFound(w, r) + return + } + data, err := webFS.ReadFile("web/index.html") + if err != nil { + http.Error(w, "页面加载失败", http.StatusInternalServerError) + return + } + w.Header().Set("Content-Type", "text/html; charset=utf-8") + w.Write(data) +} + +func (d *Daemon) handleDevices(w http.ResponseWriter, r *http.Request) { + d.mu.Lock() + devs := make([]*Device, 0, len(d.devices)) + for _, dev := range d.devices { + devs = append(devs, dev) + } + d.mu.Unlock() + sort.Slice(devs, func(a, b int) bool { + if devs[a].Status != devs[b].Status { + return devs[a].Status == evOnline + } + return devs[a].MAC < devs[b].MAC + }) + w.Header().Set("Content-Type", "application/json; charset=utf-8") + json.NewEncoder(w).Encode(map[string]interface{}{ + "devices": devs, + "interval": d.interval.String(), + "retain_days": d.retainDays, + "last_poll_ok": d.lastPollOk.Format(time.RFC3339), + "device_count": len(devs), + }) +} + +func (d *Daemon) handleEvents(w http.ResponseWriter, r *http.Request) { + limit := 100 + if v := r.URL.Query().Get("limit"); v != "" { + if n, err := strconv.Atoi(v); err == nil && n > 0 { + limit = n + } + } + cutoff := time.Now().Add(-time.Duration(d.retainDays) * 24 * time.Hour) + d.mu.Lock() + // 从后往前取最近的 limit 条 + evs := d.events + start := 0 + if len(evs) > limit { + start = len(evs) - limit + } + out := make([]Event, 0, limit) + for _, e := range evs[start:] { + if e.Timestamp.Before(cutoff) { + continue + } + out = append(out, e) + } + d.mu.Unlock() + // 最新在前 + for i, j := 0, len(out)-1; i < j; i, j = i+1, j-1 { + out[i], out[j] = out[j], out[i] + } + w.Header().Set("Content-Type", "application/json; charset=utf-8") + json.NewEncoder(w).Encode(map[string]interface{}{ + "events": out, + "total": len(out), + }) +} + +func main() { + mode := flag.String("mode", "client", "运行模式: client(采集上报) / server(接收+看板)") + host := flag.String("host", "192.168.1.1", "路由器管理地址(client模式)") + password := flag.String("password", "123456", "管理员密码(client模式)") + useHTTPS := flag.Bool("https", false, "使用 https 协议") + timeout := flag.Int("timeout", 10, "HTTP 超时秒数") + interval := flag.Duration("interval", 60*time.Second, "抓取间隔") + dataDir := flag.String("data", "./data", "数据目录(events.csv / devices.json)") + once := flag.Bool("once", false, "仅抓取一次并打印当前客户端列表(不常驻)") + quiet := flag.Bool("quiet", false, "安静模式:不打印每次轮询的设备变动/错误") + webAddr := flag.String("web", ":8080", "Web 展示页面监听地址(空=不启用)") + retainDays := flag.Int("retain", 7, "事件/设备数据保留天数(滚动清理)") + + // 上报参数(client 模式) + reportURL := flag.String("report", "", "上报服务器地址,如 http://server:8080/api/report(空=不上报)") + reportToken := flag.String("token", "", "上报/访问令牌,与服务器一致") + site := flag.String("site", "", "站点标识(站点名,如 home/office)") + + // 服务器参数(server 模式) + serverToken := flag.String("stoken", "", "服务器令牌:上报需带此令牌才接收(server模式)") + // 下线判定防抖: 连续 N 次缺席(默认2次=2分钟) + // DHCP 租约10分钟,设备断线后列表仍保留→下线检测误差≤10分钟 + absentN := flag.Int("absent", 2, "连续缺席多少次(次)判定下线,防抖用") + flag.Parse() + + // ---- server 模式: 接收上报 + 看板 ---- + if *mode == "server" { + runServer(ServerConfig{ + Addr: *webAddr, + DataDir: *dataDir, + Token: *serverToken, + RetainDays: *retainDays, + }) + return + } + + scheme := "http" + if *useHTTPS { + scheme = "https" + } + baseURL := fmt.Sprintf("%s://%s", scheme, *host) + auth := "Basic " + base64.StdEncoding.EncodeToString([]byte("admin:"+*password)) + + jar, err := newJar() + if err != nil { + fmt.Fprintln(os.Stderr, "创建 cookie jar 失败:", err) + os.Exit(1) + } + + d := &Daemon{ + dataDir: *dataDir, + interval: *interval, + absentToOffline: *absentN, + retainDays: *retainDays, + baseURL: baseURL, + auth: auth, + client: &http.Client{ + Jar: jar, + Timeout: time.Duration(*timeout) * time.Second, + }, + devices: map[string]*Device{}, + startTime: time.Now(), + verbose: !*quiet, + reportURL: *reportURL, + reportToken: *reportToken, + site: *site, + } + if d.retainDays < 1 { + d.retainDays = 1 + } + if d.absentToOffline < 1 { + d.absentToOffline = 1 + } + + // ---- 一次性模式 ---- + if *once { + clients, err := d.fetch() + if err != nil { + fmt.Fprintln(os.Stderr, "抓取失败:", err) + os.Exit(1) + } + sort.Slice(clients, func(i, j int) bool { return ipLess(clients[i].IP, clients[j].IP) }) + tw := tabwriter.NewWriter(os.Stdout, 0, 4, 2, ' ', 0) + fmt.Fprintln(tw, "客户端名\tMAC地址\tIP地址\t有效时间") + for _, c := range clients { + fmt.Fprintf(tw, "%s\t%s\t%s\t%s\n", c.Name, c.MAC, c.IP, c.LeaseDur) + } + tw.Flush() + return + } + + // ---- 常驻模式 ---- + defer d.save() + + // 目录与事件文件 + if err := os.MkdirAll(*dataDir, 0755); err != nil { + fmt.Fprintln(os.Stderr, "创建数据目录失败:", err) + os.Exit(1) + } + d.load() + + evPath := filepath.Join(*dataDir, "events.csv") + evFile, err := os.OpenFile(evPath, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644) + if err != nil { + fmt.Fprintln(os.Stderr, "打开事件日志失败:", err) + os.Exit(1) + } + defer evFile.Close() + d.evFile = evFile + d.evCSV = csv.NewWriter(evFile) + if fi, _ := evFile.Stat(); fi != nil && fi.Size() == 0 { + d.evCSV.Write([]string{"timestamp", "event", "mac", "ip", "name", "detail"}) + d.evCSV.Flush() + } + + // 加载历史事件到内存(供 web 展示) + if rows, err := readCSV(evPath); err == nil && len(rows) > 1 { + cutoff := time.Now().Add(-time.Duration(d.retainDays) * 24 * time.Hour) + for _, r := range rows[1:] { + if len(r) < 6 { + continue + } + t, err := time.Parse(time.RFC3339, r[0]) + if err != nil || t.Before(cutoff) { + continue + } + d.events = append(d.events, Event{ + Timestamp: t, Event: r[1], MAC: r[2], IP: r[3], Name: r[4], Detail: r[5], + }) + } + d.logf("已加载 %d 条历史事件(保留 %d 天)", len(d.events), d.retainDays) + } + + d.logf("DHCP 监控启动: %s | 间隔 %s | 数据目录 %s | 历史设备 %d | 数据保留 %d 天", + baseURL, *interval, *dataDir, len(d.devices), d.retainDays) + d.logf("下线时间说明: DHCP租约约10分钟,设备断开后列表仍保留至租约到期,下线检测误差≤10分钟;另含%d次缺席防抖", *absentN) + + // 启动 Web 展示服务(本地页面,可选) + if *webAddr != "" { + d.startWeb(*webAddr) + } + + // 立即执行一次,再定时 + d.poll() + // 首次上报(如果配置了) + d.sendReport() + if len(d.devices) > 0 { + d.logf("当前设备:") + d.printReport(os.Stdout) + } + ticker := time.NewTicker(*interval) + defer ticker.Stop() + nextReport := time.Now().Add(10 * time.Minute) + lastPrune := time.Now() + for range ticker.C { + d.poll() + // 上报增量事件 + 快照(只有新事件或周期上报) + d.sendReport() + // 每10分钟打印一次设备汇总 + if !*quiet && time.Now().After(nextReport) { + d.printReport(os.Stdout) + nextReport = time.Now().Add(10 * time.Minute) + } + // 每天一次滚动清理旧数据 + if time.Since(lastPrune) >= 24*time.Hour { + d.mu.Lock() + d.pruneEvents() + d.pruneDevices() + d.mu.Unlock() + lastPrune = time.Now() + } + } +} + +func newJar() (http.CookieJar, error) { + return cookiejar.New(nil) +} + +// ipLess 按 IPv4 数字顺序比较,无法解析的排后 +func ipLess(a, b string) bool { + av, aok := parseIP(a) + bv, bok := parseIP(b) + if !aok { + return false + } + if !bok { + return true + } + for i := 0; i < 4; i++ { + if av[i] != bv[i] { + return av[i] < bv[i] + } + } + return false +} + +func parseIP(s string) ([4]byte, bool) { + var r [4]byte + parts := strings.Split(s, ".") + if len(parts) != 4 { + return r, false + } + for i, p := range parts { + n, err := strconv.Atoi(p) + if err != nil || n < 0 || n > 255 { + return r, false + } + r[i] = byte(n) + } + return r, true +} diff --git a/main_test.go b/main_test.go new file mode 100644 index 0000000..fc65db0 --- /dev/null +++ b/main_test.go @@ -0,0 +1,111 @@ +package main + +import ( + "encoding/csv" + "os" + "path/filepath" + "testing" + "time" +) + +// 测试 firstEventAfter 边界 +func TestFirstEventAfter(t *testing.T) { + base := time.Now().Add(-48 * time.Hour) + evs := []Event{ + {Timestamp: base}, // 0: 旧 + {Timestamp: base.Add(24 * time.Hour)}, // 1 + {Timestamp: base.Add(48 * time.Hour)}, // 2 + } + cut := time.Now().Add(-7 * 24 * time.Hour) // 7天前 + got := firstEventAfter(evs, cut) + if got != 0 { + t.Fatalf("全部应保留, got=%d", got) + } + + // cutoff 在 base 和 base+24h 之间 + cut2 := base.Add(12 * time.Hour) + got2 := firstEventAfter(evs, cut2) + if got2 != 1 { + t.Fatalf("应跳过0保留1, got=%d", got2) + } +} + +// 测试 pruneEvents: 超期事件从 CSV 移除 +func TestPruneEvents(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "events.csv") + + old := time.Now().Add(-8 * 24 * time.Hour).Format(time.RFC3339) // 8天前,应删 + recent := time.Now().Add(-1 * time.Hour).Format(time.RFC3339) // 1小时前,保留 + rows := [][]string{ + {"timestamp", "event", "mac", "ip", "name", "detail"}, + {old, "online", "AA-BB", "1.1.1.1", "Old", "x"}, + {recent, "offline", "CC-DD", "1.1.1.2", "New", "y"}, + } + writeCSV(path, rows) + + d := &Daemon{ + dataDir: dir, + retainDays: 7, + } + // 打开文件模拟运行状态 + f, err := os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644) + if err != nil { + t.Fatal(err) + } + defer f.Close() + d.evFile = f + d.evCSV = csv.NewWriter(f) + + d.pruneEvents() + + got, err := readCSV(path) + if err != nil { + t.Fatal(err) + } + if len(got) != 2 { // 表头 + 1条保留 + t.Fatalf("清理后应剩2行, got %d 行: %v", len(got), got) + } + if got[1][4] != "New" { + t.Fatalf("应保留新事件, got %v", got[1]) + } + + // 内存事件也应清理 + d.events = []Event{ + {Timestamp: time.Now().Add(-8 * 24 * time.Hour)}, + {Timestamp: time.Now()}, + } + d.pruneEvents() + if len(d.events) != 1 { + t.Fatalf("内存事件应剩1条, got %d", len(d.events)) + } +} + +// 测试 pruneDevices: 离线超过7天的设备被移除,在线保留 +func TestPruneDevices(t *testing.T) { + dir := t.TempDir() + oldOff := time.Now().Add(-8 * 24 * time.Hour) + recentOff := time.Now().Add(-2 * time.Hour) + d := &Daemon{ + dataDir: dir, + retainDays: 7, + devices: map[string]*Device{ + "OLD-MAC": {MAC: "OLD-MAC", Status: evOffline, LastOffline: &oldOff}, + "RECENT": {MAC: "RECENT", Status: evOffline, LastOffline: &recentOff}, + "ONLINE-1": {MAC: "ONLINE-1", Status: evOnline, LastOffline: &oldOff}, // 在线不删 + "NO-OFF": {MAC: "NO-OFF", Status: evOffline, FirstSeen: oldOff}, // 无下线时间用首次 + }, + } + d.pruneDevices() + if _, ok := d.devices["OLD-MAC"]; ok { + t.Fatal("OLD-MAC 应被删除") + } + if _, ok := d.devices["NO-OFF"]; ok { + t.Fatal("NO-OFF 应被删除(首次发现超7天)") + } + for _, keep := range []string{"RECENT", "ONLINE-1"} { + if _, ok := d.devices[keep]; !ok { + t.Fatalf("%s 应保留", keep) + } + } +} diff --git a/raw_test.go b/raw_test.go new file mode 100644 index 0000000..82998b4 --- /dev/null +++ b/raw_test.go @@ -0,0 +1,238 @@ +package main + +import ( + "bytes" + "encoding/json" + "net/http" + "net/http/httptest" + "strings" + "testing" +) + +// 模拟水星 MW305R 的 /userRpm/AssignedIpAddrListRpm.htm 页面 +// DHCPDynList 是跨行的 JS 数组,每4个元素一组: [名字, MAC, IP, 租约] +func sampleRouterPage(devices [][4]string) []byte { + var b strings.Builder + b.WriteString("water\n") + b.WriteString("var DHCPDynList = new Array(\n") + for i, d := range devices { + if i > 0 { + b.WriteString(",\n") + } + b.WriteString("\t\"") + b.WriteString(d[0]) + b.WriteString("\", \"") + b.WriteString(d[1]) + b.WriteString("\", \"") + b.WriteString(d[2]) + b.WriteString("\", \"") + b.WriteString(d[3]) + b.WriteString("\"") + } + b.WriteString("\n,0,0);\n") + b.WriteString("\n") + return []byte(b.String()) +} + +// 测试 parseDHCPPage: 正常解析 +func TestParseDHCPPage(t *testing.T) { + page := sampleRouterPage([][4]string{ + {"K23879676", "A4:56:02:31:85:01", "192.168.1.100", "0 02:12:33"}, + {"PgyBox_X1-2111", "4C:77:66:11:22:33", "192.168.1.101", "0 01:55:00"}, + }) + clients, err := parseDHCPPage(page) + if err != nil { + t.Fatalf("解析失败: %v", err) + } + if len(clients) != 2 { + t.Fatalf("应解析出2台, got %d", len(clients)) + } + if clients[0].MAC != "A4:56:02:31:85:01" || clients[0].IP != "192.168.1.100" { + t.Fatalf("第一台解析错误: %+v", clients[0]) + } + if clients[1].Name != "PgyBox_X1-2111" { + t.Fatalf("第二台名字错误: %+v", clients[1]) + } +} + +// 测试 parseDHCPPage: GBK 中文名转码 +func TestParseDHCPPageGBK(t *testing.T) { + // "小米手机" 的 GBK 编码 + gbkName := "\xD0\xA1\xC3\xD7\xCA\xD6\xBB\xFA" // 小米手机 + page := sampleRouterPage([][4]string{ + {gbkName, "AA:BB:CC:DD:EE:FF", "192.168.1.88", "0 00:10:00"}, + }) + clients, err := parseDHCPPage(page) + if err != nil { + t.Fatalf("解析失败: %v", err) + } + if len(clients) != 1 { + t.Fatalf("应1台, got %d", len(clients)) + } + if clients[0].Name != "小米手机" { + t.Fatalf("GBK 转码失败: %q", clients[0].Name) + } +} + +// 测试 parseDHCPPage: 无 DHCPDynList 时报错 +func TestParseDHCPPageInvalid(t *testing.T) { + if _, err := parseDHCPPage([]byte("no data here")); err == nil { + t.Fatal("应报错, got nil") + } +} + +// 测试 /api/raw: 认证失败拒绝 +func TestRawAuth(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + token: "secret", + sites: make(map[string]*SiteData), + } + body := sampleRouterPage([][4]string{{"dev", "AA:01", "1.1.1.1", "0 00:10:00"}}) + r := httptest.NewRequest(http.MethodPost, "/api/raw?token=bad&site=s1", bytes.NewReader(body)) + w := httptest.NewRecorder() + s.handleRaw(w, r) + if w.Code != http.StatusUnauthorized { + t.Fatalf("错误token应401, got %d", w.Code) + } +} + +// 测试 /api/raw: 完整流程——两次上报产生上下线事件 +func TestRawFlow(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + token: "secret", + retainDays: 7, + sites: make(map[string]*SiteData), + } + post := func(devices [][4]string) *httptest.ResponseRecorder { + body := sampleRouterPage(devices) + r := httptest.NewRequest(http.MethodPost, "/api/raw", bytes.NewReader(body)) + r.Header.Set("X-Token", "secret") + r.Header.Set("X-Site", "home") + w := httptest.NewRecorder() + s.handleRaw(w, r) + return w + } + + // 第一次: 设备A在线 + w := post([][4]string{{"Phone", "AA:01", "192.168.1.10", "0 00:10:00"}}) + if w.Code != http.StatusOK { + t.Fatalf("第一次上报应200, got %d: %s", w.Code, w.Body.String()) + } + // 第二次: 设备A仍在线 + w = post([][4]string{{"Phone", "AA:01", "192.168.1.10", "0 00:10:00"}}) + if w.Code != http.StatusOK { + t.Fatalf("第二次上报应200, got %d", w.Code) + } + // 第三、四次: 设备A消失(缺席2次 → 判定下线) + w = post([][4]string{}) + if w.Code != http.StatusOK { + t.Fatalf("第三次上报应200, got %d", w.Code) + } + w = post([][4]string{}) + if w.Code != http.StatusOK { + t.Fatalf("第四次上报应200, got %d", w.Code) + } + + s.mu.RLock() + sd := s.sites["home"] + s.mu.RUnlock() + if sd == nil { + t.Fatal("站点应存在") + } + sd.mu.RLock() + defer sd.mu.RUnlock() + if len(sd.devices) != 1 { + t.Fatalf("设备应1台, got %d", len(sd.devices)) + } + dev := sd.devices["AA:01"] + if dev.Status != evOffline { + t.Fatalf("设备应判定离线, got %q", dev.Status) + } + if dev.OnlineCount != 1 { + t.Fatalf("上线次数应1, got %d", dev.OnlineCount) + } + // 事件: 1条上线 + 1条下线 + if len(sd.events) != 2 { + t.Fatalf("应有2条事件, got %d: %+v", len(sd.events), sd.events) + } + if sd.events[0].Event != evOnline || sd.events[1].Event != evOffline { + t.Fatalf("事件序列应为[online, offline], got %+v", sd.events) + } +} + +// 测试 /api/raw: 路由器认证失败页面 → 502 +func TestRawAuthFailPage(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + sites: make(map[string]*SiteData), + } + // 模拟路由器返回 403 页面 + r := httptest.NewRequest(http.MethodPost, "/api/raw", strings.NewReader("403 Forbidden")) + r.Header.Set("X-Site", "home") + w := httptest.NewRecorder() + s.handleRaw(w, r) + if w.Code != http.StatusBadGateway { + t.Fatalf("认证失败页应502, got %d: %s", w.Code, w.Body.String()) + } +} + +// 测试 /api/raw: 持久化后设备/事件加载正常 +func TestRawPersistence(t *testing.T) { + dir := t.TempDir() + s := &Server{ + dataDir: dir, + retainDays: 7, + sites: make(map[string]*SiteData), + } + body := sampleRouterPage([][4]string{{"dev", "AA:01", "1.1.1.1", "0 00:10:00"}}) + r := httptest.NewRequest(http.MethodPost, "/api/raw", bytes.NewReader(body)) + r.Header.Set("X-Site", "s1") + w := httptest.NewRecorder() + s.handleRaw(w, r) + if w.Code != http.StatusOK { + t.Fatalf("应200, got %d: %s", w.Code, w.Body.String()) + } + + // 重启: 加载 + s2 := &Server{dataDir: dir, retainDays: 7, sites: make(map[string]*SiteData), siteNames: make(map[string]string)} + s2.loadAll() + s2.mu.RLock() + sd := s2.sites["s1"] + s2.mu.RUnlock() + if sd == nil { + t.Fatal("重载后站点应存在") + } + sd.mu.RLock() + if len(sd.devices) != 1 { + t.Fatalf("重载后应1台设备, got %d", len(sd.devices)) + } + if len(sd.events) != 1 { + t.Fatalf("重载后应1条事件, got %d", len(sd.events)) + } + sd.mu.RUnlock() +} + +// TestRawVendors: raw 上报的 JSON 响应 +func TestRawJSONResponse(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + sites: make(map[string]*SiteData), + } + body := sampleRouterPage([][4]string{{"dev", "AA:01", "1.1.1.1", "0 00:10:00"}}) + r := httptest.NewRequest(http.MethodPost, "/api/raw", bytes.NewReader(body)) + r.Header.Set("X-Site", "s1") + w := httptest.NewRecorder() + s.handleRaw(w, r) + var resp map[string]interface{} + if err := json.NewDecoder(w.Body).Decode(&resp); err != nil { + t.Fatalf("响应非JSON: %v", err) + } + if resp["ok"] != true { + t.Fatalf("resp.ok 应为true, got %v", resp["ok"]) + } + if resp["clients"].(float64) != 1 { + t.Fatalf("clients 应1, got %v", resp["clients"]) + } +} diff --git a/report.go b/report.go new file mode 100644 index 0000000..a6c1fbb --- /dev/null +++ b/report.go @@ -0,0 +1,109 @@ +package main + +import ( + "bytes" + "encoding/json" + "net/http" + "time" +) + +// ReportSnapshot 上报的设备快照(全量,服务器以此为准覆盖在线状态) +type ReportSnapshot struct { + Devices []*Device `json:"devices"` + DeviceCount int `json:"device_count"` + OnlineCount int `json:"online_count"` + ReportedAt time.Time `json:"reported_at"` +} + +// ReportPayload 上报请求体 +type ReportPayload struct { + Site string `json:"site"` + Token string `json:"token"` + Events []Event `json:"events"` + Snapshot *ReportSnapshot `json:"snapshot"` + Client map[string]string `json:"client,omitempty"` // 客户端信息(版本等) +} + +// sendReport 上报增量事件 + 全量快照到服务器。 +// 成功后返回 true;失败返回 false,调用方不推进增量游标,下轮自动重发。 +func (d *Daemon) sendReport() bool { + d.mu.Lock() + if d.reportURL == "" || d.site == "" { + d.mu.Unlock() + return false + } + reportURL := d.reportURL + site := d.site + token := d.reportToken + + // 收集上次上报后新增的事件 + events := make([]Event, 0) + for _, e := range d.events { + if e.Timestamp.After(d.lastReportedAt) { + events = append(events, e) + } + } + + // 全量快照(当前所有设备状态) + devs := make([]*Device, 0, len(d.devices)) + online := 0 + for _, dev := range d.devices { + c := *dev // 拷贝,避免 data race + c.absent = 0 + devs = append(devs, &c) + if dev.Status == evOnline { + online++ + } + } + d.mu.Unlock() + + payload := ReportPayload{ + Site: site, + Token: token, + Events: events, + Snapshot: &ReportSnapshot{ + Devices: devs, + DeviceCount: len(devs), + OnlineCount: online, + ReportedAt: time.Now(), + }, + Client: map[string]string{"version": "1.0"}, + } + + body, err := json.Marshal(payload) + if err != nil { + d.logf("上报序列化失败: %v", err) + return false + } + req, err := http.NewRequest("POST", reportURL, bytes.NewReader(body)) + if err != nil { + d.logf("上报请求构造失败: %v", err) + return false + } + req.Header.Set("Content-Type", "application/json") + req.Header.Set("User-Agent", defaultUA) + + resp, err := d.client.Do(req) + if err != nil { + d.logf("上报失败(将重试): %v", err) + return false + } + defer resp.Body.Close() + if resp.StatusCode != http.StatusOK { + d.logf("上报被拒绝: HTTP %d", resp.StatusCode) + return false + } + + // 成功,推进游标 + d.mu.Lock() + // 重发保护:即使游标被提前推进,也已收到成功响应 + for _, e := range d.events { + if e.Timestamp.After(d.lastReportedAt) { + d.lastReportedAt = e.Timestamp + } + } + d.mu.Unlock() + d.logf("上报成功: site=%s 事件%d条 设备%d台(在线%d)", + site, len(events), len(devs), online) + return true +} diff --git a/server.go b/server.go new file mode 100644 index 0000000..9c6fa7c --- /dev/null +++ b/server.go @@ -0,0 +1,531 @@ +package main + +import ( + "embed" + "encoding/csv" + "encoding/json" + "fmt" + "io" + "net/http" + "os" + "path/filepath" + "sort" + "strings" + "sync" + "time" +) + +// SiteData 单个站点的数据(内存态) +type SiteData struct { + mu sync.RWMutex + name string + devices map[string]*Device + events []Event + lastSeen time.Time // 最近一次上报时间(在线判断) + // raw 模式(ESP8266 原始页面上报)的状态机字段 + rawAbsentToOffline int // 连续缺席多少次判定下线(防抖) + rawAbsent map[string]int // mac -> 连续缺席次数 +} + +// Server 服务器(server 模式) +type Server struct { + dataDir string + token string // 访问令牌,空则不校验 + retainDays int + + mu sync.RWMutex + sites map[string]*SiteData + // 站点名字→sig 用于展示 + siteNames map[string]string +} + +// ServerConfig server 模式配置 +type ServerConfig struct { + Addr string + DataDir string + Token string + RetainDays int +} + +func runServer(cfg ServerConfig) { + if cfg.RetainDays <= 0 { + cfg.RetainDays = 7 + } + if err := os.MkdirAll(cfg.DataDir, 0755); err != nil { + fmt.Fprintf(os.Stderr, "创建数据目录失败: %v\n", err) + os.Exit(1) + } + s := &Server{ + dataDir: cfg.DataDir, + token: cfg.Token, + retainDays: cfg.RetainDays, + sites: make(map[string]*SiteData), + siteNames: make(map[string]string), + } + s.loadAll() + + mux := http.NewServeMux() + mux.HandleFunc("/", s.handleIndex) + mux.HandleFunc("/api/report", s.handleReport) + mux.HandleFunc("/api/raw", s.handleRaw) + mux.HandleFunc("/api/sites", s.handleSites) + mux.HandleFunc("/api/site", s.handleSite) + srv := &http.Server{Addr: cfg.Addr, Handler: mux} + fmt.Printf("[%s] 看板服务器启动: http://%s | 数据目录 %s | 保留 %d 天\n", + time.Now().Format("2006-01-02 15:04:05"), cfg.Addr, cfg.DataDir, cfg.RetainDays) + if cfg.Token != "" { + fmt.Printf("[%s] 令牌认证: 启用\n", time.Now().Format("2006-01-02 15:04:05")) + } else { + fmt.Printf("[%s] 警告: 未设置令牌,任何人可上报/查看数据\n", time.Now().Format("2006-01-02 15:04:05")) + } + if err := srv.ListenAndServe(); err != nil { + fmt.Fprintf(os.Stderr, "服务器错误: %v\n", err) + os.Exit(1) + } +} + +// authOK 校验请求令牌 +func (s *Server) authOK(r *http.Request) bool { + if s.token == "" { + return true + } + return r.Header.Get("X-Token") == s.token || + r.URL.Query().Get("token") == s.token +} + +func (s *Server) handleIndex(w http.ResponseWriter, r *http.Request) { + if r.URL.Path != "/" { + http.NotFound(w, r) + return + } + data, err := dashboardFS.ReadFile("web/dashboard.html") + if err != nil { + http.Error(w, "页面加载失败", http.StatusInternalServerError) + return + } + if !s.authOK(r) { + http.Error(w, "403: 需要令牌(URL加 ?token=xxx 或 Header X-Token)", http.StatusForbidden) + return + } + w.Header().Set("Content-Type", "text/html; charset=utf-8") + w.Write(data) +} + +// applyClients 将一次采集到的客户端列表应用到站点状态机: +// 产生 上线/下线 事件并追加到 sd.events。 +// 调用方必须持有 sd.mu 写锁。 +func (sd *SiteData) applyClients(now time.Time, clients []Client, absentToOffline int) error { + if sd.rawAbsent == nil { + sd.rawAbsent = make(map[string]int) + } + seen := make(map[string]bool, len(clients)) + for _, c := range clients { + mac := c.MAC + if mac == "" { + continue + } + dev := sd.devices[mac] + if dev == nil { + dev = &Device{MAC: mac, Status: evOffline} + sd.devices[mac] = dev + } + dev.Name = c.Name + dev.LastIP = c.IP + if dev.FirstSeen.IsZero() { + dev.FirstSeen = now + } + if dev.Status == evOffline { + // 上线事件 + dev.Status = evOnline + dev.OnlineCount++ + t := now + dev.LastOnline = &t + sd.rawAbsent[mac] = 0 + sd.recordRawEvent(now, evOnline, mac, c.IP, c.Name, c.LeaseDur) + } + seen[mac] = true + } + + // 判定下线: 本次未出现的在线设备 + for mac, dev := range sd.devices { + if dev.Status != evOnline || seen[mac] { + continue + } + sd.rawAbsent[mac]++ + if sd.rawAbsent[mac] >= absentToOffline { + dev.Status = evOffline + t := now + dev.LastOffline = &t + if dev.LastOnline != nil { + dur := now.Sub(*dev.LastOnline) + dev.TotalOnline += int64(dur.Seconds()) + h := int(dur.Hours()) + m := int(dur.Minutes()) % 60 + detail := fmt.Sprintf("在线时长 %02dh%02dm; 下线检测误差≤%s(DHCP租约)", h, m, "10m") + sd.recordRawEvent(now, evOffline, mac, dev.LastIP, dev.Name, detail) + } else { + sd.recordRawEvent(now, evOffline, mac, dev.LastIP, dev.Name, "") + } + } + } + return nil +} + +// recordRawEvent 追加一条事件到站点内存事件列表(raw 模式) +func (sd *SiteData) recordRawEvent(t time.Time, ev, mac, ip, name, detail string) { + sd.events = append(sd.events, Event{Timestamp: t, Event: ev, MAC: mac, IP: ip, Name: name, Detail: detail}) +} + +// handleReport 接收卷端上报 +func (s *Server) handleReport(w http.ResponseWriter, r *http.Request) { + if r.Method != http.MethodPost { + http.Error(w, "method not allowed", http.StatusMethodNotAllowed) + return + } + var p ReportPayload + if err := json.NewDecoder(r.Body).Decode(&p); err != nil { + http.Error(w, "bad json: "+err.Error(), http.StatusBadRequest) + return + } + if s.token != "" && p.Token != s.token { + http.Error(w, "401: token 错误", http.StatusUnauthorized) + return + } + if p.Site == "" { + http.Error(w, "site 不能为空", http.StatusBadRequest) + return + } + + now := time.Now() + // lookup or 创建站点 + s.mu.RLock() + sd, ok := s.sites[p.Site] + s.mu.RUnlock() + if !ok { + s.mu.Lock() + if sd, ok = s.sites[p.Site]; !ok { + sd = &SiteData{name: p.Site, devices: make(map[string]*Device)} + s.sites[p.Site] = sd + } + s.mu.Unlock() + } + + sd.mu.Lock() + sd.lastSeen = now + + // 合并事件(全量追加) + recev := 0 + for _, e := range p.Events { + if e.Timestamp.IsZero() { + continue + } + sd.events = append(sd.events, e) + recev++ + } + + // 快照: 以服务器为准覆盖设备状态 + if p.Snapshot != nil && p.Snapshot.Devices != nil { + for _, d := range p.Snapshot.Devices { + if d.MAC == "" { + continue + } + prev, existed := sd.devices[d.MAC] + if existed { + // 保留服务器已有累计数据,更新在线状态 + prev.Status = d.Status + prev.Name = d.Name + prev.LastIP = d.LastIP + prev.LastOnline = d.LastOnline + if d.LastOffline != nil { + prev.LastOffline = d.LastOffline + } + if d.OnlineCount > prev.OnlineCount { + prev.OnlineCount = d.OnlineCount + } + if d.TotalOnline > prev.TotalOnline { + prev.TotalOnline = d.TotalOnline + } + if prev.FirstSeen.IsZero() { + prev.FirstSeen = d.FirstSeen + } + } else { + cp := *d + sd.devices[d.MAC] = &cp + } + } + } + sd.mu.Unlock() + + // 持久化 + s.saveSite(sd) + + w.Header().Set("Content-Type", "application/json") + json.NewEncoder(w).Encode(map[string]interface{}{"ok": true, "site": p.Site, "events_received": recev, "time": now}) +} + +// handleRaw 接收采集端(ESP8266)上报的原始路由器页面 HTML。 +// 认证方式: Header X-Token 或 query ?token,与站点校验一致。 +// site 通过 Header X-Site 或 query ?site 指定。 +// body 为 /userRpm/AssignedIpAddrListRpm.htm 的原始响应。 +// 服务器端解析 DHCPDynList → 做上下线判定 → 记录事件 → 持久化。 +func (s *Server) handleRaw(w http.ResponseWriter, r *http.Request) { + if r.Method != http.MethodPost { + http.Error(w, "method not allowed", http.StatusMethodNotAllowed) + return + } + if !s.authOK(r) { + http.Error(w, "401: token 错误", http.StatusUnauthorized) + return + } + site := r.Header.Get("X-Site") + if site == "" { + site = r.URL.Query().Get("site") + } + if site == "" { + http.Error(w, "缺少 site(Header X-Site 或 query ?site)", http.StatusBadRequest) + return + } + + body, err := io.ReadAll(r.Body) + if err != nil { + http.Error(w, "读取 body 失败: "+err.Error(), http.StatusBadRequest) + return + } + if len(body) == 0 { + http.Error(w, "body 为空", http.StatusBadRequest) + return + } + + // 服务器端解析 + clients, err := parseDHCPPage(body) + if err != nil { + // 解析失败: 可能认证失败(403/锁页)或页面结构变化 + text := string(body) + switch { + case strings.Contains(text, "403 Forbidden") || strings.Contains(text, "You have no authority"): + http.Error(w, "路由器认证被拒绝(403): 检查采集端密码或路由器锁定", http.StatusBadGateway) + return + case strings.Contains(text, "httpAutErrorArray") || strings.Contains(text, "pcPassword"): + http.Error(w, "路由器认证失败: 密码不正确或多次输错被锁定", http.StatusBadGateway) + return + } + http.Error(w, "解析失败: "+err.Error(), http.StatusBadRequest) + return + } + + now := time.Now() + // lookup or 创建站点 + s.mu.RLock() + sd, ok := s.sites[site] + s.mu.RUnlock() + if !ok { + s.mu.Lock() + if sd, ok = s.sites[site]; !ok { + sd = &SiteData{name: site, devices: make(map[string]*Device), rawAbsent: make(map[string]int), rawAbsentToOffline: 2} + s.sites[site] = sd + } + s.mu.Unlock() + } + + sd.mu.Lock() + sd.lastSeen = now + // 缺省防抖次数与 client 默认一致(2 次) + absent := sd.rawAbsentToOffline + if absent == 0 { + absent = 2 + } + sd.applyClients(now, clients, absent) + devCount := len(sd.devices) + sd.mu.Unlock() + + // 持久化 + s.saveSite(sd) + + w.Header().Set("Content-Type", "application/json") + json.NewEncoder(w).Encode(map[string]interface{}{ + "ok": true, + "site": site, + "clients": len(clients), + "device_count": devCount, + "time": now, + }) +} + +// handleSites 站点列表 +func (s *Server) handleSites(w http.ResponseWriter, r *http.Request) { + if !s.authOK(r) { + http.Error(w, "403", http.StatusForbidden) + return + } + s.mu.RLock() + type siteInfo struct { + Site string `json:"site"` + DeviceCount int `json:"device_count"` + OnlineCount int `json:"online_count"` + LastSeen string `json:"last_seen"` + IsOnline bool `json:"is_online"` + EventCount int `json:"event_count"` + } + list := make([]siteInfo, 0, len(s.sites)) + onlineWindow := 3 * time.Minute + for name, sd := range s.sites { + sd.mu.RLock() + devs := len(sd.devices) + on := 0 + for _, d := range sd.devices { + if d.Status == evOnline { + on++ + } + } + last := sd.lastSeen + evc := len(sd.events) + sd.mu.RUnlock() + list = append(list, siteInfo{ + Site: name, + DeviceCount: devs, + OnlineCount: on, + LastSeen: last.Format(time.RFC3339), + IsOnline: time.Since(last) < onlineWindow, + EventCount: evc, + }) + } + s.mu.RUnlock() + sort.Slice(list, func(i, j int) bool { return list[i].Site < list[j].Site }) + w.Header().Set("Content-Type", "application/json; charset=utf-8") + json.NewEncoder(w).Encode(map[string]interface{}{"sites": list, "retain_days": s.retainDays}) +} + +// handleSite 单个站点详情 +func (s *Server) handleSite(w http.ResponseWriter, r *http.Request) { + if !s.authOK(r) { + http.Error(w, "403", http.StatusForbidden) + return + } + name := r.URL.Query().Get("site") + if name == "" { + http.Error(w, "缺少 site 参数", http.StatusBadRequest) + return + } + s.mu.RLock() + sd, ok := s.sites[name] + s.mu.RUnlock() + if !ok { + http.Error(w, "站点不存在", http.StatusNotFound) + return + } + + sd.mu.RLock() + devs := make([]*Device, 0, len(sd.devices)) + for _, d := range sd.devices { + cp := *d + devs = append(devs, &cp) + } + evs := append([]Event(nil), sd.events...) + last := sd.lastSeen + sd.mu.RUnlock() + + sort.Slice(devs, func(a, b int) bool { + if devs[a].Status != devs[b].Status { + return devs[a].Status == evOnline + } + return devs[a].MAC < devs[b].MAC + }) + // 事件最新在前 + for i, j := 0, len(evs)-1; i < j; i, j = i+1, j-1 { + evs[i], evs[j] = evs[j], evs[i] + } + limit := 200 + if v := r.URL.Query().Get("limit"); v != "" { + fmt.Sscanf(v, "%d", &limit) + } + if len(evs) > limit { + evs = evs[:limit] + } + + w.Header().Set("Content-Type", "application/json; charset=utf-8") + json.NewEncoder(w).Encode(map[string]interface{}{ + "site": name, + "devices": devs, + "events": evs, + "last_seen": last.Format(time.RFC3339), + "retain_days": s.retainDays, + }) +} + +// saveSite 持久化单站点数据 +func (s *Server) saveSite(sd *SiteData) { + dir := filepath.Join(s.dataDir, "sites", sanitize(sd.name)) + if err := os.MkdirAll(dir, 0755); err != nil { + fmt.Fprintf(os.Stderr, "创建站点目录失败: %v\n", err) + return + } + sd.mu.RLock() + defer sd.mu.RUnlock() + + // devices.json + devData, _ := json.MarshalIndent(sd.devices, "", " ") + os.WriteFile(filepath.Join(dir, "devices.json"), devData, 0644) + + // events.csv (增量快照: 全量重写,简单可靠,数据量小) + f, err := os.Create(filepath.Join(dir, "events.csv")) + if err == nil { + w := csv.NewWriter(f) + w.Write([]string{"timestamp", "event", "mac", "ip", "name", "detail"}) + for _, e := range sd.events { + w.Write([]string{e.Timestamp.Format(time.RFC3339), e.Event, e.MAC, e.IP, e.Name, e.Detail}) + } + w.Flush() + f.Close() + } +} + +// sanitize 站点名防目录穿越 +func sanitize(name string) string { + name = strings.ReplaceAll(name, "..", "_") + name = strings.ReplaceAll(name, "/", "_") + name = strings.ReplaceAll(name, "\\", "_") + return name +} + +// loadAll 启动时加载所有站点数据 +func (s *Server) loadAll() { + base := filepath.Join(s.dataDir, "sites") + entries, err := os.ReadDir(base) + if err != nil { + return // 目录不存在,首次运行 + } + for _, e := range entries { + if !e.IsDir() { + continue + } + name := e.Name() + sd := &SiteData{name: name, devices: make(map[string]*Device)} + dir := filepath.Join(base, name) + + if b, err := os.ReadFile(filepath.Join(dir, "devices.json")); err == nil { + json.Unmarshal(b, &sd.devices) + } + if rows, err := readCSV(filepath.Join(dir, "events.csv")); err == nil && len(rows) > 1 { + for _, r := range rows[1:] { + if len(r) < 6 { + continue + } + t, err := time.Parse(time.RFC3339, r[0]) + if err != nil { + continue + } + sd.events = append(sd.events, Event{Timestamp: t, Event: r[1], MAC: r[2], IP: r[3], Name: r[4], Detail: r[5]}) + } + } + if len(sd.devices) > 0 || len(sd.events) > 0 { + sd.lastSeen = time.Now().Add(-24 * time.Hour) // 重启后推测离线 + s.mu.Lock() + s.sites[name] = sd + s.mu.Unlock() + } + } + fmt.Printf("[%s] 已加载 %d 个站点\n", time.Now().Format("2006-01-02 15:04:05"), len(s.sites)) +} + +//go:embed web/dashboard.html +var dashboardFS embed.FS diff --git a/server_test.go b/server_test.go new file mode 100644 index 0000000..a772bed --- /dev/null +++ b/server_test.go @@ -0,0 +1,142 @@ +package main + +import ( + "bytes" + "encoding/json" + "net/http" + "net/http/httptest" + "testing" + "time" +) + +// 测试上报: 正确 token 接收, 错误 token 拒绝 +func TestReportAuth(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + token: "secret", + sites: make(map[string]*SiteData), + } + + // 错误 token + req := httptest.NewRequest(http.MethodPost, "/api/report", bytes.NewBufferString(`{"site":"s1","token":"bad"}`)) + w := httptest.NewRecorder() + s.handleReport(w, req) + if w.Code != http.StatusUnauthorized { + t.Fatalf("错误token应401, got %d", w.Code) + } + + // 正确 token + payload := ReportPayload{ + Site: "s1", + Token: "secret", + Events: []Event{ + {Timestamp: time.Now(), Event: evOnline, MAC: "AA:BB", IP: "1.1.1.1", Name: "Dev"}, + }, + Snapshot: &ReportSnapshot{ + Devices: []*Device{{MAC: "AA:BB", Name: "Dev", LastIP: "1.1.1.1", Status: evOnline}}, + }, + } + body, _ := json.Marshal(payload) + req = httptest.NewRequest(http.MethodPost, "/api/report", bytes.NewBuffer(body)) + w = httptest.NewRecorder() + s.handleReport(w, req) + if w.Code != http.StatusOK { + t.Fatalf("正确token应200, got %d: %s", w.Code, w.Body.String()) + } + + s.mu.RLock() + sd := s.sites["s1"] + s.mu.RUnlock() + if sd == nil { + t.Fatal("站点未创建") + } + sd.mu.RLock() + if len(sd.devices) != 1 { + t.Fatalf("设备应1台, got %d", len(sd.devices)) + } + if len(sd.events) != 1 { + t.Fatalf("事件应1条, got %d", len(sd.events)) + } + sd.mu.RUnlock() +} + +// 测试: 快照覆盖状态(离线设备出现在快照后状态更新) +func TestReportSnapshotMerge(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + sites: make(map[string]*SiteData), + } + sd := &SiteData{name: "s1", devices: make(map[string]*Device)} + s.mu.Lock() + s.sites["s1"] = sd + s.mu.Unlock() + + // 第一上报: 在线 + dev1 := &Device{MAC: "AA:BB", Name: "Dev", Status: evOnline, OnlineCount: 1} + sd.mu.Lock() + sd.devices["AA:BB"] = dev1 + sd.mu.Unlock() + + // 第二上报: 快照说该设备离线 + payload := ReportPayload{ + Site: "s1", + Token: "", + Snapshot: &ReportSnapshot{Devices: []*Device{{MAC: "AA:BB", Name: "Dev", Status: evOffline}}}, + } + body, _ := json.Marshal(payload) + req := httptest.NewRequest(http.MethodPost, "/api/report", bytes.NewBuffer(body)) + w := httptest.NewRecorder() + s.handleReport(w, req) + if w.Code != http.StatusOK { + t.Fatalf("应200, got %d", w.Code) + } + sd.mu.RLock() + got := sd.devices["AA:BB"] + sd.mu.RUnlock() + if got == nil || got.Status != evOffline { + t.Fatalf("设备状态应被快照覆盖为离线, got %+v", got) + } +} + +// 测试: 多站点隔离 +func TestMultiSite(t *testing.T) { + s := &Server{ + dataDir: t.TempDir(), + sites: make(map[string]*SiteData), + } + report := func(site, mac string) { + payload := ReportPayload{ + Site: site, + Snapshot: &ReportSnapshot{ + Devices: []*Device{{MAC: mac, Name: site, Status: evOnline}}, + }, + } + body, _ := json.Marshal(payload) + req := httptest.NewRequest(http.MethodPost, "/api/report", bytes.NewBuffer(body)) + s.handleReport(httptest.NewRecorder(), req) + } + report("home", "AA:01") + report("office", "BB:02") + + s.mu.RLock() + if len(s.sites) != 2 { + t.Fatalf("应2个站点, got %d", len(s.sites)) + } + s.mu.RUnlock() +} + +// 测试 authOK 的 token 校验(header 与 query) +func TestAuthOK(t *testing.T) { + s := &Server{token: "secret"} + if !s.authOK(httptest.NewRequest("GET", "/api/sites?token=secret", nil)) { + t.Fatal("query token 应通过") + } + r := httptest.NewRequest("GET", "/api/sites", nil) + r.Header.Set("X-Token", "secret") + if !s.authOK(r) { + t.Fatal("header token 应通过") + } + if s.authOK(httptest.NewRequest("GET", "/api/sites", nil)) { + t.Fatal("无token应拒绝") + } +} diff --git a/web/dashboard.html b/web/dashboard.html new file mode 100644 index 0000000..9467b9f --- /dev/null +++ b/web/dashboard.html @@ -0,0 +1,195 @@ + + + + + +DHCP 多站点看板 + + + +
+
+

📡 DHCP 多站点看板

+
+
+
+
+ +
+
-
在线设备
+
-
离线设备
+
-
设备总数
+
-
事件总数
+
+ +
+

设备列表

+ + + + + + +
状态设备名MAC 地址IP 地址首次发现最近上线最近下线在线次数累计在线
+
+ +
+

最近事件

+
+
+ + + + + + \ No newline at end of file diff --git a/web/index.html b/web/index.html new file mode 100644 index 0000000..46f63e7 --- /dev/null +++ b/web/index.html @@ -0,0 +1,151 @@ + + + + + +DHCP 客户端监控 + + + +

📡 DHCP 客户端监控

+
+ +
+
-
在线设备
+
-
离线设备
+
-
设备总数
+
-
今日事件
+
+ +
+

设备列表

+ + + + + + +
状态设备名MAC 地址IP 地址首次发现最近上线最近下线在线次数累计在线
+
+ +
+

最近事件

+
+
+ + + + + +