intercept v2.33.0

Supporta lo sviluppatore di questo progetto open-source

Piattaforma di Signal Intelligence
Un'interfaccia web per strumenti di radio definita via software.

---

Funzionalità

• Decodifica Pager - POCSAG/FLEX tramite rtl_fm + multimon-ng
• Sensori a 433MHz - Stazioni meteo, TPMS, dispositivi IoT tramite rtl_433
• Analizzatore Sub-GHz - Cattura RF e decodifica di protocolli per bande ISM da 300-928 MHz tramite HackRF
• Tracciamento Aeromobili - ADS-B tramite dump1090 con mappa in tempo reale e radar
• Tracciamento Navi - Tracciamento navi AIS con monitoraggio delle chiamate di soccorso VHF DSC
• Messaggistica ACARS - Messaggi datalink degli aeromobili tramite acarsdec
• VDL2 - Decodifica datalink aeromobili VHF Data Link Mode 2 tramite dumpvdl2
• Listening Post - Scanner di frequenze a banda larga con monitoraggio audio in tempo reale
• Satelliti Meteo - Decodifica immagini NOAA APT e Meteor LRPT tramite SatDump con pianificazione automatica
• WebSDR - Ascolto remoto HF/onde corte tramite la rete KiwiSDR
• ISS SSTV - Ricezione immagini slow-scan TV dalla Stazione Spaziale Internazionale
• HF SSTV - SSTV terrestre su frequenze in onde corte (80m-10m, VHF, UHF)
• APRS - Rapporti di posizione e telemetria di radioamatori packet radio tramite direwolf
• Tracciamento Satelliti - Previsione dei passaggi con grafico polare e mappa della traccia a terra
• Contatori di Utilità - Lettura di contatori elettrici, gas e acqua tramite rtlamr
• Cronologia ADS-B - Cronologia persistente degli aeromobili con dashboard di reportistica (Postgres opzionale)
• Scansione WiFi - Ricognizione in modalità monitor tramite aircrack-ng
• Scansione Bluetooth - Rilevamento dispositivi e rilevamento tracker (con supporto Ubertooth)
• BT Locate - Localizzazione di dispositivi Bluetooth SAR con mappatura della traccia del segnale etichettata GPS e avvisi di prossimità
• WiFi Locate - Localizzazione di punti di accesso WiFi tramite BSSID con misuratore di segnale in tempo reale, stima della distanza e audio di prossimità
• GPS - Tracciamento della posizione GPS in tempo reale con mappa live, velocità, altitudine e informazioni sui satelliti
• TSCM - Controsorveglianza con confronto della baseline RF e rilevamento delle minacce
• Meshtastic - Integrazione della rete mesh LoRa
• Meteo Spaziale - Dati solari e geomagnetici in tempo reale da NOAA SWPC, NASA SDO e HamQSL (nessun SDR richiesto)
• Spy Stations - Database di number stations e reti HF diplomatiche
• Agenti Remoti - SIGINT distribuito con nodi sensore remoti
• Modalità Offline - Risorse incluse per distribuzioni in ambienti air-gapped/sul campo
• Drone Intelligence - Rilevamento UAV multi-vettore tramite ASTM F3411 Remote ID (WiFi/BLE), RF RTL-SDR 433/868 MHz e scansione HackRF 2.4/5.8 GHz con mappa dei contatti live e punteggio di rischio

---

Installazione / Debian / Ubuntu / macOS

Avvio Rapido

git clone https://github.com/smittix/intercept.git
cd intercept
./setup.sh          # Interactive menu (first run launches setup wizard)
sudo ./start.sh

Al primo avvio, setup.sh lancia una procedura guidata che rileva il tuo sistema operativo, ti consente di scegliere i profili di installazione, configura l'ambiente Python e, facoltativamente, configura le variabili d'ambiente e PostgreSQL.

Nelle esecuzioni successive, apre un menu interattivo:

INTERCEPT Setup Menu
════════════════════════════════════════
  1) Install / Add Modules
  2) System Health Check
  3) Database Setup (ADS-B History)
  4) Update Tools
  5) Environment Configurator
  6) Uninstall / Cleanup
  7) View Status
  0) Exit

Server di produzione vs dev: start.sh rileva automaticamente gunicorn + gevent ed esegue un server di produzione con greenlet cooperativi — gestisce più client SSE/WebSocket senza bloccarsi. Torna al 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 di menu 1:

#	Profilo	Strumenti
1	Core SIGINT	rtl_sdr, multimon-ng, rtl_433, dump1090, acarsdec, dumpvdl2, ffmpeg, gpsd
2	Marittimo e Radio	AIS-catcher, direwolf
3	Meteo e Spazio	SatDump, radiosonde_auto_rx
4	Sicurezza RF	aircrack-ng, HackRF, BlueZ, hcxtools, Ubertooth, SoapySDR
5	SIGINT completo	Tutti i precedenti
6	Personalizzato	Checklist per singolo strumento

È possibile combinare più profili (ad es. inserisci 1 3 per Core + Meteo).

Flag CLI

./setup.sh --non-interactive          # Headless full install (same as legacy behavior)
./setup.sh --profile=core,weather     # Install specific profiles
./setup.sh --health-check             # Check system health and exit
./setup.sh --postgres-setup           # Run PostgreSQL setup and exit
./setup.sh --menu                     # Force interactive menu

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 agli SDR USB. I dispositivi SDR vengono passati tramite /dev/bus/usb.

I tuoi dati: impostazioni, utenti, regole di allerta, watchlist e messaggi decodificati risiedono in ./instance sull'host, così sopravvivono a --build. Eseguendo l'aggiornamento da un file compose privo di quel mount? Copia i vecchi dati prima di ricostruire: docker cp intercept:/app/instance ./instance.

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

Configurazione dell'ambiente

Usa l'Environment Configurator (opzione 5 del menu) per impostare in modo interattivo 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 (auto-loaded by 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 funzionalità di cronologia ADS-B salva i messaggi degli aeromobili in PostgreSQL per l'analisi a lungo termine.