intercept v2.33.0

Apoie o desenvolvedor deste projeto de código aberto

Plataforma de Inteligência de Sinais
Uma interface baseada na web para ferramentas de rádio definido por software.

---

Recursos

• Decodificação de Pager - POCSAG/FLEX via rtl_fm + multimon-ng
• Sensores de 433MHz - Estações meteorológicas, TPMS, dispositivos IoT via rtl_433
• Analisador Sub-GHz - Captura de RF e decodificação de protocolos para bandas ISM de 300-928 MHz via HackRF
• Rastreamento de Aeronaves - ADS-B via dump1090 com mapa em tempo real e radar
• Rastreamento de Embarcações - Rastreamento de navios AIS com monitoramento de socorro VHF DSC
• Mensagens ACARS - Mensagens de datalink de aeronaves via acarsdec
• VDL2 - Decodificação de datalink de aeronaves VHF Data Link Mode 2 via dumpvdl2
• Posto de Escuta - Scanner de frequência de banda larga com monitoramento de áudio em tempo real
• Satélites Meteorológicos - Decodificação de imagens NOAA APT e Meteor LRPT via SatDump com agendador automático
• WebSDR - Escuta remota de HF/ondas curtas via rede KiwiSDR
• ISS SSTV - Recepção de imagens de TV de varredura lenta da Estação Espacial Internacional
• HF SSTV - SSTV terrestre em frequências de ondas curtas (80m-10m, VHF, UHF)
• APRS - Relatórios de posição e telemetria de rádio pacote amador via direwolf
• Rastreamento de Satélites - Previsão de passagens com gráfico polar e mapa de trajetória no solo
• Medidores de Utilidades - Leitura de medidores de eletricidade, gás e água via rtlamr
• Histórico ADS-B - Histórico persistente de aeronaves com painel de relatórios (Postgres opcional)
• Varredura WiFi - Reconhecimento em modo monitor via aircrack-ng
• Varredura Bluetooth - Descoberta de dispositivos e detecção de rastreadores (com suporte a Ubertooth)
• BT Locate - Localização de dispositivos Bluetooth SAR com mapeamento de trilha de sinal marcada por GPS e alertas de proximidade
• WiFi Locate - Localize pontos de acesso WiFi por BSSID com medidor de sinal em tempo real, estimativa de distância e áudio de proximidade
• GPS - Rastreamento de posição GPS em tempo real com mapa ao vivo, velocidade, altitude e informações de satélites
• TSCM - Contravigilância com comparação de linha de base de RF e detecção de ameaças
• Meshtastic - Integração com rede mesh LoRa
• Clima Espacial - Dados solares e geomagnéticos em tempo real do NOAA SWPC, NASA SDO e HamQSL (não requer SDR)
• Estações de Espionagem - Banco de dados de estações de números e redes diplomáticas de HF
• Agentes Remotos - SIGINT distribuído com nós sensores remotos
• Modo Offline - Recursos incluídos para implantações isoladas/em campo
• Inteligência de Drones - Detecção de UAV multi-vetor via ASTM F3411 Remote ID (WiFi/BLE), RF de 433/868 MHz com RTL-SDR e varredura de 2.4/5.8 GHz com HackRF, com mapa de contatos ao vivo e pontuação de risco

---

Instalação / Debian / Ubuntu / macOS

Início Rápido

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

Na primeira execução, o setup.sh inicia um assistente guiado que detecta o seu sistema operacional, permite escolher perfis de instalação, configura o ambiente Python e, opcionalmente, define variáveis de ambiente e o PostgreSQL.

Nas execuções subsequentes, ele abre um menu interativo:

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 produção vs. desenvolvimento: start.sh detecta automaticamente gunicorn + gevent e executa um servidor de produção com greenlets cooperativos — lida com múltiplos clientes SSE/WebSocket sem bloqueio. Recorre ao servidor de desenvolvimento Flask se o gunicorn não estiver instalado. Para desenvolvimento local rápido, você ainda pode usar sudo -E venv/bin/python intercept.py diretamente.

Perfis de Instalação

Escolha o que instalar durante o assistente ou pela opção 1 do menu:

#	Perfil	Ferramentas
1	SIGINT Essencial	rtl_sdr, multimon-ng, rtl_433, dump1090, acarsdec, dumpvdl2, ffmpeg, gpsd
2	Marítimo & Rádio	AIS-catcher, direwolf
3	Clima & Espaço	SatDump, radiosonde_auto_rx
4	Segurança RF	aircrack-ng, HackRF, BlueZ, hcxtools, Ubertooth, SoapySDR
5	SIGINT Completo	Todos os acima
6	Personalizado	Lista de verificação por ferramenta

Vários perfis podem ser combinados (por exemplo, insira 1 3 para Essencial + Clima).

Flags 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: O Docker requer modo privilegiado para acesso a SDR USB. Os dispositivos SDR são passados através de /dev/bus/usb.

Seus dados: configurações, usuários, regras de alerta, watchlists e mensagens decodificadas ficam em ./instance no host, para que sobrevivam ao --build. Atualizando a partir de um arquivo compose sem essa montagem? Copie os dados antigos antes de reconstruir: docker cp intercept:/app/instance ./instance.

Para builds multi-arquitetura (amd64 + arm64 para Raspberry Pi), consulte build-multiarch.sh — ele lida com compilação cruzada e push para o registry em uma única etapa.

Configuração de Ambiente

Use o Environment Configurator (opção 5 do menu) para definir interativamente qualquer variável INTERCEPT_*. As configurações são salvas em um arquivo .env que o start.sh carrega automaticamente na inicialização.

Você também pode criar ou editar o .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

Histórico ADS-B (Opcional)

O recurso de histórico ADS-B persiste mensagens de aeronaves no PostgreSQL para análise de longo prazo.