intercept

Supporta lo sviluppatore di questo progetto open-source

Piattaforma di Intelligence dei Segnali
Un'interfaccia web per strumenti radio definiti via software.

Caratteristiche

• Decodifica cercapersone - POCSAG/FLEX tramite rtl_fm + multimon-ng
• Sensori 433 MHz - Stazioni meteorologiche, TPMS, dispositivi IoT tramite rtl_433
• Analizzatore Sub-GHz - Cattura RF e decodifica protocolli per bande ISM 300-928 MHz tramite HackRF
• Tracciamento aereo - ADS-B tramite dump1090 con mappa in tempo reale e radar
• Tracciamento navale - Tracciamento navi AIS con monitoraggio soccorsi VHF DSC
• Messaggistica ACARS - Messaggi datalink aeronautici tramite acarsdec
• VDL2 - Decodifica datalink aereo VHF Data Link Mode 2 tramite dumpvdl2
• Posto d'ascolto - Scanner di frequenze a banda larga con monitoraggio audio in tempo reale
• Satelliti meteorologici - Decodifica immagini NOAA APT e Meteor LRPT tramite SatDump con schedulatore automatico
• WebSDR - Ascolto remoto HF/onda corta tramite rete KiwiSDR
• ISS SSTV - Ricezione immagini Slow-Scan TV dalla Stazione Spaziale Internazionale
• HF SSTV - SSTV terrestre su frequenze di onde corte (80m-10m, VHF, UHF)
• APRS - Rapporti di posizione e telemetria radioamatoriale tramite direwolf
• Tracciamento satellitare - Previsioni di passaggio con grafico polare e mappa della traccia a terra
• Contatori servizi - Lettura contatori elettrici, gas e acqua tramite rtlamr
• Cronologia ADS-B - Storico persistente degli aerei con dashboard di reportistica (Postgres opzionale)
• Scansione WiFi - Ricognizione in modalità monitor tramite aircrack-ng
• Scansione Bluetooth - Scoperta dispositivi e rilevamento tracker (con supporto Ubertooth)
• BT Localizza - Localizzazione dispositivi Bluetooth per SAR con mappatura segnale GPS e avvisi di prossimità
• WiFi Localizza - Localizza punti di accesso WiFi per BSSID con misuratore segnale in tempo reale, stima distanza e audio di prossimità
• GPS - Tracciamento posizione GPS in tempo reale con mappa live, velocità, altitudine e info satellitari
• TSCM - Controsorveglianza con confronto baseline RF e rilevamento minacce
• Meshtastic - Integrazione rete mesh LoRa
• Meteo spaziale - Dati solari e geomagnetici in tempo reale da NOAA SWPC, NASA SDO e HamQSL (nessun SDR richiesto)
• Stazioni spia - Stazioni numeriche e database reti HF diplomatiche
• Agenti remoti - SIGINT distribuito con nodi sensori remoti
• Modalità offline - Risorse incluse per implementazioni in ambienti air-gapped/sul campo
• Intelligence droni - Rilevamento UAV multi-vettore tramite ASTM F3411 Remote ID (WiFi/BLE), RTL-SDR 433/868 MHz RF e scansione HackRF 2.4/5.8 GHz con mappa contatti live e punteggio di rischio

Installazione / Debian / Ubuntu / macOS

Avvio rapido

git clone https://github.com/smittix/intercept.git
cd intercept
./setup.sh          # Menu interattivo (primo avvio avvia la procedura guidata)
sudo ./start.sh

Al primo avvio, setup.sh avvia una procedura guidata che rileva il tuo sistema operativo, ti permette di scegliere profili di installazione, configura l'ambiente Python e opzionalmente imposta le variabili d'ambiente e PostgreSQL.

Nei successivi avvii, apre un menu interattivo:

INTERCEPT Setup Menu
════════════════════════════════════════
  1) Installa / Aggiungi Moduli
  2) Controllo Salute Sistema
  3) Configurazione Database (Cronologia ADS-B)
  4) Aggiorna Strumenti
  5) Configuratore Ambiente
  6) Disinstalla / Pulizia
  7) Visualizza Stato
  0) Esci

Server Produzione vs Dev: start.sh rileva automaticamente gunicorn + gevent e avvia un server di produzione con greenlet cooperativi — gestisce più client SSE/WebSocket senza blocchi. Ricade sul server di sviluppo Flask se gunicorn non è installato. Per uno sviluppo locale rapido, puoi comunque usare direttamente sudo -E venv/bin/python intercept.py.

Profili di installazione

Scegli cosa installare durante la procedura guidata o tramite l'opzione menu 1:

Più profili possono essere combinati (es. inserire 1 3 per Core + Meteo).

