Panoramica

Osiris è una piattaforma OSINT di livello produttivo che fornisce consapevolezza situazionale su molteplici domini di intelligence. Costruita con Next.js 16 e MapLibre GL, ogni dato viene renderizzato tramite WebGL per prestazioni a 60fps anche con migliaia di entità simultanee sullo schermo.

Capacità principali

Architettura

┌─────────────────────────────────────────────────┐
│                  OSIRIS CLIENT                   │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐ │
│  │ MapLibre  │  │  HUD     │  │  RECON Toolkit│ │
│  │  GL (GPU) │  │ Panels   │  │  Port Scan    │ │
│  │  WebGL    │  │ Layers   │  │  DNS / WHOIS  │ │
│  │  Render   │  │ Controls │  │  Vuln Scanner │ │
│  └──────────┘  └──────────┘  └───────────────┘ │
├─────────────────────────────────────────────────┤
│               NEXT.JS API ROUTES                 │
│  /api/flights         /api/earthquakes          │
│  /api/cctv            /api/news                 │
│  /api/fires           /api/maritime             │
│  /api/gdelt           /api/satellites           │
│  /api/weather         /api/scanner              │
│  /api/sentinel        /api/telegram-feed        │
│  /api/osint/*  (whois, dns, ip, cve, sanctions, │
│                 crypto, sweep, threats, …)      │
├─────────────────────────────────────────────────┤
│              EXTERNAL DATA SOURCES               │
│  OpenSky · USGS · NASA · NOAA · TfL · NVD      │
│  GDACS · EONET · FIRMS · N2YO · RSS Feeds      │
│  blockstream.info · Blockscout · OpenSanctions  │
│  t.me public previews                            │
└─────────────────────────────────────────────────┘

Funzionalità

Livelli di intelligence

• 16 livelli dati attivabili con conteggi delle entità in tempo reale
• Rendering accelerato via GPU — tutti i dati della mappa renderizzati tramite WebGL, non DOM
• Caricamento progressivo — dati recuperati on-demand quando i livelli vengono attivati
• Consapevole del viewport — carica solo i dati rilevanti per la regione visibile

Texas CCTV

Gli snapshot pubblici TxDOT ITS sono integrati con i marker delle telecamere esistenti, la griglia di anteprima e il visualizzatore. Usa /api/cctv?region=texas per il solo Texas; le query di località globali e del Texas includono la stessa fonte. Gli inventari dei distretti sono memorizzati in cache in modo indipendente, con i dati obsoleti conservati durante le interruzioni. La disponibilità varia per distretto e telecamera; si tratta di snapshot JPEG aggiornati, non di stream video.

Fonte: TxDOT ITS.

Esegui npm test per i controlli offline o RUN_LIVE_TESTS=1 npx vitest run src/app/api/cctv/texas.test.ts per verificare l'inventario pubblico del Texas.

RECON Toolkit

• Port Scanner — scansione TCP connect con fingerprinting dei servizi
• DNS Lookup — risoluzione completa dei record (A, AAAA, MX, NS, TXT, CNAME)
• WHOIS — dati di registrazione dominio/IP (verificati automaticamente contro OFAC SDN)
• SSL/TLS Inspector — analisi della catena di certificati
• IP Intelligence — geolocalizzazione, ASN, reputazione della minaccia (verificata automaticamente contro OFAC SDN)
• Vulnerability Scanner — ricerca CVE nel database NVD
• Crypto Wallet Trace — ricerca BTC + ETH (saldo, cronologia tx, flag sanzioni OFAC SDN)
• OFAC Sanctions Search — ricerca di persone, organizzazioni, navi e aeromobili nella lista US OFAC SDN

Rete di trasmissione live

• 23 stream di notizie live 24/7 da emittenti globali
• Clicca su qualsiasi punto notizie sulla mappa per aprire lo stream live
• Feed da NBC, CBS, ABC, Sky News, Al Jazeera, France 24, NHK, WION e altri

Livello Telegram OSINT

• Feed di canali pubblici estratto dall'anteprima web non autenticata t.me/s/<channel> — nessun token Bot API, nessun MTProto
• Set curato predefinito di 5 canali (EN + reportage di guerra RU/UA), sovrascrivibile tramite OSIRIS_TELEGRAM_CHANNELS
• I post vengono geoparsificati rispetto a un dizionario multilingue di luoghi (EN + cirillico + arabo) e tracciati sulla mappa
• Clicca su qualsiasi punto ciano per leggere il post e saltare all'originale su Telegram

Crypto Wallet Intelligence

• Ricerche BTC tramite blockstream.info (Esplora API, senza chiave)
• Ricerche ETH tramite l'istanza ETH pubblica di Blockscout (eth.blockscout.com, senza chiave)
• Ogni ricerca viene verificata incrociando la lista di indirizzi sanzionati OFAC SDN (mirror da 0xB10C/ofac-sanctioned-digital-currency-addresses)
• I wallet sanzionati mostrano un badge rosso SANCTIONED — OFAC SDN nel pannello RECON

Cross-Check OFAC SDN

• Scheda SANCTIONS autonoma nel toolkit RECON — ricerca full-text su persone, organizzazioni, navi e aeromobili
• Le route WHOIS e IP-intel verificano automaticamente i nomi dei registrant / proprietari ASN contro la lista SDN e mostrano un avviso inline
• Dati provenienti da OpenSanctions (CC-BY 4.0) — senza chiave, ~7 MB memorizzati in cache in memoria per 24h

Monitoraggio zone di conflitto

• 13 zone attive di conflitto/tensione con marker di avviso codificati per severità
• Guerre attive: Ucraina, Gaza, Sudan, Myanmar, RDC, Yemen
• Alta tensione: Siria, Libano, Sahel, Somalia, Mar Rosso
• Elevata: Stretto di Taiwan, DMZ coreana

Prestazioni ottimizzate

• Riduzione del 75% delle richieste edge rispetto al rilascio iniziale
• Rilassamento aggressivo del polling (intervalli di 15-30 min per dati stabili)
• Dati statici serviti dalla memoria (zero chiamate API esterne per i feed di notizie)
• layerFetchedRef previene richieste API duplicate

Avvio rapido

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
npm install
npm run dev

Apri http://localhost:3000

Docker / Self-Hosting

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
cp .env.template .env     # optional — configure keys / port
docker compose up -d

Apri http://localhost:3000. L'immagine è una build standalone multi-stage node:22-alpine (~220 MB, non-root). Il file compose contiene anche i metadati dell'app CasaOS (x-casaos:) per l'installazione con un clic su CasaOS. Vedi DOCKER.md per la guida completa a Docker, CasaOS e alle API key.

Immagine precompilata (GHCR) — salta la build e scaricala direttamente:

docker pull ghcr.io/simplifaisoul/osiris:latest
docker run -d -p 3000:3000 --env-file .env ghcr.io/simplifaisoul/osiris:latest

Porta personalizzata — il container ascolta sempre sulla 3000; imposta OSIRIS_PORT in .env per cambiare la porta host pubblicata (es. OSIRIS_PORT=3005) senza modificare il file compose.

Variabili d'ambiente

OSIRIS funziona parzialmente senza alcuna API key — tutti i feed principali usano fonti pubbliche e senza chiave. Copia .env.template in .env e imposta solo ciò che ti serve:

# Published host port (container always listens on 3000). Default: 3000
OSIRIS_PORT=3000

# RECON scanner backend (the only vars the current code reads).
# SCANNER_KEY must match the backend's OSIRIS_KEY — generate with: openssl rand -hex 32
SCANNER_URL=
SCANNER_KEY=

# Optional, for higher rate limits / future sources (see DOCKER.md for signup links)
FIRMS_API_KEY=                # NASA FIRMS  — firms.modaps.eosdis.nasa.gov/api/map_key/
OPENSKY_CLIENT_ID=            # OpenSky OAuth2 (since Mar 2025) — opensky-network.org
OPENSKY_CLIENT_SECRET=
N2YO_API_KEY=                 # N2YO satellites — n2yo.com (Profile → API key)
AIS_API_KEY=                 # aisstream.io maritime

Senza SCANNER_URL/SCANNER_KEY il toolkit RECON restituisce 503; ogni altro livello funziona out of the box. .env è in gitignore — solo il template è committato.

Stack tecnologico

Scorciatoie da tastiera

Ringraziamenti

Webcam pubbliche — le telecamere in questo livello sono open data: ognuna è trasmessa pubblicamente da chi la gestisce, sul proprio sito o sul proprio canale. Ciò che mancava al web era un catalogo che le raccogliesse.

bekijkhet.nu è quel catalogo, ed è la base per ogni telecamera del livello. Bram e Annelies lo mantengono a mano dal 2012, e senza il loro indice queste telecamere sarebbero ancora sparse su diverse centinaia di siti non correlati senza alcun modo di trovarle.

OSIRIS le collega tutte direttamente all'operatore che le gestisce, che è anche il modo in cui bekijkhet.nu chiede di essere letto.

Licenza

MIT — vedi LICENSE per i dettagli.