网络设备监控器

监控您的网络中是否存在未知设备。兼容任何提供 HTTP 管理面板的路由器。跟踪设备状态变化，并在检测到新连接时发出告警。

快速开始

# 扫描您的网络（需安装 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 — 以表格形式美化输出

状态跟踪

监控器会在各次运行之间持久化保存设备状态：

{
  "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 或心跳检测集成：

# 仅在检测到未知设备时打印输出
python3 scan-network.py --subnet 192.168.1.0/24 --alerts

已知设备格式

创建一个 known-devices.json 文件：

{
  "AA:BB:CC:DD:EE:FF": "My Laptop",
  "11:22:33:44:55:66": "Smart TV",
  "DE:AD:BE:EF:00:00": "Game Console"
}

注意事项

• ARP 扫描需要 root 权限：sudo python3 scan-network.py --arp
• nmap 扫描无需 root 权限，但速度较慢
• 支持 Linux 和 macOS 系统
• 不依赖任何外部 API