ADSBItalia logo
Partecipa alla rete globale ADSBItalia

Collega il tuo feeder ADS-B e MLAT ad ADSBItalia.

ADSBItalia aggrega feed ADS-B e risultati MLAT da stazioni indipendenti in tutto il mondo. Puoi contribuire alla mappa live mantenendo il pieno controllo della tua installazione locale.

Puoi partecipare con Ultrafeeder/Docker, ADSB.im, con un feed Beast compatibile oppure con l’installazione classica tramite script. Tutte le connessioni verso ADSBItalia avvengono in uscita: non serve aprire porte sul router.

Supporto community

Hai problemi con la configurazione?

Chiedi aiuto alla community ADSBItalia su Discord o Telegram. Indica metodo usato, hardware, software, messaggio di errore e log rilevanti. Non condividere mai token, password o dati personali.

Modalità di partecipazione

ADSBItalia accetta feed ADS-B in formato Beast e, dove possibile, connessioni MLAT dedicate. La scelta più comoda dipende da come è configurata la tua stazione: Docker/Ultrafeeder, ADSB.im, decoder locale classico, readsb, dump1090 o altro software compatibile.

Consigliato Ultrafeeder / Docker

Se usi Ultrafeeder, puoi aggiungere ADSBItalia tra gli outbound feeders senza installare servizi systemd aggiuntivi sul sistema host.

Senza script ADSB.im

Se usi ADSB.im, aggiungi ADSBItalia dalla sezione Expert nel campo degli additional Ultrafeeder arguments.

Alternativa Installazione classica

Se hai un decoder locale con output Beast disponibile su una porta TCP, puoi usare lo script ADSBItalia per creare i servizi ADS-B e MLAT dedicati.

La pagina “Stato del tuo feed” funziona anche con Ultrafeeder: ADSBItalia verifica le connessioni in arrivo dal tuo IP pubblico verso le porte della rete.

Cosa invii ad ADSBItalia

  • Feed ADS-B Beast verso ADSBItalia sulla porta 31108.
  • Connessione MLAT verso ADSBItalia sulla porta 41113, se configurata.
  • Risultati MLAT locali opzionali su una porta dedicata, se supportati dalla tua configurazione.
  • Nome feeder, coordinate e altitudine corretti per identificare la stazione e migliorare la qualità MLAT.

Porte principali

Beast locale30005
ADS-B ADSBItalia31108
MLAT ADSBItalia41113
Risultati MLAT33106 / libera

La porta Beast locale può essere diversa da 30005. Le porte verso ADSBItalia sono connessioni in uscita dal feeder verso il server.

Metodo consigliato: Ultrafeeder / Docker

Ultrafeeder è indicato se gestisci già la tua stazione ADS-B tramite Docker. In questo caso non devi installare lo script ADSBItalia sul sistema host: aggiungi ADSBItalia alla configurazione outbound del container e riavvii Ultrafeeder.

Prima di modificare

  • Fai una copia del tuo docker-compose.yml o del file .env.
  • Verifica di avere coordinate, altitudine, nome feeder e UUID corretti.
  • Se hai già altri network in ULTRAFEEDER_CONFIG, aggiungi ADSBItalia senza cancellare le righe esistenti.

Esempio configurazione Ultrafeeder

Aggiungi le righe ADSBItalia alla tua variabile ULTRAFEEDER_CONFIG. Mantieni il punto e virgola tra le righe, tranne sull’ultima riga della variabile.

ULTRAFEEDER_CONFIG=
adsb,adsbitalia.it,31108,beast_reduce_plus_out;
mlat,mlat.adsbitalia.it,41113;

Riavvio e controllo

docker compose pull ultrafeeder
docker compose up -d ultrafeeder
docker logs -f ultrafeeder
La riga MLAT richiede solo host e porta del server MLAT. Usa la configurazione mostrata esattamente così. Se hai dubbi, contatta ADSBItalia indicando che usi Ultrafeeder.

Metodo ADSB.im

Se usi ADSB.im, non devi eseguire install.sh. Puoi aggiungere ADSBItalia direttamente dagli additional Ultrafeeder arguments nella sezione Expert.

Dove inserire i dati

  1. Apri l’interfaccia web di ADSB.im.
  2. Vai su Setup.
  3. Apri la sezione Expert.
  4. Nel campo Add additional Ultrafeeder arguments, incolla le righe ADSBItalia.
  5. Premi Apply e attendi l’applicazione della configurazione.
