NetAlertX - Framework de visibilité réseau & d'intelligence d'actifs

📷 Cliquez pour plus de captures d'écran

Rendez-vous sur https://netalertx.com/ pour encore plus de gifs et captures d'écran 📷.

NetAlertX est une plateforme de visibilité réseau et d'intelligence d'actifs destinée aux laboratoires domotiques, équipes IT, MSP et environnements distribués. Elle offre une visibilité centralisée du réseau et une découverte continue des actifs sur des sites distants, VLANs, succursales et réseaux segmentés depuis une interface unique.

NetAlertX vous donne une source de vérité en temps réel pour les appareils connectés, vous aide à identifier les shadow IT et le matériel non autorisé, soutient les initiatives de conformité et automatise les flux de travail opérationnels dans des environnements clients distribués.

Utilisez NetAlertX pour repérer le shadow IT, le matériel non autorisé, les dérives IPAM et autres changements importants pour les équipes de service. Avec la synchronisation multi-sites, les rapports, les flux de travail et les webhooks, il aide les MSP à rester en avance sur les problèmes sans les frais généraux d'un NMS ou d'un SIEM complet.

Table des matières

• Démarrage rapide
• Fonctionnalités
• Documentation
• Sécurité et confidentialité
• FAQ
• Conseils de dépannage
• Tout le reste

Démarrage rapide

[!WARNING] ⚠️ Important : Le docker-compose a récemment changé. Lisez attentivement le guide de migration pour des instructions détaillées.

Lancez NetAlertX en quelques secondes avec Docker :

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

Remarque : Votre /local_data_dir doit contenir un dossier config et un dossier db.

Pour déployer une instance conteneurisée directement depuis le dépôt source, exécutez la séquence BASH suivante :

git clone https://github.com/netalertx/NetAlertX.git
cd NetAlertX
docker compose up --force-recreate --build
# Pour personnaliser : modifiez docker-compose.yaml et relancez cette dernière commande

Besoin d'aide pour le configurer ? Consultez le guide d'utilisation ou la documentation complète.

Pour les utilisateurs de Home Assistant : Cliquez ici pour ajouter NetAlertX

Pour d'autres méthodes d'installation, consultez les docs d'installation

|| Guide Docker || Versions || Docs || Plugins || Site Web

Fonctionnalités

Découverte et intelligence d'actifs

Surveillance continue pour la découverte d'actifs non autorisés, les changements d'état de connexion et les dérives de gestion des adresses IP (IPAM). Les méthodes de découverte et de scan incluent : arp-scan, Pi-hole - DB import, Pi-hole - DHCP leases import, Generic DHCP leases import, UNIFI controller import, SNMP-enabled router import. Consultez les docs Plugins pour une liste complète des plugins disponibles.

Passerelles de notification

Envoyez des notifications vers plus de 80 services, y compris Telegram via Apprise, ou utilisez les éditeurs natifs Pushsafer, Pushover, ou NTFY.

Intégrations et plugins

Alimentez vos données et changements d'appareils dans Home Assistant, lisez les points d'API, ou utilisez les Webhooks pour configurer des flux d'automatisation personnalisés. Vous pouvez également construire vos propres scanners avec le système de plugins en seulement 15 minutes.

Flux de travail

Le module de flux de travail automatise la gouvernance IT en appliquant des politiques de catégorisation et de nettoyage des appareils. Que vous ayez besoin d'affecter des appareils nouvellement découverts à un nœud de réseau spécifique, de regrouper automatiquement les appareils d'un fournisseur donné, de désarchiver un appareil s'il est détecté en ligne, ou de supprimer automatiquement des appareils, ce module offre la flexibilité nécessaire pour adapter les automatisations à vos besoins.

Surveillance MSP et multi-sites

NetAlertX permet une surveillance centralisée sur des sites distants et des environnements isolés via des nœuds de synchronisation pour VLANs et succursales, offrant une visibilité unifiée des actifs sur plusieurs réseaux. Il prend en charge les tableaux de bord de type NOC, l'export de métriques Prometheus, l'automatisation des flux de travail pour la gouvernance des appareils, et la découverte distribuée avec alertes centralisées pour des opérations réseau évolutives.

Documentation

Explorez toute la documentation ici ou naviguez vers une option d'installation spécifique ci-dessous.

Navigateurs pris en charge : Chrome, Firefox

• [Installation] Docker
• [Installation] Home Assistant
• [Installation] Installation physique
• [Installation] Application Unraid
• [Configuration] Utilisation et configuration
• [Développement] Documentation API
• [Développement] Plugins personnalisés

Sécurité et confidentialité

NetAlertX scanne votre réseau local et peut stocker des métadonnées sur les appareils connectés. Par défaut, toutes les données sont stockées localement. Aucune information n'est envoyée à des services externes, sauf si vous configurez explicitement des notifications ou des intégrations.

Conformité et durcissement :

