intercept

Unterstützen Sie den Entwickler dieses Open-Source-Projekts

Signalaufklärungsplattform
Eine webbasierte Schnittstelle für Software-defined-Radio-Werkzeuge.

Funktionen

• Pager-Dekodierung - POCSAG/FLEX über rtl_fm + multimon-ng
• 433-MHz-Sensoren - Wetterstationen, TPMS, IoT-Geräte über rtl_433
• Sub-GHz-Analysator - HF-Erfassung und Protokolldekodierung für 300–928 MHz ISM-Bänder über HackRF
• Flugzeugverfolgung - ADS-B über dump1090 mit Echtzeitkarte und Radar
• Schiffsverfolgung - AIS-Schiffsverfolgung mit VHF-DSC-Notfallüberwachung
• ACARS-Nachrichten - Flugzeug-Datenlink-Nachrichten über acarsdec
• VDL2 - VHF Data Link Mode 2 Flugzeug-Datenlink-Dekodierung über dumpvdl2
• Hörpost - Breitband-Frequenzscanner mit Echtzeit-Audioüberwachung
• Wettersatelliten - NOAA APT- und Meteor LRPT-Bilddekodierung über SatDump mit automatischer Planung
• WebSDR - Fernbedientes HF/Kurzwellenhören über KiwiSDR-Netzwerk
• ISS-SSTV - Slow-Scan-TV-Bildempfang von der Internationalen Raumstation
• HF-SSTV - Terrestrisches SSTV auf Kurzwellenfrequenzen (80m-10m, VHF, UHF)
• APRS - Amateurfunk-Paketfunk-Positionsmeldungen und Telemetrie über direwolf
• Satellitenverfolgung - Überflugvorhersage mit Polardiagramm und Bodenverlaufskarte
• Versorgungszähler - Strom-, Gas- und Wasserzählerablesung über rtlamr
• ADS-B-Verlauf - Dauerhafte Flugzeughistorie mit Berichts-Dashboard (Postgres optional)
• WiFi-Scanning - Monitor-Modus-Aufklärung über aircrack-ng
• Bluetooth-Scanning - Geräteerkennung und Tracker-Erfassung (mit Ubertooth-Unterstützung)
• BT-Ortung - SAR-Bluetooth-Geräteortung mit GPS-markierter Signalweg-Karte und Näherungswarnungen
• WiFi-Ortung - WiFi-Zugangspunkte nach BSSID orten mit Echtzeit-Signalmesser, Entfernungsschätzung und Näherungsaudio
• GPS - Echtzeit-GPS-Positionsverfolgung mit Live-Karte, Geschwindigkeit, Höhe und Satelliteninfo
• TSCM - Abwehrüberwachung mit HF-Basislinienvergleich und Bedrohungserkennung
• Meshtastic - LoRa-Mesh-Netzwerk-Integration
• Weltraumwetter - Echtzeit-Solar- und Geomagnetdaten von NOAA SWPC, NASA SDO und HamQSL (kein SDR erforderlich)
• Spionagestationen - Zahlensender und diplomatische HF-Netzwerk-Datenbank
• Remote-Agenten - Verteilte SIGINT mit entfernten Sensorknoten
• Offline-Modus - Gebündelte Ressourcen für abgeschottete/Feld-Einsätze
• Drohnenaufklärung - Mehrvektorige UAV-Erkennung über ASTM F3411 Remote ID (WiFi/BLE), RTL-SDR 433/868 MHz HF und HackRF 2.4/5.8 GHz Scanning mit Live-Kontaktkarte und Risikobewertung

Installation / Debian / Ubuntu / macOS

Schnellstart

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

Beim ersten Start startet setup.sh einen geführten Assistenten, der Ihr Betriebssystem erkennt, Ihnen die Auswahl von Installationsprofilen ermöglicht, die Python-Umgebung einrichtet und optional Umgebungsvariablen und PostgreSQL konfiguriert.

Bei späteren Ausführungen öffnet sich ein interaktives Menü:

INTERCEPT Setup-Menü
════════════════════════════════════════
  1) Module installieren / hinzufügen
  2) System-Gesundheitscheck
  3) Datenbank-Setup (ADS-B-Verlauf)
  4) Werkzeuge aktualisieren
  5) Umgebungskonfigurator
  6) Deinstallieren / Bereinigen
  7) Status anzeigen
  0) Beenden

Produktions- vs. Entwicklungs-Server: start.sh erkennt automatisch gunicorn + gevent und startet einen Produktionsserver mit kooperativen Greenlets – verwaltet mehrere SSE/WebSocket-Clients ohne Blockierung. Fallback auf Flask-Entwicklungsserver, falls gunicorn nicht installiert ist. Für schnelle lokale Entwicklung können Sie weiterhin sudo -E venv/bin/python intercept.py direkt verwenden.

