NetAlertX - Framework di Visibilità di Rete e Intelligence degli Asset

📷 Clicca per altri screenshot

Vai su https://netalertx.com/ per ancora più GIF e screenshot 📷.

NetAlertX è una piattaforma di visibilità di rete e intelligence degli asset per homelab, team IT, MSP e ambienti distribuiti. Fornisce visibilità centralizzata della rete e scoperta continua degli asset attraverso siti remoti, VLAN, sedi secondarie e reti segmentate da un'unica interfaccia.

NetAlertX ti offre una fonte di verità in tempo reale per i dispositivi connessi, aiuta a identificare shadow IT e hardware non autorizzato, supporta iniziative di conformità e automatizza i flussi operativi in ambienti distribuiti dei clienti.

Usa NetAlertX per individuare shadow IT, hardware non autorizzato, derive IPAM e altre modifiche rilevanti per i team di servizio. Con la sincronizzazione multi-sito, reportistica, flussi di lavoro e webhook, aiuta i MSP a rimanere al passo con i problemi senza l'overhead di un NMS o SIEM completo.

Sommario

• Avvio Rapido
• Funzionalità
• Documentazione
• Sicurezza e Privacy
• FAQ
• Suggerimenti per la Risoluzione dei Problemi
• Tutto il resto

Avvio Rapido

[!WARNING] ⚠️ Importante: Il docker-compose è cambiato di recente. Leggi attentamente la Guida alla migrazione per istruzioni dettagliate.

Avvia NetAlertX in pochi secondi con 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

Nota: La tua /local_data_dir deve contenere una cartella config e db.

Per distribuire un'istanza containerizzata direttamente dal repository sorgente, esegui la seguente sequenza BASH:

git clone https://github.com/netalertx/NetAlertX.git
cd NetAlertX
docker compose up --force-recreate --build
# Per personalizzare: modifica docker-compose.yaml ed esegui di nuovo l'ultimo comando

Hai bisogno di aiuto per configurarlo? Consulta la guida all'uso o la documentazione completa.

Per gli utenti di Home Assistant: Clicca qui per aggiungere NetAlertX

Per altri metodi di installazione, controlla la documentazione di installazione

|| Guida Docker || Release || Documentazione || Plugin || Sito web

Funzionalità

Scoperta e Intelligence degli Asset

Monitoraggio continuo per la scoperta di asset non autorizzati, cambiamenti di stato della connessione e deriva della gestione degli indirizzi IP (IPAM). I metodi di scoperta e scansione includono: arp-scan, Pi-hole - importazione DB, Pi-hole - importazione lease DHCP, importazione lease DHCP generici, importazione controller UNIFI, importazione router SNMP. Consulta la documentazione dei Plugin per l'elenco completo dei plugin disponibili.

Gateway di notifica

Invia notifiche a più di 80 servizi, tra cui Telegram tramite Apprise, o utilizza i publisher nativi Pushsafer, Pushover, o NTFY.

Integrazioni e Plugin

Inserisci i dati e le modifiche dei dispositivi in Home Assistant, leggi gli endpoint API, o usa i Webhook per impostare flussi di automazione personalizzati. Puoi anche creare i tuoi scanner con il sistema dei Plugin in appena 15 minuti.

Flussi di Lavoro

Il modulo dei flussi di lavoro automatizza la governance IT imponendo politiche di categorizzazione e pulizia dei dispositivi. Che tu debba assegnare i dispositivi appena scoperti a un Nodo di Rete specifico, raggruppare automaticamente i dispositivi di un dato fornitore, ripristinare un dispositivo se rilevato online o eliminare automaticamente i dispositivi, questo modulo fornisce la flessibilità necessaria per adattare le automazioni alle tue esigenze.

Monitoraggio MSP e Multi-Sito

NetAlertX consente il monitoraggio centralizzato attraverso siti remoti e ambienti isolati tramite Nodi di Sincronizzazione per VLAN e sedi secondarie, fornendo visibilità unificata degli asset attraverso più reti. Supporta dashboard stile NOC, esportazione di metriche Prometheus, automazione dei flussi di lavoro per la governance dei dispositivi e scoperta distribuita con allertamento centralizzato per operazioni di rete scalabili.

Documentazione

Esplora tutta la documentazione qui o naviga verso un'opzione di installazione specifica qui sotto.

Browser supportati: Chrome, Firefox

• [Installazione] Docker
• [Installazione] Home Assistant
• [Installazione] Bare metal
• [Installazione] App Unraid
• [Configurazione] Utilizzo e Configurazione
• [Sviluppo] Documentazione API
• [Sviluppo] Plugin Personalizzati

Sicurezza e Privacy

NetAlertX scansiona la tua rete locale e può memorizzare metadati sui dispositivi connessi. Per impostazione predefinita, tutti i dati vengono archiviati localmente. Nessuna informazione viene inviata a servizi esterni a meno che tu non configuri esplicitamente notifiche o integrazioni.

Conformità e Hardening:

