NetAlertX 中心化网络可见性与持续资产发现。监控设备、检测变更，在分布式网络中保持全面感知。https://t.co/V07dSreKEL

netalertx/NetAlertX

来源：https://github.com/netalertx/NetAlertX Docker 镜像大小 (https://hub.docker.com/r/jokobsk/netalertx) Docker 拉取次数 (https://hub.docker.com/r/jokobsk/netalertx) GitHub 版本发布 (https://github.com/netalertx/NetAlertX/releases) Discord (https://discord.gg/NczTUTWyRr) Home Assistant (https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub%2Fnetalertx%2FNetAlertX)

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

📷 点击查看更多截图 | | | | |–––––––––––|–––––––––––|–––––––––––| | | | | | | | |

前往 https://netalertx.com/ 获取更多动图和截图 📷。

NetAlertX 是一个面向家庭实验室、IT团队、MSP和分布式环境的网络可见性与资产智能平台。它通过单一界面，提供跨远程站点、VLAN、分支机构和分段网络的中心化网络可见性与持续资产发现。NetAlertX 为您提供连接设备的实时真实数据源，帮助识别影子IT和未授权硬件，支持合规性计划，并在分布式客户环境中自动化运营工作流。使用 NetAlertX 检测影子IT、未授权硬件、IPAM偏移以及服务团队关注的其他变更。凭借多站点同步、报告、工作流和Webhook，它帮助MSP在无需完整NMS或SIEM开销的情况下，领先于问题。

目录

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

快速开始