ADSB.im: clicca Setup e seleziona Expert
Nel menu Setup, apri la voce Expert.
ADSB.im: incolla le righe ADSBItalia e premi Apply
Nel campo Add additional Ultrafeeder arguments, incolla le righe ADSBItalia e premi Apply.

Righe da incollare

Incolla questa stringa nel campo degli additional Ultrafeeder arguments. Non cancellare eventuali configurazioni già presenti.

adsb,adsbitalia.it,31108,beast_reduce_plus_out; mlat,mlat.adsbitalia.it,41113;
In ADSB.im/Ultrafeeder la riga MLAT richiede solo host e porta del server MLAT. Incolla la configurazione esattamente come mostrata e poi controlla la pagina “Stato del tuo feed”.

Installazione classica tramite script

Usa questo metodo se hai un decoder ADS-B locale che espone un output Beast su 127.0.0.1 o su un host raggiungibile dalla macchina del feeder.

Installazione rapida

Esegui questo comando sul feeder:

curl -fsSL https://raw.githubusercontent.com/djrexishere91/Adsb-Italia/main/install.sh -o install.sh && bash install.sh

Cosa fa lo script

Lo script verifica la porta Beast locale, installa i pacchetti necessari, prepara l’ambiente dedicato per mlat-client, registra il feeder e crea i servizi systemd locali per inviare ADS-B e MLAT ad ADSBItalia.

Script disponibili

  • install.shinstallazione iniziale del feeder.
  • update.shaggiornamento di nome feeder, coordinate e altitudine.
  • uninstall.shrimozione dei servizi ADSBItalia e dell’ambiente MLAT dedicato.

Requisiti

  • Ricevitore ADS-B attivo.
  • Feed Beast disponibile localmente oppure configurazione Ultrafeeder/Docker compatibile.
  • Connessione Internet stabile.
  • Possibilità di inviare dati verso ADSBItalia tramite connessione in uscita.
  • Coordinate e altitudine corrette se vuoi contribuire anche a MLAT.

Non è necessario aprire porte sul router. Con installazione classica servono privilegi sudo; con Ultrafeeder basta modificare la configurazione Docker esistente.

Risultati MLAT locali

Quando configurato, il feeder può ricevere i risultati MLAT in locale e riutilizzarli nella propria installazione, per esempio nella mappa locale o in servizi compatibili.

Comandi di gestione

Installazione classica

Stato dei servizi:

sudo systemctl status adsbitalia-feed.service
sudo systemctl status adsbitalia-mlat.service

Log in tempo reale:

sudo journalctl -u adsbitalia-feed.service -f
sudo journalctl -u adsbitalia-mlat.service -f

Ultrafeeder / Docker

docker ps | grep ultrafeeder
docker logs -f ultrafeeder
docker compose logs -f ultrafeeder

Aggiornamento e rimozione

Aggiornare dati installazione classica

Per cambiare nome feeder, coordinate o altitudine:

curl -fsSL https://raw.githubusercontent.com/djrexishere91/Adsb-Italia/main/update.sh -o update.sh && bash update.sh

Rimuovere ADSBItalia

Per rimuovere i servizi ADSBItalia dall’installazione classica:

curl -fsSL https://raw.githubusercontent.com/djrexishere91/Adsb-Italia/main/uninstall.sh | sudo bash

Con Ultrafeeder basta rimuovere le righe ADSBItalia dalla configurazione del container e riavviare Ultrafeeder.

File creati dall’installazione classica

/opt/adsbitalia-mlat                         Ambiente Python dedicato a mlat-client.
/etc/adsbitalia/feeder.conf                 Configurazione del feeder.
/etc/systemd/system/adsbitalia-mlat.service     Servizio systemd MLAT ADSBItalia.
/etc/systemd/system/adsbitalia-feed.service     Servizio systemd ADS-B forwarding ADSBItalia.

Questi file non vengono creati se partecipi tramite Ultrafeeder/Docker senza usare lo script classico.

Risoluzione problemi

Se il feed non risulta online, controlla prima quale metodo stai usando.

Installazione classica

sudo systemctl status adsbitalia-feed.service
sudo systemctl status adsbitalia-mlat.service
sudo journalctl -u adsbitalia-feed.service -n 100 --no-pager
sudo journalctl -u adsbitalia-mlat.service -n 100 --no-pager

Ultrafeeder

docker ps | grep ultrafeeder
docker logs --tail 100 ultrafeeder
docker compose logs --tail 100 ultrafeeder

Verifica anche che il feeder locale stia generando dati ADS-B, che le coordinate siano corrette e che il firewall consenta connessioni in uscita verso ADSBItalia.