NetAlertX - 网络可见性与资产智能框架

📷 点击查看更多截图

|----------------------|----------------------|----------------------|

前往 [***] 查看更多 GIF 和截图 📷。

集中式网络可见性和持续资产发现。

监控设备、检测变更，并在分布式网络中保持感知。

NetAlertX 为网络基础设施提供集中式“单一真实来源”（NSoT）。维护每个连接设备的实时清单，识别影子IT和未授权硬件以保持***合规，并跨分布式站点自动化合规工作流。

NetAlertX 旨在弥合简单网络扫描与复杂SIEM工具之间的差距，提供可操作的洞察，且无需额外开销。

目录

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

快速开始

[!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、Pi-hole - 数据库导入、Pi-hole - DHCP租约导入、通用DHCP租约导入、UNIFI控制器导入、支持SNMP的路由器导入。查看插件文档获取完整可用插件列表。

通知网关

集成与插件

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

工作流

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

文档

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

支持的浏览器：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

常见问题

问：如何监控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 - 专注于基础设施监控。
• NetAlertX - 精简的、以发现为重点的实时资产智能和无干扰警报工具。

💙 ***

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

点击查看更多***方式

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

🏗 贡献者

没有社区的出色贡献，这个项目将无从谈起，特别感谢：

🌍 翻译

自豪地使用 Weblate。欢迎在 Weblate 在线门户 提供帮助并建议语言。

许可证

GPL 3.0 | 在此阅读更多 | 动画GIF（加载动画） 来源 | https://github.com/adobe-fonts/source-sans 来源

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