基于PiAlert的网络扫描器NetAlertX

什么是 NetAlertX ？

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

安装

在群晖上以 Docker 方式安装。

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

本文写作时， latest 版本对应为 24.6.8；

权限

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

老苏没有勾选，似乎也能正常工作；

卷

在 docker 文件夹中，创建一个新文件夹 netalertx，并在其中建两个子文件夹 config 和 db

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

网络

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

环境

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

命令行安装

如果你熟悉命令行，可能用 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）

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

因为完成度只有 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