Progetto #18: Monitorare la rete con NetAlertX (ex PiAlert) su Raspberry Pi

In questo tutorial, vi mostreremo come installare e configurare NetAlertX (l’evoluzione del progetto PiAlert) sul vostro Raspberry Pi o qualsiasi altra board simile.

NetAlertX è uno strumento che si occupa di scansionare la nostra rete e notificarci ogni qual volta un nuovo dispositivo non riconosciuto si connetta, aiutandoci a mantenere protetta la nostra rete domestica o potenzialmente anche aziendale. Originariamente il progetto è nato con il nome “PiAlert“, poi abbandonato per il più generico “NetAlertX” ed è ora attivamente mantenuto da jokob-sk.

Utilizzando questo scanner, si può essere notificati immediatamente di eventuali modifiche alla rete, sia che si tratti di un nuovo dispositivo di rete o dell’apertura di una determinata porta.

Questo software dispone anche di un’interfaccia web che consente di visualizzare facilmente l’intera rete e le informazioni sui vari dispositivi, come le porte aperte su ciascuno di essi.

Il Raspberry Pi è un ottimo dispositivo su cui installare NetAlertX, in quanto è abbastanza economico per rimanere acceso 24 ore su 24, 7 giorni su 7, con una potenza più che sufficiente per questo tipo di monitoring.

NetAlertX fornisce un container docker per sistemi ARM a 32 bit e a 64 bit, in modo da poter utilizzare qualsiasi versione di Raspberry Pi OS si desideri.

Requisiti

• Un Raspberry Pi (suggerirei dal modello 2B in poi, quindi almeno 1 GB di RAM e 4 core);
• Scheda Micro-SD da almeno 8 GB;
• Connettività ethernet o Wi-Fi,

Questa guida spiegherà l’installazione di NetAlertX su un sistema basato su Debian, come ad esempio Raspberry Pi OS. Daremo per scontato che sia stato già installato Docker sul sistema, a tal proposito, consultate questa guida prima di procedere.

Installazione di NetAlertX sul Raspberry Pi

Nelle seguenti sezioni, ti mostreremo come configurare lo scanner di rete NetAlertX sul tuo Raspberry Pi.

Dal momento che stiamo usando Docker, questo processo è relativamente semplice, soprattutto se hai già installato Docker, come suggerito poc’anzi.

1. Prima di installare NetAlertX, dobbiamo assicurarci che il nostro Raspberry Pi sia aggiornato.

Come sempre, eseguiamo nel terminale i seguenti due comandi concatenati:

sudo apt update && sudo apt upgrade -y

2. Il nostro passo successivo è quello di creare una directory per memorizzare i file di Docker Compose per NetAlertX. Conserveremo tali file e i suoi dati nella cartella “/opt/stacks/netalertx“.

Possiamo creare questa directory usando il comando qui sotto. Specificheremo il parametro “-p” per garantire che le varie sottocartelle vengano create, qualora non esistessero già.

sudo mkdir -p /opt/stacks/netalertx

3. Dopo aver creato la directory, entriamoci dentro, tramite il comando cd:

cd /opt/stacks/netalertx

Creazione del file di Docker Compose per NetAlertX

4. Possiamo finalmente passare a scrivere il file di Docker Compose per NetAlertX sul Raspberry Pi. Questo file è come un insieme di istruzioni per Docker da seguire.

È possibile iniziare a scrivere questo file utilizzando l’editor di testo nano, tramite il comando qui sotto nel terminale.

sudo nano docker-compose.yaml

5. All’interno di questo file, andremo a copiare e modificare le seguenti righe, in particolare:

• “TZ” dovrà essere sostituito con una timezone valida. Nel nostro caso, utilizzeremo: “Europe/Rome“.

version: "3"
services:
  pialert:
    container_name: netalertx
    image: "jokobsk/netalertx:latest"
    network_mode: "host"
    restart: unless-stopped
    volumes:
      - ./data/config:/home/pi/netalertx/config
      - ./data/db:/home/pi/netalertx/db
      - ./data/logs:/home/pi/netalertx/front/log
    environment:
      - TZ=Europe/Rome
      - PORT=20211

6. Dopo aver copiato le righe qui sopra, salviamo e usciamo premendo CTRL+ X, seguito da Y e poi il tasto ENTER.

Avviare il container di NetAlertX

7. Una volta creato il file di Docker Compose, possiamo avviare lo scanner NetAlertX sul nostro Raspberry Pi.

Per farlo, useremo il comando docker con l’opzione “-d” per avviare il container in background.

docker compose up -d

sudo nano /opt/stacks/netalertx/data/config/netalertx.conf

SCAN_SUBNETS=['192.168.1.0/24 --interface=eth1']

SCAN_SUBNETS=['192.168.1.0/24 --interface=eth1','192.168.0.1/24 --interface=eth0']

hostname -I

http://<INDIRIZZO-IP>:20211

cd /opt/stacks/netalertx

docker compose pull

docker compose up -d