ADSBItalia logo
Rejoignez le réseau mondial ADSBItalia

Connectez votre feeder ADS-B et MLAT à ADSBItalia.

ADSBItalia agrège des flux ADS-B et des résultats MLAT provenant de stations indépendantes dans le monde entier. Vous pouvez contribuer à la carte en direct tout en gardant le contrôle total de votre installation locale.

Vous pouvez rejoindre le réseau avec Ultrafeeder/Docker, ADSB.im, un flux Beast compatible ou l’installation classique basée sur script. Toutes les connexions vers ADSBItalia sont sortantes : aucune redirection de port n’est nécessaire sur le routeur.

Support communautaire

Besoin d’aide pour votre configuration ?

Demandez de l’aide à la communauté ADSBItalia sur Discord ou Telegram. Indiquez votre méthode d’installation, le matériel, le logiciel, le message d’erreur et les logs utiles. Ne partagez jamais de jetons, mots de passe ou informations personnelles.

Façons de participer

ADSBItalia accepte les flux ADS-B au format Beast et, lorsque c’est possible, des connexions MLAT dédiées. La meilleure méthode dépend de la configuration de votre station : Docker/Ultrafeeder, ADSB.im, décodeur local classique, readsb, dump1090 ou tout autre logiciel compatible.

Recommandé Ultrafeeder / Docker

Si vous utilisez Ultrafeeder, vous pouvez ajouter ADSBItalia comme feeder sortant sans installer de services systemd supplémentaires sur l’hôte.

Sans script ADSB.im

Depuis ADSB.im v3.0.13, ADSBItalia est directement intégré. Il suffit de l’activer sur la page Data Sharing, sans ajouter d’arguments manuels.

Alternative Installation classique

Si votre décodeur local fournit une sortie Beast sur un port TCP, vous pouvez utiliser le script ADSBItalia pour créer des services ADS-B et MLAT dédiés.

Nouveau ACARS / VDL2 / HFDL / Satcom

Transmettez la t?l?m?trie VHF ACARS, VDL Mode 2, HFDL ondes courtes ou satellites Inmarsat/Iridium via acars_router, dumphfdl ou ADSB.im.

La page « État de votre feed » fonctionne aussi avec Ultrafeeder : ADSBItalia vérifie les connexions depuis votre IP publique vers les ports du réseau.

Ce que vous envoyez à ADSBItalia

  • Flux ADS-B Beast vers ADSBItalia sur le port 31108.
  • Connexion MLAT vers ADSBItalia sur le port 41113, si elle est configurée.
  • Résultats MLAT locaux facultatifs sur un port dédié, si votre configuration le permet.
  • Nom du feeder, coordonnées et altitude corrects afin d’identifier la station et d’améliorer la qualité MLAT.

Ports principaux

Beast local30005
ADSBItalia ADS-B31108
ADSBItalia MLAT41113
Résultats MLAT33106 / libera

Le port Beast local peut être différent de 30005. Les ports ADSBItalia sont des connexions sortantes du feeder vers le serveur.

Méthode recommandée : Ultrafeeder / Docker

Ultrafeeder est la meilleure option si vous gérez déjà votre station ADS-B avec Docker. Dans ce cas, vous n’avez pas besoin d’installer le script ADSBItalia sur l’hôte : ajoutez ADSBItalia à la configuration sortante du conteneur puis redémarrez Ultrafeeder.

Avant de modifier

  • Faites une copie de votre fichier docker-compose.yml ou .env.
  • Vérifiez que les coordonnées, l’altitude, le nom du feeder et l’UUID sont corrects.
  • Si vous avez déjà d’autres réseaux dans ULTRAFEEDER_CONFIG, ajoutez ADSBItalia sans supprimer les lignes existantes.

Exemple de configuration Ultrafeeder

Ajoutez les lignes ADSBItalia à votre variable ULTRAFEEDER_CONFIG. Conservez les points-virgules entre les lignes, sauf sur la dernière ligne de la variable.

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

Redémarrage et vérification

docker compose pull ultrafeeder
docker compose up -d ultrafeeder
docker logs -f ultrafeeder
La ligne MLAT nécessite uniquement l’hôte et le port du serveur MLAT. Utilisez la configuration exactement comme indiqué. En cas de doute, contactez ADSBItalia en précisant que vous utilisez Ultrafeeder.

Méthode ADSB.im

Depuis la version v3.0.13, ADSBItalia est directement intégré à l’interface web ADSB.im. Il n’est plus nécessaire d’exécuter un script, d’ouvrir la section Expert ou de coller des arguments Ultrafeeder.

Activer ADSBItalia

  1. Vérifiez que votre installation ADSB.im utilise la version v3.0.13 ou une version ultérieure.
  2. Ouvrez l’interface web ADSB.im et accédez à Data Sharing.
  3. Repérez ADSBItalia dans la liste des agrégateurs.
  4. Cochez ADSBItalia, puis enregistrez ou appliquez la modification.
C’est tout : ADSB.im gère automatiquement les connexions ADS-B et MLAT nécessaires. Après application, consultez la page « État de votre feed » pour confirmer que la station est en ligne.

Installation classique basée sur script

Utilisez cette méthode si vous avez un décodeur ADS-B local exposant une sortie Beast sur 127.0.0.1 ou sur un hôte accessible depuis la machine du feeder.

Installation rapide

Exécutez cette commande sur le feeder :

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/install.sh -o install.sh && bash install.sh