Opzioni da riga di comando

./setup.sh --non-interactive          # Installazione completa non interattiva (stesso comportamento legacy)
./setup.sh --profile=core,weather     # Installa profili specifici
./setup.sh --health-check             # Controlla salute sistema ed esce
./setup.sh --postgres-setup           # Esegue configurazione PostgreSQL ed esce
./setup.sh --menu                     # Forza menu interattivo

Docker

git clone https://github.com/smittix/intercept.git
cd intercept
docker compose --profile basic up -d --build

Nota: Docker richiede la modalità privilegiata per l'accesso USB SDR. I dispositivi SDR sono passati tramite /dev/bus/usb.

Per build multi-architettura (amd64 + arm64 per Raspberry Pi), vedere build-multiarch.sh — gestisce cross-compilazione e push al registro in un unico passaggio.

Configurazione Ambiente

Usa il Configuratore Ambiente (opzione menu 5) per impostare interattivamente qualsiasi variabile INTERCEPT_*. Le impostazioni vengono salvate in un file .env che start.sh carica automaticamente all'avvio.

Puoi anche creare o modificare .env manualmente:

# .env (caricato automaticamente da start.sh)
INTERCEPT_PORT=5050
INTERCEPT_ADSB_AUTO_START=true
INTERCEPT_DEFAULT_LAT=51.5074
INTERCEPT_DEFAULT_LON=-0.1278

Cronologia ADS-B (Opzionale)

La funzione di cronologia ADS-B persiste i messaggi degli aerei in PostgreSQL per analisi a lungo termine.

Configurazione automatica (installazione locale):

./setup.sh --postgres-setup
# Oppure usa l'opzione menu 3: Configurazione Database

Questo installerà PostgreSQL se necessario, creerà il database/utente/tabelle e scriverà le impostazioni di connessione in .env.

Docker:

docker compose --profile history up -d

Imposta le seguenti variabili d'ambiente (in .env):

INTERCEPT_ADSB_HISTORY_ENABLED=true
INTERCEPT_ADSB_DB_HOST=adsb_db
INTERCEPT_ADSB_DB_PORT=5432
INTERCEPT_ADSB_DB_NAME=intercept_adsb
INTERCEPT_ADSB_DB_USER=intercept
INTERCEPT_ADSB_DB_PASSWORD=intercept

Per archiviare i dati Postgres su memoria esterna, imposta PGDATA_PATH (predefinito a ./pgdata):

PGDATA_PATH=/mnt/usbpi1/intercept/pgdata

Poi apri /adsb/history per la dashboard di reportistica.

Controllo Salute Sistema

Verifica che la tua installazione sia completa e funzionante:

./setup.sh --health-check
# Oppure usa l'opzione menu 2

Controlla gli strumenti installati, i dispositivi SDR, la disponibilità delle porte, i permessi, l'ambiente virtuale Python, la configurazione .env e la connettività PostgreSQL.

Apri l'Interfaccia

Dopo l'avvio, apri http://localhost:5050 nel tuo browser.

Credenziali predefinite: admin / admin — modificale in config.py (ADMIN_USERNAME / ADMIN_PASSWORD) prima di esporre l'app su una rete.

Requisiti Hardware

La maggior parte delle funzionalità funziona con un semplice dongle RTL-SDR (RTL2832U + R820T2).

Server Discord

Unisciti al nostro Discord

Documentazione

• Guida all'uso - Istruzioni dettagliate per ogni modalità
• Guida Hardware - Hardware SDR, installazione manuale e configurazione avanzata
• Risoluzione problemi - Problemi comuni e soluzioni
• Agenti distribuiti - Distribuzione nodi sensori remoti
• Webhook - Regole di allerta e integrazione webhook
• Sicurezza - Sicurezza di rete e buone pratiche

Disclaimer

Questo progetto è stato sviluppato utilizzando l'IA come partner di programmazione, combinando la direzione umana con l'implementazione assistita dall'IA. L'obiettivo: rendere la Radio Definita via Software più accessibile fornendo un'interfaccia pulita e unificata per gli strumenti SDR comuni.

Questo software è solo per scopi educativi e di test autorizzati.

• Usalo solo con la dovuta autorizzazione
• Intercettare comunicazioni senza consenso potrebbe essere illegale
• Sei responsabile della conformità con le leggi applicabili

Licenza

Licenza Apache 2.0 - vedi LICENSE

Autore

Creato da smittix - GitHub

Riconoscimenti

rtl-sdr | multimon-ng | rtl_433 | dump1090 | AIS-catcher | acarsdec | direwolf | rtlamr | dumpvdl2 | aircrack-ng | Leaflet.js | SatDump | Celestrak | Priyom.org