Installationsprofile

Wählen Sie, was während des Assistenten oder über Menüoption 1 installiert werden soll:

Mehrere Profile können kombiniert werden (z.B. 1 3 für Kern + Wetter).

CLI-Flags

./setup.sh --non-interactive          # Headless-Vollinstallation (entspricht dem Legacy-Verhalten)
./setup.sh --profile=core,weather     # Bestimmte Profile installieren
./setup.sh --health-check             # Systemzustand prüfen und beenden
./setup.sh --postgres-setup           # PostgreSQL-Setup ausführen und beenden
./setup.sh --menu                     # Interaktives Menü erzwingen

Docker

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

Hinweis: Docker benötigt privilegierten Modus für USB-SDR-Zugriff. SDR-Geräte werden über /dev/bus/usb durchgereicht.

Für Multi-Architektur-Builds (amd64 + arm64 für Raspberry Pi) siehe build-multiarch.sh – es erledigt Cross-Kompilierung und Registry-Push in einem Schritt.

Umgebungskonfiguration

Verwenden Sie den Umgebungskonfigurator (Menüoption 5), um interaktiv beliebige INTERCEPT_*-Variablen zu setzen. Die Einstellungen werden in einer .env-Datei gespeichert, die start.sh beim Start automatisch lädt.

Sie können .env auch manuell erstellen oder bearbeiten:

# .env (auto-loaded by start.sh)
INTERCEPT_PORT=5050
INTERCEPT_ADSB_AUTO_START=true
INTERCEPT_DEFAULT_LAT=51.5074
INTERCEPT_DEFAULT_LON=-0.1278

ADS-B-Verlauf (Optional)

Die ADS-B-Verlaufsfunktion speichert Flugzeugmeldungen für Langzeitanalysen in PostgreSQL.

Automatisiertes Setup (lokale Installation):

./setup.sh --postgres-setup
# Oder verwenden Sie Menüoption 3: Datenbank-Setup

Dies installiert PostgreSQL bei Bedarf, erstellt die Datenbank/Benutzer/Tabellen und schreibt die Verbindungseinstellungen in .env.

Docker:

docker compose --profile history up -d

Setzen Sie die folgenden Umgebungsvariablen (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

Um Postgres-Daten auf externem Speicher abzulegen, setzen Sie PGDATA_PATH (Standard: ./pgdata):

PGDATA_PATH=/mnt/usbpi1/intercept/pgdata

Öffnen Sie dann /adsb/history für das Berichts-Dashboard.

System-Gesundheitscheck

Überprüfen Sie, ob Ihre Installation vollständig und funktionsfähig ist:

./setup.sh --health-check
# Oder verwenden Sie Menüoption 2

Prüft installierte Werkzeuge, SDR-Geräte, Portverfügbarkeit, Berechtigungen, Python-venv, .env-Konfiguration und PostgreSQL-Konnektivität.

Öffnen Sie die Benutzeroberfläche

Nach dem Start öffnen Sie http://localhost:5050 in Ihrem Browser.

Standard-Anmeldedaten: admin / admin – ändern Sie diese in config.py (ADMIN_USERNAME / ADMIN_PASSWORD), bevor Sie die App in einem Netzwerk verfügbar machen.

Hardware-Anforderungen

Die meisten Funktionen funktionieren mit einem einfachen RTL-SDR-Dongle (RTL2832U + R820T2).

Discord-Server

Tritt unserem Discord bei

Dokumentation

• Nutzungsanleitung - Detaillierte Anweisungen für jeden Modus
• Hardware-Leitfaden - SDR-Hardware, manuelle Installation und erweiterte Einrichtung
• Fehlerbehebung - Häufige Probleme und Lösungen
• Verteilte Agenten - Einsatz entfernter Sensorknoten
• Webhooks - Alarmregeln und Webhook-Integration
• Sicherheit - Netzwerksicherheit und bewährte Verfahren

Haftungsausschluss

Dieses Projekt wurde unter Einsatz von KI als Codierungspartner entwickelt, wobei menschliche Leitung mit KI-gestützter Implementierung kombiniert wurde. Das Ziel: Software Defined Radio zugänglicher machen, indem eine saubere, einheitliche Schnittstelle für gängige SDR-Werkzeuge bereitgestellt wird.

Diese Software dient ausschließlich zu Bildungs- und autorisierten Testzwecken.

• Nur mit entsprechender Autorisierung verwenden
• Das Abfangen von Kommunikation ohne Einwilligung kann illegal sein
• Sie sind für die Einhaltung geltender Gesetze verantwortlich

Lizenz

Apache-2.0-Lizenz – siehe LICENSE

Autor

Erstellt von smittix – GitHub

Danksagungen

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