网络设备监控器

监控网络中未知设备。适用于任何暴露HTTP管理面板的路由器。追踪设备状态变化并在新连接时发出警报。

快速开始

bash

扫描网络（需要nmap）

python3 {baseDir}/scripts/scan-network.py --subnet 192.168.1.0/24

快速ARP扫描（速度更快）

python3 {baseDir}/scripts/scan-network.py --subnet 192.168.1.0/24 --arp

选项

- --subnet CIDR — 要扫描的网络范围（必填）
--arp — 使用ARP扫描（速度更快，需要root权限）
--known FILE — 包含已知设备的JSON文件（MAC地址 → 名称映射）
--state FILE — 用于追踪变化的状态文件（默认：~/.network-state.json）
--alerts — 仅在发现未知设备时输出
--json — 以JSON格式输出
--table — 以表格形式美化输出

状态追踪

监控器会在运行之间保存设备状态：

json
{
last_scan: 2026-03-29T12:00:00,
devices: {
AA:BB:CC:DD:EE:FF: {
ip: 192.168.1.100,
hostname: my-laptop,
first_seen: 2026-03-29T10:00:00,
last_seen: 2026-03-29T12:00:00,
status: online
}
},
unknown_devices: [11:22:33:44:55:66]
}

警报模式

使用 --alerts 运行以集成cron/心跳检测：
bash

仅在检测到未知设备时输出结果

python3 scan-network.py --subnet 192.168.1.0/24 --alerts

已知设备格式

创建 known-devices.json：
json
{
AA:BB:CC:DD:EE:FF: 我的笔记本电脑,
11:22:33:44:55:66: 智能电视,
DE:AD:BE:EF:00:00: 游戏主机
}

注意事项

- ARP扫描需要root权限：sudo python3 scan-network.py --arp
nmap扫描无需root权限但速度较慢
适用于Linux和macOS
无外部API依赖

网络设备监控