[!警告] ⚠️ 重要： docker-compose 配置近期已更改。请仔细阅读迁移指南 (https://docs.netalertx.com/MIGRATION/?h=migrat#12-migration-from-netalertx-v25524) 以获取详细说明。

使用 Docker 在数秒内启动 NetAlertX：

docker run -d \
  --network=host \
  --restart unless-stopped \
  --cap-add=NET_RAW \
  --cap-add=NET_ADMIN \
  --cap-add=NET_BIND_SERVICE \
  -v /本地数据目录:/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

注意：您的 /本地数据目录 应包含 config 和 db 文件夹。

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

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

需要配置帮助？请查看使用指南 (https://docs.netalertx.com/README) 或完整文档 (https://docs.netalertx.com/)。

对于 Home Assistant 用户：点击此处添加 NetAlertX (https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub%2Fnetalertx%2FNetAlertX)

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

|| Docker 指南 (https://docs.netalertx.com/DOCKER_INSTALLATION) || 版本发布 (https://github.com/netalertx/NetAlertX/releases) || 文档 (https://docs.netalertx.com/) || 插件 (https://docs.netalertx.com/PLUGINS_OVERVIEW) || 网站 (https://netalertx.com) ||

功能特性

发现与资产智能

持续监控未授权资产发现、连接状态变更和IP地址管理（IPAM）偏移。 发现与扫描方法包括：arp-scan、Pi-hole - 数据库导入、Pi-hole - DHCP租约导入、通用DHCP租约导入、UNIFI控制器导入、支持SNMP的路由器导入。 查看插件文档 (https://docs.netalertx.com/PLUGINS_OVERVIEW#readme) 获取完整可用插件列表。

通知网关

向80多种服务发送通知，包括通过 Apprise (https://hub.docker.com/r/caronc/apprise) 的 Telegram，或使用原生的 Pushsafer (https://www.pushsafer.com/)、Pushover (https://www.pushover.net/) 或 NTFY (https://ntfy.sh/) 发布者。

集成与插件

将您的数据和设备变更馈送到 Home Assistant (https://docs.netalertx.com/HOME_ASSISTANT)，读取 API 端点 (https://docs.netalertx.com/API)，或使用 Webhooks (https://docs.netalertx.com/WEBHOOK_N8N) 设置自定义自动化流程。您也可以通过插件系统 (https://docs.netalertx.com/PLUGINS_OVERVIEW#readme) 在短短15分钟内 (https://www.youtube.com/watch?v=cdbxlwiWhv8) 构建自己的扫描器。

工作流

工作流模块 (https://docs.netalertx.com/WORKFLOWS) 通过强制执行设备分类和清理策略来自动化IT治理。无论您需要将新发现的设备分配到特定网络节点、自动将来自特定供应商的设备分组、在设备检测到在线时取消归档，还是自动删除设备，此模块都提供了灵活性来根据您的需求定制自动化。

MSP与多站点监控

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

文档

在此处探索所有文档 (https://docs.netalertx.com/)，或导航至下方的特定安装选项。 支持的浏览器：Chrome, Firefox

• [安装] Docker
• [安装] Home Assistant
• [安装] 裸机部署
• [安装] Unraid 应用
• [设置] 使用与配置
• [开发] API 文档
• [开发] 自定义插件

安全与隐私

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

合规性与加固：

• 在具有身份验证的反向代理后运行它
• 使用防火墙限制对 Web UI 的访问
• 定期更新至最新版本以获取安全补丁
• 通过反向代理实现基于角色的访问控制（RBAC）：与您现有的SSO/身份提供商集成，以实现安全的仪表盘访问。详见安全最佳实践 (https://github.com/netalertx/NetAlertX/security)。

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

NetAlertX 支持跨VLAN、分支机构、客户环境、隔离网络和远程站点的集中监控。使用同步节点 (https://docs.netalertx.com/ADVISORY_MULTI_SITE_MONITORING)，分布式收集器安全地将设备清单和网络可见性数据发送回中心枢纽，实现跨所有位置的统一监控、告警和资产跟踪。这为MSP和NOC提供了对许多独立网络的单一运营视图，无需直接访问或集中扫描基础设施。常见部署包括MSP墙壁板、NOC仪表盘、多站点清单监控和远程办公室发现。

常见问题

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

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

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

问：我可以不使用Docker吗？ 答：您可以按照裸机安装指南 (https://docs.netalertx.com/HW_INSTALL) 直接在自己的硬件上安装应用程序。

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

故障排除提示

• 某些扫描器（如ARP）可能无法检测不同子网上的设备。查看远程网络指南 (https://docs.netalertx.com/REMOTE_NETWORKS) 了解解决方法。
• 仅Wi-Fi网络可能需要替代扫描器以实现准确检测。
• 大型网络可能需要通知节流以防止信息泛滥。
• 在某些系统上，底层扫描可能需要提升权限（如 CAP_NET_RAW）。 查看 GitHub Issues (https://github.com/netalertx/NetAlertX/issues) 获取最新的错误报告和解决方案，并查阅官方文档 (https://docs.netalertx.com/)。

其他

📧 获取更新通知

获取有关新版本、可使用的新功能以及破坏性更改的通知。

🔀 其他替代应用

• Fing (https://www.fing.com/) - 面向您网络安全的网络扫描应用（商业应用，手机应用，专有硬件）
• NetBox (https://netboxlabs.com/) - 网络真实数据源（NSoT）和IPAM的黄金标准。
• Zabbix (https://www.zabbix.com/) 或 Nagios (https://www.nagios.org/) - 高度关注基础设施监控。
• Domotz (https://www.domotz.com/) - 面向MSP、IT团队和多站点环境的商业网络监控和远程管理平台。
• NetAlertX (https://netalertx.com) - 面向实时资产智能和无噪音告警的精简、专注发现的解决方案。

💙 捐赠

感谢所有欣赏此工具并捐赠的人。 查看更多捐赠方式 | GitHub (https://github.com/sponsors/jokob-sk) | 请我喝杯咖啡 (https://www.buymeacoffee.com/jokobsk) | | — | — |

• 比特币: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
• 以太坊: 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

如果您想取得联系，或者我应该添加其他赞助平台，请通过 [email protected] 发送电子邮件给我。

🏗 贡献者

如果没有社区的卓越工作，这个项目将不复存在，特别感谢：

pucherot/Pi.Alert (https://github.com/pucherot/Pi.Alert)（PiAlert 的原始创建者），leiweibau (https://github.com/leiweibau/Pi.Alert)：深色模式（及更多），Macleykun (https://github.com/Macleykun)（协助清理Dockerfile），vladaurosh (https://github.com/vladaurosh)（协助重新基于Alpine），Final-Hawk (https://github.com/Final-Hawk)（协助NTFY、样式和其他修复），TeroRERO (https://github.com/terorero)（西班牙语翻译），Data-Monkey (https://github.com/Data-Monkey)（拆分python.py文件等），cvc90 (https://github.com/cvc90)（西班牙语翻译和各种UI工作）等。查看所有出色的贡献者 (https://github.com/netalertx/NetAlertX/graphs/contributors)。

🌍 翻译

自豪地使用 Weblate (https://hosted.weblate.org/projects/pialert/)。在 Weblate 的在线门户 (https://hosted.weblate.org/projects/pialert/core/) 中帮助并建议语言。

许可证

GPL 3.0 | 在此了解更多 | 动画GIF来源（加载动画）(https://commons.wikimedia.org/wiki/File:Loading_Animation.gif) | 自托管字体来源 (https://github.com/adobe-fonts/source-sans)

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