netalertx/NetAlertX

这是什么？

核心功能

• 01通过 arp-scan、Pi-hole、DHCP 租约、UniFi 和 SNMP 路由器导入进行持续发现
• 02检测新设备、连接状态变化和 IPAM 偏差
• 03通过 Apprise（80 多种服务）、Pushover、Pushsafer 和 NTFY 发送通知
• 04工作流可自动分类、分组、取消归档或删除设备
• 05提供 API、Webhook、Home Assistant 集成和 Prometheus 指标导出

适用场景

• 发现家庭或办公网络中未经授权的设备或影子 IT 设备
• 跟踪 IP 地址变化，保持设备清单最新
• 在一个中心面板上监控多个客户或分支机构的网络
• 当有新设备接入时，向手机或聊天工具发送告警

快速上手

1. 1

   使用 Docker 启动 NetAlertX

   docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest
2. 2

   或克隆源代码仓库

   git clone https://github.com/netalertx/NetAlertX.git
3. 3

   进入项目目录并使用 Docker Compose 构建

   cd NetAlertX && docker compose up --force-recreate --build

使用前须知

• !网络扫描需要容器的额外权限，并且在 Linux 上需要主机网络模式。
• !ARP 等扫描方式可能无法检测不同子网中的设备。
• !纯 Wi-Fi 网络可能需要其他扫描器才能准确检测。
• !从旧版本升级的用户必须遵循迁移指南。

收录于专题

标签

常见问题

NetAlertX 是什么？

自托管的网络可见性工具，持续发现网络中的设备、发现变化并发送告警。 NetAlertX 是一个自托管的平台，用于跟踪一个或多个网络中连接的设备。它通过持续扫描发现新设备和重新上线的设备，检测连接状态变化和 IP 地址管理（IPAM）偏差，并维护一份集中的资产清单。发现方式包括 arp-scan、Pi-hole 与 DHCP 租约导入、UniFi 控制器导入，以及支持 SNMP 的路由器导入，同时提供插件系统用于编写自定义扫描器。

NetAlertX 可以免费使用吗？用的什么许可证？

NetAlertX 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

NetAlertX 还在维护吗？

活跃维护中。NetAlertX 最近一次提交是在 2026年11月1日。

NetAlertX 适合用来做什么？

发现家庭或办公网络中未经授权的设备或影子 IT 设备 跟踪 IP 地址变化，保持设备清单最新 在一个中心面板上监控多个客户或分支机构的网络 当有新设备接入时，向手机或聊天工具发送告警

NetAlertX 怎么安装和运行？

使用 Docker 启动 NetAlertX: docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest 或克隆源代码仓库: git clone https://github.com/netalertx/NetAlertX.git 进入项目目录并使用 Docker Compose 构建: cd NetAlertX && docker compose up --force-recreate --build

在哪里获取 NetAlertX？

源代码和安装说明在 GitHub 上：https://github.com/netalertx/NetAlertX