intercept

Apoya al desarrollador de este proyecto de código abierto

Plataforma de Inteligencia de Señales
Una interfaz basada en web para herramientas de radio definida por software.

---

Características

• Decodificación de buscapersonas - POCSAG/FLEX mediante rtl_fm + multimon-ng
• Sensores de 433MHz - Estaciones meteorológicas, TPMS, dispositivos IoT mediante rtl_433
• Analizador Sub-GHz - Captura de RF y decodificación de protocolos para bandas ISM de 300-928 MHz mediante HackRF
• Seguimiento de aeronaves - ADS-B mediante dump1090 con mapa en tiempo real y radar
• Seguimiento de embarcaciones - Seguimiento de buques AIS con monitoreo de socorro DSC en VHF
• Mensajería ACARS - Mensajes de enlace de datos de aeronaves mediante acarsdec
• VDL2 - Decodificación de enlace de datos de aeronaves VHF Data Link Mode 2 mediante dumpvdl2
• Puesto de escucha - Escáner de frecuencias de banda ancha con monitoreo de audio en tiempo real
• Satélites meteorológicos - Decodificación de imágenes NOAA APT y Meteor LRPT mediante SatDump con programador automático
• WebSDR - Escucha remota de HF/onda corta mediante la red KiwiSDR
• ISS SSTV - Recepción de imágenes de televisión de barrido lento desde la Estación Espacial Internacional
• HF SSTV - SSTV terrestre en frecuencias de onda corta (80m-10m, VHF, UHF)
• APRS - Informes de posición y telemetría de radioaficionados por paquetes mediante direwolf
• Seguimiento de satélites - Predicción de pasos con gráfico polar y mapa de trayectoria terrestre
• Contadores de servicios - Lectura de contadores eléctricos, de gas y de agua mediante rtlamr
• Historial ADS-B - Historial persistente de aeronaves con panel de informes (Postgres opcional)
• Escaneo WiFi - Reconocimiento en modo monitor mediante aircrack-ng
• Escaneo Bluetooth - Descubrimiento de dispositivos y detección de rastreadores (con soporte para Ubertooth)
• BT Locate - Localización de dispositivos Bluetooth SAR con mapeo de rastro de señal etiquetado por GPS y alertas de proximidad
• WiFi Locate - Localización de puntos de acceso WiFi por BSSID con medidor de señal en tiempo real, estimación de distancia y audio de proximidad
• GPS - Seguimiento de posición GPS en tiempo real con mapa en vivo, velocidad, altitud e información de satélites
• TSCM - Contravigilancia con comparación de línea base de RF y detección de amenazas
• Meshtastic - Integración de red de malla LoRa
• Clima espacial - Datos solares y geomagnéticos en tiempo real de NOAA SWPC, NASA SDO y HamQSL (no requiere SDR)
• Estaciones espía - Base de datos de estaciones de números y redes diplomáticas de HF
• Agentes remotos - SIGINT distribuida con nodos sensores remotos
• Modo sin conexión - Recursos incluidos para despliegues en campo/aislados de la red
• Inteligencia de drones - Detección de UAV multivector mediante ASTM F3411 Remote ID (WiFi/BLE), RF de 433/868 MHz con RTL-SDR y escaneo de 2.4/5.8 GHz con HackRF, con mapa de contactos en vivo y puntuación de riesgo

---

Instalación / Debian / Ubuntu / macOS

Inicio rápido

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

En la primera ejecución, setup.sh inicia un asistente guiado que detecta tu sistema operativo, te permite elegir perfiles de instalación, configura el entorno de Python y, opcionalmente, configura variables de entorno y PostgreSQL.

En ejecuciones posteriores, abre un menú interactivo:

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

Servidor de producción vs servidor de desarrollo: start.sh detecta automáticamente gunicorn + gevent y ejecuta un servidor de producción con greenlets cooperativos — maneja múltiples clientes SSE/WebSocket sin bloquearse. Recurre al servidor de desarrollo de Flask si gunicorn no está instalado. Para desarrollo local rápido, aún puedes usar sudo -E venv/bin/python intercept.py directamente.

Perfiles de instalación

Elige qué instalar durante el asistente o mediante la opción 1 del menú:

#	Perfil	Herramientas
1	SIGINT básico	rtl_sdr, multimon-ng, rtl_433, dump1090, acarsdec, dumpvdl2, ffmpeg, gpsd
2	Marítimo y radio	AIS-catcher, direwolf
3	Clima y espacio	SatDump, radiosonde_auto_rx
4	Seguridad RF	aircrack-ng, HackRF, BlueZ, hcxtools, Ubertooth, SoapySDR
5	SIGINT completo	Todos los anteriores
6	Personalizado	Lista de verificación por herramienta

Se pueden combinar varios perfiles (p. ej., introduce 1 3 para Básico + Clima).

Opciones de 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 requiere el modo privilegiado para el acceso a SDR por USB. Los dispositivos SDR se pasan a través de /dev/bus/usb.

Tus datos: los ajustes, usuarios, reglas de alerta, listas de vigilancia y mensajes decodificados residen en ./instance en el host, por lo que sobreviven a --build. ¿Actualizas desde un archivo compose sin ese montaje? Copia los datos antiguos antes de reconstruir: docker cp intercept:/app/instance ./instance.

Para compilaciones multiarquitectura (amd64 + arm64 para Raspberry Pi), consulta build-multiarch.sh — gestiona la compilación cruzada y el envío al registro en un solo paso.

Configuración del entorno

Usa el Configurador de entorno (opción 5 del menú) para establecer interactivamente cualquier variable INTERCEPT_*. Los ajustes se guardan en un archivo .env que start.sh carga automáticamente al iniciarse.

También puedes crear o editar .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

Historial ADS-B (Opcional)

La función de historial ADS-B persiste los mensajes de las aeronaves en PostgreSQL para su análisis a largo plazo.