Initial: DHCP 客户端监控双模式

- client 模式抓取水星 MW305R DHCP 列表,记录上下线,本地看板
- server 模式收上报,按站点分组持久化,多站点看板,7天滚动
- ESP8266 低功耗固件抓原始 HTML 上报 /api/raw,服务器端解析
- 部署脚本+systemd 单元+文档,交叉编译 Linux 二进制
This commit is contained in:
Sakurasan committed 2026-10-13 23:37:04 +08:00
commit 88a35ea427
20 files changed
+3007

No files matched your search

+11
View File
@@ -0,0 +1,11 @@
# 构建产物
/dhcp-mon
/dhcp-mon-linux-amd64
/dhcp-mon-linux-arm64
/dhcpclient
# 运行时数据 (设备MAC/IP/事件, 含隐私, 勿提交)
/data/
# macOS
.DS_Store
+212
View File
@@ -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/<site>/`),同样 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/<site>/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` 并做上下线判定
+114
View File
@@ -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@<VPS_IP>:/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://<IP>: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 需评估内存)。
+22
View File
@@ -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
+51
View File
@@ -0,0 +1,51 @@
#!/usr/bin/env bash
# dhcp-mon server 一键部署脚本(VPS)
# 用法:
# sudo ./install-server.sh <dhcp-mon-linux-amd64 路径> [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 <<EOF
WEB_ADDR=:${PORT}
DATA_DIR=${DATA}
STOKEN=${STOKEN}
RETAIN_DAYS=7
EOF
chown root:"$USER" /etc/dhcp-mon-server.env
chmod 640 /etc/dhcp-mon-server.env
echo "==> 安装 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"
+8
View File
@@ -0,0 +1,8 @@
# PlatformIO build artifacts
.pio/
.vscode/
.pioenvs/
.piolibdeps/
# 用户配置(含 WiFi 密码/上报令牌),勿提交
src/secrets.h
+106
View File
@@ -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 分钟远小于上限)。
+18
View File
@@ -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
+184
View File
@@ -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 <Arduino.h>
#include <ESP8266WiFi.h>
#include <ESP8266HTTPClient.h>
#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);
}
+27
View File
@@ -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;
+5
View File
@@ -0,0 +1,5 @@
module dhcpclient
go 1.27
require golang.org/x/text v0.21.0
+2
View File
@@ -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=
+770
View File
@@ -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
}
+111
View File
@@ -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)
}
}
}
+238
View File
@@ -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("<html><head><title>water</title></head><body>\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("</body></html>\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("<html>no data here</html>")); 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("<html>403 Forbidden</html>"))
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"])
}
}
+109
View File
@@ -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
}
+531
View File
@@ -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
+142
View File
@@ -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应拒绝")
}
}
+195
View File
@@ -0,0 +1,195 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>DHCP 多站点看板</title>
<style>
:root {
--bg: #0f172a; --card: #1e293b; --border: #334155;
--text: #e2e8f0; --muted: #94a3b8;
--green: #22c55e; --red: #ef4444; --blue: #3b82f6; --amber: #f59e0b;
}
* { box-sizing: border-box; margin: 0; padding: 0; }
body { background: var(--bg); color: var(--text); font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; padding: 20px; }
.top { display: flex; align-items: center; gap: 16px; flex-wrap: wrap; margin-bottom: 20px; }
h1 { font-size: 22px; }
.sub { color: var(--muted); font-size: 13px; }
.sitebar { display: flex; gap: 8px; flex-wrap: wrap; }
.sitebtn { background: var(--card); border: 1px solid var(--border); color: var(--text); border-radius: 8px; padding: 8px 14px; cursor: pointer; font-size: 13px; }
.sitebtn:hover { border-color: var(--blue); }
.sitebtn.active { background: var(--blue); border-color: var(--blue); color: #fff; }
.sitebtn .cnt { margin-left: 6px; color: var(--muted); font-size: 12px; }
.sitebtn.active .cnt { color: rgba(255,255,255,.8); }
.stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); gap: 12px; margin-bottom: 24px; }
.stat { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 14px 16px; }
.stat .num { font-size: 26px; font-weight: 700; }
.stat .lbl { color: var(--muted); font-size: 12px; margin-top: 2px; }
.num.online { color: var(--green); } .num.offline { color: var(--red); } .num.total { color: var(--blue); }
.num.events { color: var(--amber); }
.card { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 16px; margin-bottom: 24px; }
.card h2 { font-size: 15px; margin-bottom: 12px; color: var(--muted); font-weight: 600; }
table { width: 100%; border-collapse: collapse; font-size: 13px; }
th { text-align: left; color: var(--muted); font-weight: 500; padding: 8px 10px; border-bottom: 1px solid var(--border); white-space: nowrap; }
td { padding: 8px 10px; border-bottom: 1px solid rgba(51,65,85,.4); white-space: nowrap; }
tr:hover td { background: rgba(59,130,246,.06); }
.badge { display: inline-block; padding: 2px 10px; border-radius: 999px; font-size: 12px; font-weight: 600; }
.badge.online { background: rgba(34,197,94,.15); color: var(--green); }
.badge.offline { background: rgba(239,68,68,.15); color: var(--red); }
.badge.stale { background: rgba(245,158,11,.15); color: var(--amber); }
.mac { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
.muted { color: var(--muted); }
.evt { display: flex; gap: 10px; align-items: center; padding: 7px 0; border-bottom: 1px solid rgba(51,65,85,.3); font-size: 13px; }
.evt:last-child { border-bottom: none; }
.dot { width: 8px; height: 8px; border-radius: 50%; flex-shrink: 0; }
.dot.up { background: var(--green); } .dot.down { background: var(--red); }
.evt .time { color: var(--muted); white-space: nowrap; }
.evt .name { font-weight: 600; }
.evt .detail { color: var(--muted); font-size: 12px; }
.footer { color: var(--muted); font-size: 12px; text-align: center; padding: 10px 0 30px; }
.scroll { max-height: 460px; overflow-y: auto; }
.empty { color: var(--muted); padding: 20px 0; text-align: center; }
@media (max-width: 640px) { body { padding: 10px; } table { font-size: 12px; } }
</style>
</head>
<body>
<div class="top">
<div>
<h1>📡 DHCP 多站点看板</h1>
<div class="sub" id="sub"></div>
</div>
<div class="sitebar" id="sites"></div>
</div>
<div class="stats">
<div class="stat"><div class="num online" id="st-online">-</div><div class="lbl">在线设备</div></div>
<div class="stat"><div class="num offline" id="st-offline">-</div><div class="lbl">离线设备</div></div>
<div class="stat"><div class="num total" id="st-total">-</div><div class="lbl">设备总数</div></div>
<div class="stat"><div class="num events" id="st-events">-</div><div class="lbl">事件总数</div></div>
</div>
<div class="card">
<h2 id="dev-title">设备列表</h2>
<table>
<thead><tr>
<th>状态</th><th>设备名</th><th>MAC 地址</th><th>IP 地址</th>
<th>首次发现</th><th>最近上线</th><th>最近下线</th><th>在线次数</th><th>累计在线</th>
</tr></thead>
<tbody id="devices"></tbody>
</table>
</div>
<div class="card">
<h2>最近事件</h2>
<div class="scroll" id="events"></div>
</div>
<div class="footer" id="footer"></div>
<script>
const $ = id => document.getElementById(id);
const fmtTime = ts => {
if (!ts) return '-';
const d = new Date(ts);
const p = n => String(n).padStart(2, '0');
return `${d.getMonth()+1}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
};
const fmtDur = sec => {
sec = Number(sec) || 0;
const h = Math.floor(sec/3600), m = Math.floor(sec%3600/60);
return h > 0 ? `${h}小时${m}分` : `${m}分钟`;
};
const esc = s => String(s ?? '').replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
let currentSite = null;
let siteMap = {};
// 从 URL 读取 token(?token=xxx),所有 API 请求带上
const urlParams = new URLSearchParams(window.location.search);
const AUTH_TOKEN = urlParams.get('token') || '';
const api = path => {
const sep = path.includes('?') ? '&' : '?';
return AUTH_TOKEN ? path + sep + 'token=' + encodeURIComponent(AUTH_TOKEN) : path;
};
async function loadSites() {
try {
const data = await fetch(api('/api/sites')).then(r => r.json());
siteMap = {};
(data.sites || []).forEach(s => siteMap[s.site] = s);
$('sub').textContent = `数据保留 ${data.retain_days || 7} 天 · 站点离线判定: 3 分钟无上报`;
const bar = $('sites');
bar.innerHTML = '';
(data.sites || []).forEach(s => {
const btn = document.createElement('button');
btn.className = 'sitebtn' + (s.site === currentSite ? ' active' : '');
btn.innerHTML = `${esc(s.site)} <span class="cnt">${s.online_count}/${s.device_count}</span>`;
btn.onclick = () => { currentSite = s.site; loadSite(); loadSites(); };
bar.appendChild(btn);
});
if (!currentSite && data.sites && data.sites.length) {
currentSite = data.sites[0].site;
loadSite();
}
} catch (e) {
$('sub').textContent = '加载站点失败: ' + e.message;
}
}
async function loadSite() {
if (!currentSite) {
$('devices').innerHTML = '<tr><td colspan="9" class="empty">暂无站点数据</td></tr>';
$('events').innerHTML = '<div class="empty">暂无事件</div>';
$('st-online').textContent = $('st-offline').textContent = $('st-total').textContent = $('st-events').textContent = '-';
return;
}
try {
const data = await fetch(api('/api/site?site=' + encodeURIComponent(currentSite) + '&limit=100')).then(r => r.json());
$('dev-title').textContent = `设备列表 · ${esc(currentSite)}`;
let online = 0, offline = 0;
(data.devices || []).forEach(d => { if (d.status === 'online') online++; else offline++; });
$('st-online').textContent = online;
$('st-offline').textContent = offline;
$('st-total').textContent = (data.devices || []).length;
$('st-events').textContent = (data.events || []).length;
$('devices').innerHTML = (data.devices || []).map(d => `
<tr>
<td><span class="badge ${d.status === 'online' ? 'online' : 'offline'}">${d.status === 'online' ? '在线' : '离线'}</span></td>
<td>${esc(d.name || '-')}</td>
<td class="mac">${esc(d.mac)}</td>
<td class="mac">${esc(d.last_ip || '-')}</td>
<td>${fmtTime(d.first_seen)}</td>
<td>${fmtTime(d.last_online)}</td>
<td>${fmtTime(d.last_offline)}</td>
<td>${d.online_count ?? 0}</td>
<td>${fmtDur(d.total_online_seconds)}</td>
</tr>`).join('') || '<tr><td colspan="9" class="empty">暂无设备</td></tr>';
$('events').innerHTML = (data.events || []).map(e => {
const up = e.event === 'online';
return `<div class="evt">
<span class="dot ${up ? 'up' : 'down'}"></span>
<span class="time">${fmtTime(e.timestamp)}</span>
<span class="name">${esc(e.name || '-')}</span>
<span class="mac muted">${esc(e.mac)}</span>
<span class="mac muted">${esc(e.ip || '')}</span>
<span class="detail">${esc(e.detail || '')}</span>
</div>`;
}).join('') || '<div class="empty">暂无事件</div>';
$('footer').textContent = `当前站点: ${currentSite} · 最近上报 ${fmtTime(data.last_seen)} · 页面自动刷新 · ${new Date().toLocaleString()}`;
} catch (e) {
$('footer').textContent = '加载站点失败: ' + e.message;
}
}
loadSites();
loadSite();
setInterval(() => { loadSites(); loadSite(); }, 5000);
</script>
</body>
</html>
+151
View File
@@ -0,0 +1,151 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>DHCP 客户端监控</title>
<style>
:root {
--bg: #0f172a; --card: #1e293b; --border: #334155;
--text: #e2e8f0; --muted: #94a3b8;
--green: #22c55e; --red: #ef4444; --blue: #3b82f6; --amber: #f59e0b;
}
* { box-sizing: border-box; margin: 0; padding: 0; }
body { background: var(--bg); color: var(--text); font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; padding: 20px; }
h1 { font-size: 22px; margin-bottom: 4px; }
.sub { color: var(--muted); font-size: 13px; margin-bottom: 20px; }
.stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 12px; margin-bottom: 24px; }
.stat { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 14px 16px; }
.stat .num { font-size: 26px; font-weight: 700; }
.stat .lbl { color: var(--muted); font-size: 12px; margin-top: 2px; }
.num.online { color: var(--green); } .num.offline { color: var(--red); } .num.total { color: var(--blue); } .num.events { color: var(--amber); }
.card { background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 16px; margin-bottom: 24px; }
.card h2 { font-size: 15px; margin-bottom: 12px; color: var(--muted); font-weight: 600; }
table { width: 100%; border-collapse: collapse; font-size: 13px; }
th { text-align: left; color: var(--muted); font-weight: 500; padding: 8px 10px; border-bottom: 1px solid var(--border); white-space: nowrap; }
td { padding: 8px 10px; border-bottom: 1px solid rgba(51,65,85,.4); white-space: nowrap; }
tr:hover td { background: rgba(59,130,246,.06); }
.badge { display: inline-block; padding: 2px 10px; border-radius: 999px; font-size: 12px; font-weight: 600; }
.badge.online { background: rgba(34,197,94,.15); color: var(--green); }
.badge.offline { background: rgba(239,68,68,.15); color: var(--red); }
.mac { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
.muted { color: var(--muted); }
.evt { display: flex; gap: 10px; align-items: center; padding: 7px 0; border-bottom: 1px solid rgba(51,65,85,.3); font-size: 13px; }
.evt:last-child { border-bottom: none; }
.dot { width: 8px; height: 8px; border-radius: 50%; flex-shrink: 0; }
.dot.up { background: var(--green); } .dot.down { background: var(--red); }
.evt .time { color: var(--muted); white-space: nowrap; }
.evt .name { font-weight: 600; }
.evt .detail { color: var(--muted); font-size: 12px; }
.footer { color: var(--muted); font-size: 12px; text-align: center; padding: 10px 0 30px; }
.scroll { max-height: 480px; overflow-y: auto; }
@media (max-width: 640px) { body { padding: 10px; } table { font-size: 12px; } }
</style>
</head>
<body>
<h1>📡 DHCP 客户端监控</h1>
<div class="sub" id="sub"></div>
<div class="stats">
<div class="stat"><div class="num online" id="st-online">-</div><div class="lbl">在线设备</div></div>
<div class="stat"><div class="num offline" id="st-offline">-</div><div class="lbl">离线设备</div></div>
<div class="stat"><div class="num total" id="st-total">-</div><div class="lbl">设备总数</div></div>
<div class="stat"><div class="num events" id="st-events">-</div><div class="lbl">今日事件</div></div>
</div>
<div class="card">
<h2>设备列表</h2>
<table>
<thead><tr>
<th>状态</th><th>设备名</th><th>MAC 地址</th><th>IP 地址</th>
<th>首次发现</th><th>最近上线</th><th>最近下线</th><th>在线次数</th><th>累计在线</th>
</tr></thead>
<tbody id="devices"></tbody>
</table>
</div>
<div class="card">
<h2>最近事件</h2>
<div class="scroll" id="events"></div>
</div>
<div class="footer" id="footer"></div>
<script>
const $ = id => document.getElementById(id);
const fmtTime = ts => {
if (!ts) return '-';
const d = new Date(ts);
const p = n => String(n).padStart(2, '0');
return `${d.getMonth()+1}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
};
const fmtDur = sec => {
sec = Number(sec) || 0;
const h = Math.floor(sec/3600), m = Math.floor(sec%3600/60);
return h > 0 ? `${h}小时${m}分` : `${m}分钟`;
};
const esc = s => String(s ?? '').replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
let lastEventTs = null;
async function load() {
try {
const [devs, evts] = await Promise.all([
fetch('/api/devices').then(r => r.json()),
fetch('/api/events?limit=100').then(r => r.json()),
]);
// 统计
let online = 0, today = 0;
const now = new Date();
const today0 = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
(devs.devices || []).forEach(d => { if (d.status === 'online') online++; });
(evts.events || []).forEach(e => { if (new Date(e.timestamp).getTime() >= today0) today++; });
$('st-online').textContent = online;
$('st-offline').textContent = devs.devices.length - online;
$('st-total').textContent = devs.devices.length;
$('st-events').textContent = today;
// 设备表
const rows = (devs.devices || []).map(d => `
<tr>
<td><span class="badge ${d.status === 'online' ? 'online' : 'offline'}">${d.status === 'online' ? '在线' : '离线'}</span></td>
<td>${esc(d.name || '-')}</td>
<td class="mac">${esc(d.mac)}</td>
<td class="mac">${esc(d.last_ip || '-')}</td>
<td>${fmtTime(d.first_seen)}</td>
<td>${fmtTime(d.last_online)}</td>
<td>${fmtTime(d.last_offline)}</td>
<td>${d.online_count ?? 0}</td>
<td>${fmtDur(d.total_online_seconds)}</td>
</tr>`).join('');
$('devices').innerHTML = rows || '<tr><td colspan="9" class="muted">暂无数据</td></tr>';
// 事件列表
const evtHtml = (evts.events || []).map(e => {
const up = e.event === 'online';
return `<div class="evt">
<span class="dot ${up ? 'up' : 'down'}"></span>
<span class="time">${fmtTime(e.timestamp)}</span>
<span class="name">${esc(e.name || '-')}</span>
<span class="mac muted">${esc(e.mac)}</span>
<span class="mac muted">${esc(e.ip || '')}</span>
<span class="detail">${esc(e.detail || '')}</span>
</div>`;
}).join('');
$('events').innerHTML = evtHtml || '<div class="muted">暂无事件</div>';
if (evts.events && evts.events.length) lastEventTs = evts.events[0].timestamp;
$('sub').textContent = `抓取间隔 ${devs.interval || '-'} · 最近抓取 ${fmtTime(devs.last_poll_ok)} · 数据保留 7 天`;
$('footer').textContent = `页面自动刷新 · ${new Date().toLocaleString()}`;
} catch (err) {
$('footer').textContent = '加载失败: ' + err.message;
}
}
load();
setInterval(load, 5000);
</script>
</body>
</html>