• Eseguilo dietro un proxy inverso con autenticazione
• Usa firewall per limitare l'accesso all'interfaccia web
• Aggiorna regolarmente all'ultima versione per le patch di sicurezza
• Controllo degli accessi basato sui ruoli (RBAC) tramite Proxy Inverso: Integra con il tuo provider SSO/Identità esistente per un accesso sicuro alla dashboard.

Vedi Migliori Pratiche di Sicurezza per maggiori dettagli.

Progettato per MSP, NOC e Reti Distribuite

NetAlertX supporta il monitoraggio centralizzato attraverso VLAN, sedi secondarie, ambienti cliente, reti isolate e siti remoti.

Utilizzando Nodi di Sincronizzazione, i collettori distribuiti inviano in modo sicuro l'inventario dei dispositivi e i dati di visibilità della rete a un hub centrale, consentendo monitoraggio, allertamento e tracciamento degli asset unificati in tutte le sedi.

Questo fornisce a MSP e NOC una singola vista operativa di molte reti indipendenti, senza richiedere accesso diretto o infrastruttura di scansione centralizzata.

Le implementazioni comuni includono wallboard MSP, dashboard NOC, monitoraggio dell'inventario multi-sito e scoperta di uffici remoti.

FAQ

D: Come posso monitorare VLAN o sottoreti remote? R: Assicurati che il container abbia accesso di rete adeguato (ad es., usa --network host su Linux). Controlla anche che il metodo di scansione sia configurato correttamente nell'interfaccia.

D: Qual è la distribuzione consigliata per l'alta disponibilità? R: Raccomandiamo di distribuire tramite Docker con volumi persistenti per l'integrità del database e di eseguirlo dietro un proxy inverso per un accesso sicuro.

D: Questo invierà dati a internet? R: No. Tutte le scansioni e i dati rimangono locali, a meno che tu non configuri notifiche basate su cloud.

D: Posso usarlo senza Docker? R: Puoi installare l'applicazione direttamente sul tuo hardware seguendo la guida all'installazione bare metal.

D: Dove vengono archiviati i dati? R: Nelle cartelle /data/config e /data/db. Esegui regolarmente il backup di queste cartelle.

Suggerimenti per la Risoluzione dei Problemi

• Alcuni scanner (es. ARP) potrebbero non rilevare i dispositivi su sottoreti diverse. Vedi la guida alle reti remote per soluzioni alternative.
• Le reti solo Wi-Fi potrebbero richiedere scanner alternativi per un rilevamento accurato.
• Potrebbe essere necessaria la limitazione delle notifiche per reti di grandi dimensioni per evitare spam.
• Su alcuni sistemi, potrebbero essere necessari permessi elevati (come CAP_NET_RAW) per la scansione di basso livello.

Controlla le Issue su GitHub per i bug report più recenti e le soluzioni, e consulta la documentazione ufficiale.

Tutto il resto

📧 Ricevi notifiche sulle novità

Ricevi una notifica sulle nuove release, sulle nuove funzionalità disponibili e sulle modifiche che potrebbero rompere la compatibilità.

🔀 Altre App Alternative

• Fing - App scanner di rete per la sicurezza di internet (Commerciale, App per telefono, Hardware proprietario)
• NetBox - Lo standard di riferimento per la Network Source of Truth (NSoT) e IPAM.
• Zabbix o Nagios - Forte focus sul monitoraggio dell'infrastruttura.
• Domotz - Piattaforma commerciale di monitoraggio e gestione remota della rete rivolta a MSP, team IT e ambienti multi-sito.
• NetAlertX - La scelta snella e focalizzata sulla scoperta per intelligence degli asset in tempo reale e notifiche senza rumore.

💙 Donazioni

Grazie a tutti coloro che apprezzano questo strumento e donano.

Clicca per altre modalità di donazione

---

• Bitcoin: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
• Ethereum: 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

📧 Scrivimi a [email protected] se vuoi contattarmi o se dovessi aggiungere altre piattaforme di sponsorizzazione.

🏗 Contributori

Questo progetto non sarebbe nulla senza l'incredibile lavoro della comunità, con un ringraziamento speciale a:

pucherot/Pi.Alert (il creatore originale di PiAlert), leiweibau: Modalità scura (e molto altro), Macleykun (Aiuto con la pulizia del Dockerfile), vladaurosh per l'aiuto con il re-base su Alpine, Final-Hawk (Aiuto con NTFY, styling e altre correzioni), TeroRERO (Traduzioni in spagnolo), Data-Monkey, (Divisione del file python.py e altro), cvc90 (Traduzione in spagnolo e vari lavori sull'interfaccia) per citarne alcuni. Dai un'occhiata a tutti gli incredibili contributori.

🌍 Traduzioni

Orgogliosamente utilizziamo Weblate. Aiuta e suggerisci lingue nel portale online di Weblate.

Licenza

GPL 3.0 | Leggi di più qui | Fonte della GIF animata (Animazione di caricamento) | Fonte dei Font self-hosted

Tutti i nomi di prodotto, loghi e marchi sono di proprietà dei rispettivi proprietari. Tutti i nomi di aziende, prodotti e servizi utilizzati in questo sito sono solo a scopo di identificazione. L'uso di questi nomi, loghi e marchi non implica approvazione.