基于PiAlert的网络扫描器NetAlertX

什么是 NetAlertX ?

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

20244 月初,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

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 netalertx ,选择第二个 jokobsk/netalertx,版本选择 latest

本文写作时, latest 版本对应为 24.6.8

权限

要避免出现权限问题,可以勾选 使用高权限执行容器

老苏没有勾选,似乎也能正常工作;

docker 文件夹中,创建一个新文件夹 netalertx,并在其中建两个子文件夹 configdb

文件夹 装载路径 说明
docker/netalertx/config /app/config 存放设置
docker/netalertx/db /app/db 存放数据库

网络

勾选 使用与 Docker Host 相同的网络

环境

可变
TZ 设置时区,设为 Asia/Shanghai
PORT 容器端口,默认值为 20211

命令行安装

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 新建文件夹 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 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 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)

但保存后你会发现变化不大

因为完成度只有 7%

扫描

关于扫描设备,可以参考 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