[PL] Linux — instalacja feedera ADS-B.Pro

Konfiguracja

Ta instrukcja jest przeznaczona dla Raspberry Pi oraz komputerów z systemem Linux. Obsługiwane architektury to amd64, arm64, armv6 i armv7.

Nowy feeder łączy się z ADS-B.Pro feederprzez szyfrowane połączenie TLS. Token jest potrzebny tylko podczas pierwszego parowania instalacji — nie jest wysyłany razem z każdą ramką ADS-B.

1.Zanim Cozaczniesz

będzie potrzebne

Potrzebujesz:

• Raspberrykonta PiADS-B.Pro /i Debiantokenu /zaczynającego Ubuntusię od ADS-;

działającego źródła danych ADS-B na tej samej maszynie; dostępu do konta z dostępemuprawnieniami sudo; połączenia wychodzącego do internetu.feed.ads-b.pro na porcie 48582.

Instalator automatycznie szuka prawidłowych ramek, a nie nazw zainstalowanych programów:

Beast Binary na 127.0.0.1:30005; Odbiornikjeśli RTL-SDRnie lubznajdzie innyramek odbiornikBeast ADS-B.w ciągu 5 sekund — BaseStation/SBS na 127.0.0.1:30003. Działający

Może więc współpracować między innymi z dump1090-fa, dump1090-mutabilityreadsb, dump1090 albo, readsbtar1090.

Konto w ADS-B.Pro. Twój prywatny feeder token z konta użytkownika.

Token feeder jest unikalny. W panelu konta jest pokazywany jako Your Feeder Token i mainnymi format:programami wystawiającymi zgodny strumień.

Instalacja

W terminalu wykonaj:

ADS-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

czyli ADS- plus 32 znaki hex. Skrypt wymaga małych liter a-f.

2. Skąd wziąć token

Zaloguj się w ADS-B.Pro. Wejdź w My Account. Skopiuj wartość z pola Your Feeder Token. Nie publikuj tego tokena w logach, na GitHubie ani w screenach.

Frontend używa tego tokena tylko jako wartości przypisanej do konta. Sam feeder wysyła go do backendu przez osobny skrypt /opt/radarview.py.

3. Najprostsza instalacja feedera

Rekomenduję wariant radarview_setup-nogit.sh, bo nie wymaga klonowania repozytorium i sam pobiera aktualny radarview.py.

sudo apt update
sudo apt install -y curl wget ca-certificates

curl -fsSL https://raw.githubusercontent.com/br3jski/radarview/refs/heads/main/radarview_setup-nogit.radarview_setup.sh | sudo bash

Jeżeli instalator nie znajdzie starej konfiguracji, poprosi o token ADS-B.Pro. Wprowadzany token nie jest wyświetlany.

Instalator:

pobiera feeder odpowiedni dla architektury komputera; sprawdza podpisany manifest wydania oraz sumę SHA-256 pliku; tworzy użytkownika systemowego adsbpro-feeder; zapisuje prywatny klucz instalacji wyłącznie lokalnie; instaluje i uruchamia usługę systemd; uruchamia lokalną stronę statusu na porcie 54321; czeka na połączenie z ADS-B.Pro i pierwszą zaakceptowaną ramkę.

Po udanym sparowaniu tymczasowa kopia tokenu jest usuwana.

Migracja ze starego /opt/radarview.py

Jeżeli masz starą usługę radarview, nie usuwaj jej przed instalacją.

Instalator sam odczyta token ze starego skryptu, ale go nie wypisze. Stara usługa zostanie zatrzymana dopiero wtedy, gdy nowy feeder połączy się z ADS-B.Pro i prześle pierwszą zaakceptowaną ramkę. Sam plik starego skryptu pozostaje na dysku jako możliwość awaryjnego powrotu.

Nie uruchamiaj jednocześnie starego i nowego feedera dla tego samego odbiornika — powoduje to wysyłanie duplikatów i niepotrzebne użycie łącza.

Sprawdzenie działania

Status w terminalu:

sudo /usr/local/bin/adsbpro-feeder status

Status usługi i ostatnie logi:

sudo systemctl status adsbpro-feeder --no-pager
sudo journalctl -u adsbpro-feeder -n 50 --no-pager

Strona statusu:

http://ADRES-IP-FEEDERA:54321

Na tym samym komputerze możesz użyć http://localhost:54321. Port statusu jest przeznaczony wyłącznie dla sieci lokalnej lub VPN — nie przekierowuj go w routerze do Internetu.

Prawidłowy status to ACTIVE. Panel pokazuje między innymi liczbę widzianych samolotów, tempo wiadomości, bieżący upload oraz wersję feedera.

Kolejna instalacja na tym samym koncie

Pierwsza instalacja v2 może zostać sparowana samym tokenem. Przed dodaniem każdej kolejnej instalacji otwórz w swoim koncie ADS-B.Pro 10-minutowe okno parowania, a następnie uruchom instalator na nowym komputerze.

Niestandardowy adres lub port źródła