• Exécutez-le derrière un proxy inverse avec authentification
• Utilisez des pare-feux pour restreindre l'accès à l'interface Web
• Mettez régulièrement à jour vers la dernière version pour les correctifs de sécurité
• Contrôle d'accès basé sur les rôles (RBAC) via proxy inverse : Intégrez-le à votre fournisseur SSO/Identité existant pour un accès sécurisé au tableau de bord.

Voir les Bonnes pratiques de sécurité pour plus de détails.

Conçu pour les MSP, NOC et réseaux distribués

NetAlertX prend en charge la surveillance centralisée à travers les VLANs, les succursales, les environnements clients, les réseaux isolés et les sites distants.

En utilisant les Nœuds de synchronisation, des collecteurs distribués envoient en toute sécurité les inventaires d'appareils et les données de visibilité réseau vers un hub central, permettant une surveillance, une alerte et un suivi des actifs unifiés sur tous les sites.

Cela offre aux MSP et aux NOC une vue opérationnelle unique de nombreux réseaux indépendants, sans nécessiter d'accès direct ni d'infrastructure de scan centralisée.

Les déploiements courants incluent les tableaux de bord MSP, les écrans NOC, la surveillance d'inventaire multi-sites et la découverte de bureaux distants.

FAQ

Q : Comment surveiller des VLANs ou sous-réseaux distants ? R : Assurez-vous que le conteneur dispose d'un accès réseau approprié (par exemple, utilisez --network host sur Linux). Vérifiez également que votre méthode de scan est correctement configurée dans l'interface.

Q : Quel déploiement est recommandé pour la haute disponibilité ? R : Nous recommandons un déploiement via Docker avec des montages de volumes persistants pour l'intégrité de la base de données et derrière un proxy inverse pour un accès sécurisé.

Q : Cet outil enverra-t-il des données sur Internet ? R : Non. Tous les scans et données restent locaux, sauf si vous configurez des notifications basées sur le cloud.

Q : Puis-je utiliser cet outil sans Docker ? R : Vous pouvez installer l'application directement sur votre propre matériel en suivant le guide d'installation physique.

Q : Où les données sont-elles stockées ? R : Dans les dossiers /data/config et /data/db. Sauvegardez ces dossiers régulièrement.

Conseils de dépannage

• Certains scanners (ex. ARP) peuvent ne pas détecter les appareils sur différents sous-réseaux. Consultez le guide des réseaux distants pour des solutions de contournement.
• Les réseaux Wi-Fi uniquement peuvent nécessiter des scanners alternatifs pour une détection précise.
• Une limitation des notifications peut être nécessaire pour les grands réseaux afin d'éviter le spam.
• Sur certains systèmes, des permissions élevées (comme CAP_NET_RAW) peuvent être nécessaires pour les scans de bas niveau.

Consultez les GitHub Issues pour les derniers rapports de bugs et solutions, et consultez la documentation officielle.

Tout le reste

📧 Soyez informé des nouveautés

Soyez informé des nouvelles versions, des nouvelles fonctionnalités utilisables et des changements importants.

🔀 Autres applications alternatives

• Fing - Application de scan réseau pour la sécurité de votre Internet (Commercial, Application mobile, Matériel propriétaire)
• NetBox - La référence pour la source de vérité réseau (NSoT) et l'IPAM.
• Zabbix ou Nagios - Forte focalisation sur la surveillance d'infrastructure.
• Domotz - Plateforme commerciale de surveillance réseau et de gestion à distance destinée aux MSP, équipes IT et environnements multi-sites.
• NetAlertX - Le choix simplifié et axé sur la découverte pour une intelligence d'actifs en temps réel et des alertes sans bruit.

💙 Dons

Merci à tous ceux qui apprécient cet outil et font un don.

Cliquez pour plus de façons de donner

---

• Bitcoin : 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
• Ethereum : 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

📧 Envoyez-moi un email à [email protected] si vous voulez me contacter ou si je dois ajouter d'autres plateformes de parrainage.

🏗 Contributeurs

Ce projet ne serait rien sans le travail incroyable de la communauté, avec des remerciements particuliers à :

pucherot/Pi.Alert (le créateur original de PiAlert), leiweibau : Mode sombre (et bien plus), Macleykun (Aide pour le nettoyage du Dockerfile), vladaurosh pour l'aide au rebasage Alpine, Final-Hawk (Aide pour NTFY, le style et d'autres corrections), TeroRERO (Traductions espagnoles), Data-Monkey (Division du fichier python.py et plus), cvc90 (Traduction espagnole et divers travaux sur l'interface) pour n'en citer que quelques-uns. Consultez tous les incroyables contributeurs.

🌍 Traductions

Fièrement utilisant Weblate. Aidez-nous et suggérez des langues dans le portail en ligne de Weblate.

License

GPL 3.0 | Lire la suite ici | Source du GIF animé (Animation de chargement) | Source des Polices auto-hébergées

Tous les noms de produits, logos et marques sont la propriété de leurs propriétaires respectifs. Tous les noms d'entreprise, de produit et de service utilisés sur ce site web le sont à des fins d'identification uniquement. L'utilisation de ces noms, logos et marques n'implique aucun parrainage.