介绍

NetAlertX是一款WiFi/LAN网络安全与入侵威胁检测工具，该工具能够扫描连接到您网络的设备，如果发现新的和未知的设备，会向您发出警报。

NetAlertX 是💻🔍 WIFI/LAN 入侵检测器。能扫描连接到您的网络的设备，并在发现新设备或未知设备时向您发出警报。能够在一个地方可视化您的所有网络，获得实时警报，并与您的智能家居无缝集成。

2024 年 4 月初，Pi.Alert 更名为 NetAlertX。作者认为重命名有助于消除项目有关仅支持 Raspberry Pi 的困惑😵

如果你之前使用的是 PiAlert，可以看看👇这篇迁移指南：https://github.com/jokob-sk/NetAlertX/blob/main/docs/MIGRATION.md

如果迁移中遇到不会迁移数据库和设备的问题，可以看看👇这篇：https://github.com/jokob-sk/NetAlertX/issues/633

功能

1、该应用程序会扫描您的网络，以查找新设备、新连接（重新连接）、断开连接、“始终连接”设备关闭、设备 IP 更改和Internet IP 地址更改。发现和扫描方法包括：arp 扫描、 Pi-hole – DB 导入、 Pi-hole – DHCP 租约导入、通用 DHCP 租约导入。UNIFI控制器导入、启用 SNMP 的路由器导入。

2、支持向 80 多种服务发送通知，包括通过Apprise的Telegram ，或者使用Pushsafer、Pushover或NTFY。

3、可以将您的数据和设备更改输入Home Assistant，读取API端点，或使用Webhooks设置自定义自动化流程。

4、支持使用插件系统构建您自己的扫描设备。

工具安装

由于该工具基于Python 3开发，因此我们首先需要在本地设备上安装并配置好最新版本的广大研究人员可以直接使用下列命令将该项目源码克隆至本地：

git clone https://github.com/jokob-sk/NetAlertX.git

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 netalertx 和 子目录
mkdir -p /volume1/docker/netalertx/{config,db}

# 进入 netalertx 目录
cd /volume1/docker/netalertx

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name netalertx \
   --network=host \
   -v $(pwd)/config:/app/config \
   -v $(pwd)/db:/app/db \
   -e TZ=Asia/Shanghai \
   -e PORT=20211 \
   jokobsk/netalertx:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: "3"

services:
  netalertx:
    privileged: true
    image: jokobsk/netalertx:latest
    container_name: netalertx
    network_mode: host
    restart: unless-stopped
    volumes:
      - ./config: /app/config
      - ./db: /app/db
    environment:
      - TZ=Asia/Shanghai
      - PORT=20211

然后执行下面的命令

# 新建文件夹 netalertx 和 子目录
mkdir -p /volume1/docker/netalertx/{config,db}

# 进入 netalertx 目录
cd /volume1/docker/netalertx

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:20211 就能看到主界面

中文

进入 Settings –> UI_LANG –> Chinese（zh_cn）

扫描

关于扫描设备，可以参考 Pi.Alert 中的设置

文章传送门：网络入侵探测器Pi.Alert

网络图

进入 Network 菜单

下拉会看到所有设备，找到路由器，点 Assign

上来后我们会看到路由器 R6300V2 已经出现在拓扑图上了，点设备进入详细设置

在 Type 中下拉找到 Router

如果 icon 能跟随设备类型变化就好了

保存后返回到 Network 菜单，你会发现多了一级网络节点

现在可以在路由下添加交换机和设备了，来张效果图吧

后续也可以在设备中修改父级节点

上一张官方录制的动图，可能会更直观一点

后记

学技术就要敢折腾多折腾，久病成医、百炼成钢，折腾多了你才能学到东西。对于任何技能，技术本身要比它所使用的工具重要，而比技术本身重要的是每个人自身的学习热情与方法。程序这些外在的工具能帮你轻易的完成很多事情，但是更重要也更有意义的是在这不断的探索和尝试与不断的发现和解决问题的过程中你所理解的原理和积累的经验，而最终的目的是希望你通过这一过程能够领悟怎么在这样一个知识如此繁多与复杂的世界里快乐而高效地学会一项自己所需要的技能。如果你能做到这一点，你就成为了一名真正的善学者。
信息检索的关键在于构造关键词，一定要学会怎么准确的构造搜索引擎（百度等）的搜索关键词。更快、更准确的找到自己问题的答案。学习要敢于问问题，不要腼腆，向过来人请教是最快最高效的解决问题的方法。

参考文档

jokob-sk/NetAlertX: 💻🔍 WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found.
地址：https://github.com/jokob-sk/NetAlertX

NetAlert X
地址：https://netalertx.com/

Pi.Alert is dead…💀 Long live NetAlert X 🚀 : r/selfhosted
地址：https://www.reddit.com/r/selfhosted/comments/1c664ai/pialert_is_dead_long_live_netalert_x/

Pi.Alert est mort…💀 Vive NetAlert X 🚀 : r/selfhosted地址：https://www.reddit.com/r/selfhosted/comments/1c664ai/pialert_is_dead_long_live_netalert_x/?tl=fr