Najprościej uruchomić instalator interaktywnie. Jeżeli źródło ADS-B działa na innym adresie albo porcie, dostępne są opcje instalatora, na przykład:

curl -fsSL https://raw.githubusercontent.com/br3jski/radarview/main/radarview_setup.sh -o radarview_setup-nogit.sh
chmod +x radarview_setup-nogit./tmp/radarview_setup.sh
sudo .bash /radarview_setup-nogit.tmp/radarview_setup.sh --source-host 192.168.1.25 --source-mode beast --beast-port 30005

PoDla uruchomieniuBaseStation/SBS skryptużyj poprosi--source-mode osbs token:--sbs-port NUMER_PORTU.

Aktualizacja

Feeder nie aktualizuje się sam. Gdy strona statusu pokaże UPDATE AVAILABLE, uruchom ponownie tę samą komendę instalacyjną. To zachowa sparowaną tożsamość instalacji.

Awaryjny powrót

Pleasesudo enter your RadarView token (format: ADS-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX):/usr/local/sbin/adsbpro-feeder-rollback

WklejPolecenie tokenwyłącza znową Myusługę Accounti, jeżeli była wcześniej wykryta, przywraca starą usługę radarview.

4.Gdy Cofeeder robinie skryptjest ACTIVE

Skrypt:Sprawdź kolejno:

1. Sprawdza, czy jest uruchomiony jako root.

Waliduje token użytkownika. Sprawdza, czy istnieje lokalne źródło ADS-B:

dump1090-fa dump1090-mutability dump1090 readsb Jeśli nie ma dump1090/readsb, pyta, czy zainstalować dump1090-fa. Pobiera radarview.py do:

/opt/radarview.py

Wstawia token do zmiennej:

USER_TOKEN = 'ADS-...'

Tworzy usługę systemd:

/etc/systemd/system/radarview.service

Uruchamia i włącza usługę na start systemu:

systemctl start radarview
systemctl enable radarview

5. Jak działa wysyłanie danych

radarview.py łączy się lokalnie z odbiornikiem ADS-B na porcie SBS:

127.0.0.1:30003

Następnie wysyła dane do ADS-B.Pro:

feed.ads-b.pro:48581

Przed każdą linią danych skrypt wysyła token:

TOKEN:ADS-...

Dlatego kluczowe są dwie rzeczy:

lokalny dump1090 / readsb musi wystawiać dane SBS na 127.0.0.1:30005 albo 127.0.0.1:30003, rzeczywiście płyną dane; urządzeniewynik musisudo mieć/usr/local/bin/adsbpro-feeder możliwośćstatus; połączenialogi wychodzącegosudo journalctl -u adsbpro-feeder -n 100 --no-pager; czy firewall pozwala na połączenie wychodzące TCP do feed.ads-b.pro:4858148582.; przy

6. Sprawdzenie pokolejnej instalacji

Status— usługi feedera:

sudo systemctl status radarview

Logi na żywo:

sudo journalctl -u radarview -f

Poprawne logi powinny zawierać cośczy w tympanelu stylu:

konta

Connectedotwarto tookno sourceparowania.

127.0.0.1:30003 Connected to destination feed.ads-b.pro:48581 Data sent with token

Sprawdzenie,Kod czyinstalatora lokalnyi ADS-Bfeedera działajest napubliczny: porcie 30003:

nc -vz 127.0.0.1 30003

Sprawdzenie połączenia do serwera ADS-B.Pro:

nc -vz feed.ads-b.pro 48581

7. Jeśli używasz readsb zamiast dump1090-fa

Upewnij się, że readsb ma włączony port SBS 30003. Feeder z podanego skryptu nie czyta JSON-a ani Beast, tylko tekstowy strumień SBS/BaseStation z portu 30003github.com/br3jski/radarview.

Przykładowo konfiguracja readsb powinna zawierać odpowiednik:

--net
--net-sbs-port 30003

Po zmianach zrestartuj readsb.

8. Zmiana tokena po instalacji

Jeśli token został odnowiony albo wklejony błędnie, najprościej uruchomić skrypt instalacyjny ponownie.

Można też ręcznie poprawić /opt/radarview.py, znaleźć linię:

USER_TOKEN = 'ADS-...'

i po zmianie zrestartować usługę:

sudo systemctl restart radarview

9. Typowe problemy

Invalid token format
Token nie pasuje do formatu ADS- plus 32 znaki hex. Skopiuj token dokładnie z My Account.

Error: User token not set
W /opt/radarview.py token jest pusty. Uruchom setup ponownie albo popraw USER_TOKEN.

Socket error przy 127.0.0.1:30003
dump1090 / readsb nie działa albo nie wystawia SBS na porcie 30003.

Socket error przy feed.ads-b.pro:48581
Problem z DNS, internetem, firewallem albo blokadą połączeń wychodzących TCP na port 48581.

Konto nadal nie ma statusu Feeder
Feeder musi faktycznie wysyłać stabilne dane. Po stronie frontendu status Feeder pojawia się z konta użytkownika/backendu; czasem trzeba się wylogować i zalogować ponownie albo odświeżyć token sesji po zatwierdzeniu feedera.