Ce que fait le script

Le script vérifie le port Beast local, installe les paquets nécessaires, prépare l’environnement dédié à mlat-client, enregistre le feeder et crée des services systemd locaux pour envoyer ADS-B et MLAT à ADSBItalia.

Scripts disponibles

  • install.shinstallation initiale du feeder.
  • update.shmise à jour du nom du feeder, des coordonnées et de l’altitude.
  • uninstall.shsuppression des services ADSBItalia et de l’environnement MLAT dédié.

Prérequis

  • Récepteur ADS-B actif.
  • Flux Beast disponible localement ou configuration Ultrafeeder/Docker compatible.
  • Connexion Internet stable.
  • Possibilité d’envoyer des données vers ADSBItalia via une connexion sortante.
  • Coordonnées et altitude correctes si vous souhaitez aussi contribuer au MLAT.

Aucune redirection de port n’est nécessaire sur le routeur. L’installation classique nécessite des privilèges sudo ; avec Ultrafeeder, vous modifiez simplement votre configuration Docker existante.

Résultats MLAT locaux

Lorsqu’il est configuré, le feeder peut recevoir les résultats MLAT localement et les réutiliser dans sa propre installation, par exemple sur la carte locale ou dans des services compatibles.

Commandes de gestion

Installation classique

État des services :

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

Journaux en direct :

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

Mise à jour et suppression

Mettre à jour les données de l’installation classique

Pour modifier le nom du feeder, les coordonnées ou l’altitude :

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/update.sh -o update.sh && bash update.sh

Supprimer ADSBItalia

Pour supprimer les services ADSBItalia de l’installation classique :

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/uninstall.sh | sudo bash

Avec Ultrafeeder, supprimez simplement les lignes ADSBItalia de la configuration du conteneur puis redémarrez Ultrafeeder.

Fichiers créés par l’installation classique

/opt/adsbitalia-mlat                         Environnement Python dédié à mlat-client.
/etc/adsbitalia/feeder.conf                 Configuration du feeder.
/etc/systemd/system/adsbitalia-mlat.service     Service systemd MLAT ADSBItalia.
/etc/systemd/system/adsbitalia-feed.service     Service systemd de transfert ADS-B ADSBItalia.

Ces fichiers ne sont pas créés si vous rejoignez le réseau via Ultrafeeder/Docker sans utiliser le script classique.

Dépannage

Si le feed n’apparaît pas en ligne, vérifiez d’abord quelle méthode vous utilisez.

Installation classique

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

Vérifiez aussi que le feeder local génère bien des données ADS-B, que les coordonnées sont correctes et que le pare-feu autorise les connexions sortantes vers ADSBItalia.

Transmettre les données ACARS, VDL-M2, HFDL & Satcom

ADSBItalia héberge un Router ACARS & Satcom central qui reçoit des flux distincts pour VHF ACARS, VDL Mode 2, HFDL (Ondes courtes) et Satcom (Inmarsat/Iridium/JAERO) du monde entier.

Notre serveur enrichit automatiquement les rapports avec le calcul en temps réel de la GroundSpeed (vitesse au sol) et la persistance de l'altitude pour les vols océaniques.

Serveur / Hôte global : feed.adsbitalia.it (ou adsbitalia.it)

Tableau des Ports d'Ingestion Dédiés

Satcom (Inmarsat / Iridium / JAERO)5554JSON (TCP/UDP)
VHF ACARS (131 MHz)5550JSON (TCP/UDP)
VDL Mode 2 (VHF 136 MHz)5555JSON (TCP/UDP)
HFDL (Ondes courtes 2–30 MHz)5556JSON (TCP/UDP)
BaseStation SBS générique31109SBS (TCP)

Configuration acars_router (Docker / SDR-Enthusiasts)

Ajoutez les variables d'environnement dédiées dans votre docker-compose.yml et redémarrez le conteneur :

environment:
  - AR_SEND_UDP_ACARS=feed.adsbitalia.it:5550
  - AR_SEND_UDP_JAERO=feed.adsbitalia.it:5554
  - AR_SEND_UDP_INMARSAT=feed.adsbitalia.it:5554
  - AR_SEND_UDP_IRIDIUM=feed.adsbitalia.it:5554
  - AR_SEND_UDP_VDLM2=feed.adsbitalia.it:5555
  - AR_SEND_UDP_HFDL=feed.adsbitalia.it:5556

Configuration ADSB.im

Ouvrez le tableau de bord ADSB.im, accédez au module correspondant et configurez dans Custom Destinations feed.adsbitalia.it (ou adsbitalia.it) avec le port désigné au format JSON.

Host: feed.adsbitalia.it
Ports: 5556 (HFDL) | 5555 (VDL2) | 5554 (Satcom/JAERO) | 5550 (VHF ACARS)
Format: JSON

Décodeurs en ligne de commande

# Inmarsat / Iridium Satcom (JAERO):
Settings -> Audio/Decoding -> ACARS Output -> Host: feed.adsbitalia.it, Port: 5554, Protocol: UDP (JSON)

# VHF ACARS (acarsdec):
acarsdec -j feed.adsbitalia.it:5550

# VDL Mode 2 (dumpvdl2):
dumpvdl2 --output-acars decoded:json:tcp:address=feed.adsbitalia.it,port=5555

# HFDL (dumphfdl):
dumphfdl --output decoded:json:tcp:address=feed.adsbitalia.it,port=5556