ghcr.io/jokob-sk/netalertx:25.10

NetAlertX - 网络可见性与资产情报框架

📷 点击查看更多截图

访问 [***] 获取更多GIF动图和截图 📷。

为家庭实验室、IT团队、MSP（托管服务提供商）和分布式环境提供集中式网络可见性和持续资产发现。

通过单一界面监控设备、检测变更，并在远程站点、VLAN、分支机构和分段网络中保持可见性。

NetAlertX 为网络基础设施提供集中式"事实来源"（NSoT）。维护连接设备的实时清单，识别影子IT和未授权硬件，支持合规计划，并在分布式客户环境中实现运营工作流自动化。

旨在弥合简单网络扫描器与复杂SIEM平台之间的差距，NetAlertX提供可操作的网络情报和集中式监控，且无额外运营开销。

目录

• 快速开始
• 功能特性
• 文档
• 安全与隐私
• 常见问题
• 故障排除提示
• 其他信息

快速开始

[!WARNING] ⚠️ 重要提示： docker-compose 最近已更新。请仔细阅读迁移指南获取详细说明。

使用Docker在几秒钟内启动NetAlertX：

docker run -d \
--network=host \
--restart unless-stopped \
-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

注意：您的 /local_data_dir 应包含 config 和 db 文件夹。

要直接从源代码仓库部署容器化实例，请执行以下BASH命令序列：

git clone https://github.com/netalertx/NetAlertX.git
cd NetAlertX
docker compose up --force-recreate --build
# 如需自定义：编辑 docker-compose.yaml 并重新运行上述最后一条命令

需要配置帮助？请查看使用指南或完整文档。

Home Assistant用户：https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons

其他安装方法，请查看安装文档

---

---

功能特性

发现与资产情报

持续监控未授权资产发现、连接状态变更和IP地址管理（IPAM）漂移。发现与扫描方法包括：arp-scan（ARP扫描）、Pi-hole - DB导入、Pi-hole - DHCP租约导入、通用DHCP租约导入、UNIFI控制器导入、SNMP启用的路由器导入。完整插件列表请查看插件文档。

通知网关

集成与插件

借助插件系统，仅需15分钟即可构建自己的扫描器。

工作流

工作流模块通过实施设备分类和清理策略实现IT治理自动化。无论您需要将新发现的设备分配到特定网络节点、自动将特定供应商的设备分组、在检测到设备在线时取消归档，还是自动删除设备，该模块都能灵活定制满足您需求的自动化流程。

MSP与多站点监控

NetAlertX通过VLAN和分支机构的同步节点（Sync Nodes）实现跨远程站点和隔离环境的集中监控，提供跨多个网络的统一资产可见性。它支持NOC（网络运营中心）风格的看板仪表板、Prometheus指标导出、设备治理工作流自动化，以及用于可扩展网络运营的分布式发现与集中告警。

文档

在此处浏览所有文档或导航至以下特定安装选项。

支持的浏览器：Chrome、Firefox

• [[安装] Docker]([***]
• https://github.com/alexbelgium/hassio-addons/tree/master/netalertx
• [[安装] 裸机]([***]
• [[安装] Unraid应用]([***]
• [[设置] 使用与配置]([***]
• [[开发] API文档]([***]
• [[开发] 自定义插件]([***]

安全与隐私

NetAlertX扫描本地网络并可存储连接设备的元数据。默认情况下，所有数据均本地存储。除非您明确配置通知或集成，否则不会向外部服务发送任何信息。

合规性与强化：

• 在带有身份验证的反向代理后运行
• 使用防火墙限制对Web UI的访问
• 定期更新至最新版本以获取安全补丁
• 通过反向代理实现基于角色的访问控制（RBAC）：与现有SSO/身份提供商集成，实现安全的仪表板访问。

更多详情请参见https://github.com/netalertx/NetAlertX/security%E3%80%82

为MSP、NOC和分布式网络设计

NetAlertX支持跨VLAN、分支机构、客户环境、隔离网络和远程站点的集中监控。

通过同步节点，分布式收集器安全地将设备清单和网络可见性数据发送回中央 hub，实现跨所有位置的统一监控、告警和资产跟踪。

这为MSP和NOC提供了多个独立网络的单一操作视图，无需直接访问或集中扫描基础设施。

常见部署包括MSP看板、NOC仪表板、多站点清单监控和远程办公室发现。

常见问题

问：如何监控VLAN或远程子网？ 答：确保容器具有适当的网络访问权限（例如，在Linux上使用 --network host）。同时检查UI中扫描方法是否正确配置。

问：高可用性的推荐部署方式是什么？ 答：建议通过Docker部署，使用持久卷挂载确保数据库完整性，并在反向代理后运行以实现安全访问。

问：是否会向互联网发送任何数据？ 答：不会。所有扫描和数据均保留在本地，除非您设置了基于云的通知。

问：可以不使用Docker运行吗？ 答：您可以按照裸机安装指南将应用程序直接安装在自己的硬件上。

问：数据存储在哪里？ 答：存储在 /data/config 和 /data/db 文件夹中。请定期备份这些文件夹。

故障排除提示

• 某些扫描器（如ARP）可能无法检测不同子网的设备。解决方法请参见远程网络指南。
• 纯Wi-Fi网络可能需要替代扫描器以实现准确检测。
• 大型网络可能需要通知限流以防止垃圾信息。
• 某些系统可能需要提升权限（如 CAP_NET_RAW）以进行底层扫描。

有关最新错误报告和解决方案，请查看https://github.com/netalertx/NetAlertX/issues%E5%B9%B6%E5%8F%82%E8%80%83%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E3%80%82

其他信息

📧 获取最新动态通知

获取新版本通知、新增功能信息以及重大变更提醒。

🔀 其他替代应用

• Fing - 用于互联网安全的网络扫描应用（商业版、手机应用、专有硬件）
• NetBox - 网络事实来源（NSoT）和IPAM的行业标准。
• Zabbix 或 Nagios - 专注于基础设施监控。
• Domotz - 面向MSP、IT团队和多站点环境的商业网络监控和远程管理平台。
• NetAlertX - 专注于实时资产情报和无干扰告警的精简型发现工具。

💙 ***

感谢所有欣赏此工具并提供***的用户。

点击查看更多***方式

📧 如需联系或建议添加其他赞助平台，请发送邮件至 ***。

🏗 贡献者

本项目离不开社区的出色贡献，特别感谢：

🌍 翻译

自豪地使用https://hosted.weblate.org/projects/pialert/%E3%80%82%E6%AC%A2%E8%BF%8E%E5%9C%A8https://hosted.weblate.org/projects/pialert/core/%E6%8F%90%E4%BE%9B%E7%BF%BB%E8%AF%91%E5%BB%BA%E8%AE%AE%E6%88%96%E6%96%B0%E5%A2%9E%E8%AF%AD%E8%A8%80%E3%80%82

许可证

GPL 3.0 | 详见此处 | 动画GIF（加载动画）来源 | https://github.com/adobe-fonts/source-sans%E6%9D%A5%E6%BA%90

所有产品名称、徽标和品牌均为其各自所有者的财产。本网站中使用的所有公司、产品和服务名称仅用于识别目的。使用这些名称、徽标和品牌并不意味着认可。