Naciśnij ESC, aby zamknąć

Traccar: Konfiguracja komunikacji z GPSem w Dockerze

Cześć!

W poprzedniej instrukcji omówiłem instalację Traccar na serwerze Synology za pomocą Docker Compose. Niemniej jednak, nie skonfigurowaliśmy jeszcze odbioru danych z GPSa. W tym prostym kroku pokażę, jak to zrobić, korzystając z przykładu urządzenia GPS od Teltoniki.

Przewodnik instalacji Traccar na Synology w DockerzeCzym jest Traccar?

Traccar to narzędzie typu open-source do śledzenia pojazdów, umożliwiająca monitorowanie i zarządzanie flotą. Działa na zasadzie serwera GPS, zbierając dane z urządzeń GPS oraz innych sensorów, a następnie prezentuje te informacje w webowym interfejsie. Traccar pozwala śledzić lokalizację pojazdów w czasie rzeczywistym, analizować historię tras, monitorować zużycie paliwa i inne parametry.

Przygotowanie

W celu przygotowania poradnika, przyjęliśmy już wcześniej ustaloną nazwę domeny oraz określone nazwy konfiguracyjne, przedstawione poniżej. Dla dostosowania konfiguracji do własnych potrzeb, należy dostosować ustawienia według indywidualnych wymagań.

  • Pełna nazwa domeny (FQDN) Traccar: https://traccar.xyz.com
  • Publiczny adres IP lub skonfigurowana publiczna nazwa domeny u operatora, u którego zarejestrowaliśmy swoją domenę.

Krok 1 – Skonfigurowanie serwera poprzez Docker Compose w Portainerze

Czy posiadasz już skonfigurowany serwer na swoim urządzeniu Synology? Jeśli nie, przeczytaj ten artykuł w celu przygotowania serwera, a następnie wróć tutaj, aby kontynuować dalszą konfigurację.

Krok 2 – Sprawdź dokumentację serwera Traccar

Aby rozpocząć konfigurację, sprawdź, na którym porcie komunikuje się Twój GPS. W ramach poniższej instrukcji użyjemy przykładowego urządzenia Teltonika model FMC003, które komunikuje się na porcie 5027.

Sprawdź listę wspieranych urządzeń na stronie oficjalnej dokumentacji technicznej

Lista wspieranych urządzeń przez Traccar

Krok 3 – Ustaw przekierowanie na swoim routerze

Aby GPS mógł poprawnie przekazywać dane do serwera, konieczne jest dopuszczenie portu do akceptacji oraz określenie, do którego adresu w ramach Twojej sieci LAN powinien być kierowany.

Przykładowo, na routerze Mikrotika:

  • Uruchom program WinBox i zaloguj się na swoje konto administratora,
  • Przejdź do zakładki IP, a następnie wybierz Firewall z menu.

Mikrotik WinBox

  • Kliknij zakładkę NAT

Mikrotik WinBox, Firewall

  • Kliknij w lewym górnym rogu okna na znak + w celu dodania nowej polityki przekierowania.
  • W zakładce General ustaw parametry opisane poniżej:
    • Chain: dstnat
    • Protocol: 6 (tcp)
    • Dst. Port: 5027
    • In. Interface List: WAN lub In. Interface: Wybierz swój interfejs WAN (zazwyczaj ether01)

WinBox konfiguracja NAT

  • Przejdź do zakładki Action i ustaw parametry opisane poniżej:
    • Action: dst-nat
    • (opcjonalnie) Zaznacz Log, w Log Prefix: wpisz [GPS]
    • To Addresses: IP-ADRES-SYNOLOGY
    • To Ports: 5027

WinBox konfiguracja NAT

Krok 4 – Ustaw firewall na Synology

Pakiety, aby bezproblemowo dotrzeć do serwera, muszą przejść przez wewnętrzny firewall w Synology. Po skonfigurowaniu Mikrotika w NAT pakiety już wiedzą, gdzie mają trafić. 

  • Zaloguj się na swoim serwerze plików i otwórz Panel Sterowania.

Panel Sterowania Synology

  • Przejdź do sekcji Bezpieczeństwo, a następnie kliknij w zakładkę Zapora sieciowa

Zapora sieciowa Synology

  • Przejdź do edycji reguł Profilu zapory sieciowej i nowo otwartym oknie kliknij Utwórz nową regułę zapory sieciowej.

Edytuj zaporę sieciową

  • W nowo otwartym oknie tworzenia reguły zapory sieciowej, ustaw parametry opisane poniżej:
    • Typ: Port docelowy
    • Protokół: TCP
    • Porty (oddzielaj przecinkami): 5027

Dodawanie portu do zapory sieciowej Synology

  • Zapisz konfigurację klikając w otwartych oknach OK. Wychodząc z edytowania reguł zapory sieciowej otrzymasz komunikat o zapisaniu pomyślnym ustawień zapory sieciowej.

Pomyślnie zapisane ustawienia

Krok 5 – Ustaw dodatkowy port utworzonego Docker Compose w Portainerze

  • Zaloguj się na swoje konto i przejdź do interfejsu administracyjnego.
    • Czy używasz systemu jednokrotnego logowania Authentik? Ułatw sobie proces logowania, integrując Portainera z Authentikiem za pomocą tej instrukcji.

Ekran logowania do Portainera

  • Wybierz swoje środowisko (eng: Environments) w którym będziesz edytować konfigurację utworzonego Docker Compose. Następnie przejdź do Stacks i wybierz utworzony Stacks o nazwie traccar.

Docker Compose w Portainerze

  • W górnej części pod nazwą Stack details przejdź do Editor.

Stack details w Portainer

  • W edytorze Docker Compose, w sekcji serwera Traccar, odnajdź definicję ports i dodaj nowy port zgodnie z poniższym przykładem:
ports:
      - "8082:8082"
      - "5027:5027"
  • Kliknij przycisk Update the stack i poczekaj, aż Portainer zaktualizuje zawartość.
  • Jeśli wszystko przebiegnie pomyślnie, w prawym górnym rogu ekranu pojawi sie komunikat Success: Stack successfully deployed.

Krok 6a – Wybór karty SIM do telemetrii

Aby zapewnić poprawne funkcjonowanie naszego systemu GPS, konieczne będzie uzyskanie karty SIM. Nie jest wymagany wysoki transfer danych, dlatego prawdę mówiąc zakup karty SIM z dostępem do sieci internetowej za 30-40 zł miesięcznie z limitem, na przykład 10 GB pakietu danych, byłby przesadą. Po przeprowadzeniu testów, znalazłem operatora wirtualnego 1nce, który umożliwia zakup karty SIM do zastosowań telemetrycznych za 10 Euro.

  • Po pierwsze – Ważność takiej karty to 10 lat,
  • Po drugie – 500 MB pakietu dostępu do sieci Internet
  • Po trzecie – 250 SMSów.
  • Po czwarte – karta posiada możliwość działania w około 165 krajach.

Karta dotarła do mnie zaledwie po trzech dniach od daty zamówienia na stronie internetowej operatora. W chwili obecnej zauważam, że średnie miesięczne zużycie mieści się w zakresie od 5 MB do 8 MB.
Data Usage in MB 1nce

Krok 6b – Konfiguracja parametrów urządzenia GPS

Jeżeli już posiadamy kartę SIM, którą wykorzystamy do GPSa – to możemy przejść do dalszej konfiguracji. Do ustawiania parametrów naszego GPSa od Teltoniki potrzebujemy programu Teltonika Configurator, który pobierzemy ze strony producenta pod tym linkiem.

Na wstępie instrukcji zaznaczyłem, że w ramach poniższych wytycznych będziemy korzystać z przykładowego urządzenia Teltonika model FMC003, które nawiązuje komunikację na porcie 5027.

Teltonika Configurator versions

Niestety, Teltonika Configurator jest dostępna jedynie dla systemów operacyjnych Windows. Aby korzystać z programu na systemach MacOS, konieczne będzie zastosowanie narzędzi do wirtualizacji, takich jak Parralels Desktop lub inne oprogramowanie umożliwiające uruchamianie systemów operacyjnych wirtualnych.

  • Po wejściu na stronę internetową dostarczającą różne wersje programu do konfiguracji GPSów, wybierz swoje urządzenie z dostępnej listy i pobierz odpowiednie oprogramowanie na komputer z systemem Windows. W przypadku naszego modelu FMC003, korzystamy z wersji konfiguratora 1.7.53_E.FMX00X_R.6, zgodnej z danymi dostępnymi w dniu tworzenia tego poradnika.

FMC003 Teltonika Configurator

Konfigurator stanowi wszechstronne narzędzie, które pozwala na konfigurację urządzenia, zarówno w przypadku natychmiastowego podłączenia do komputera, jak i w sytuacji tworzenia lub dostosowywania konfiguracji bez konieczności fizycznego połączenia z urządzeniem. W każdym przypadku istnieje możliwość skorzystania z opcji tworzenia nowej konfiguracji lub otwierania istniejącego pliku konfiguracyjnego.

  • Przed uruchomieniem oprogramowania na swoim komputerze, najpierw podłącz swoje urządzenie za pomocą kabla USB.
  • Po wybraniu swojego urządzenia z ekranu początkowego, kontynuuj, przechodząc do zakładki GPRS. Następnie, w sekcji Server Settings, wprowadź poniższe dane:
    • Domain: PUBLICZNY-ADRES-IP
    • Port: 5027
    • Protocol: TCP
    • TLS Encryption: None
  • Jeśli korzystamy z polecanej wcześniej karty SIM od operatora 1nce, należy dodatkowo skonfigurować sekcję GPRS Settings:
    • GPRS Context: Enable
    • APN: iot.1nce.net
    • APN Username: pusto
    • APN Password: pusto
    • GPRS Authentication: PAP

Teltonika Configurator

  • Po dostosowaniu własnych ustawień w urządzeniu GPS, zapisujemy wprowadzone parametry, klikając przycisk Save to device. Po potwierdzeniu przez konfigurator zapisania nowej konfiguracji na urządzeniu, możemy bezpiecznie odłączyć przewód USB od GPSa i podłączyć go do samochodu.

Teltonika Configurator

Krok 8 – Dodanie urządzenia do serwera Traccar

  • Zaloguj się do swojego konta, a następnie na lewej stronie ekranu kliknij ikonę +, aby dodać nowe urządzenie.

Traccar panel

  • Uzupełnij poniższe pola, korzystając z przedstawionych niżej wartości::
    • Required:
      • Name: Samochód osobowy,
      • Identifier: IMEI naszego GPSa (znajdziesz go na obudowie urządzenia obok numeru seryjnego).
    • Extra (opcjonalnie):
      • Group: np. Family cars (musisz utworzyć wcześniej w ustawieniach serwera),
      • Phone: np. MSISDN karty SIM przepisany z panelu administracyjnego 1nce,
      • Model: FMC003,
      • Contact: np. wpisz swoje imię i nazwisko
      • Category: Car
      • Calendar: brak
      • Expiration: 01/01/2099
    • Device Image (opcjonalnie):
      • Wgraj zdjęcie swojego samochodu
    • Attributes (opcjonalnie):
      • brak
  • Aby zatwierdzić wprowadzone parametry, kliknij Save. Poczekaj chwilę, aż GPS prześle komunikaty do naszego serwera.
  • Gotowe! 🚀

Po udanym zestawieniu połączenia między naszym serwerem, a zdalnym urządzeniem GPS zainstalowanym w samochodzie, będziemy w stanie zobaczyć jego aktualną pozycję. 

Dodatkowe źródła i Informacje:

W celu dalszego zgłębienia tematu i uzyskania szczegółowych informacji, polecam sprawdzenie poniższych linków. Są one wartościowymi źródłami, które zostały wykorzystane podczas opracowywania tego poradnika:

Filip Chochół

Filip Chochol runs two blogs: personal “chochol.io” and together with his girlfriend “Warsaw Travelers” about travel. He specializes in IT resource management and technical support, and has been active in the field of cyber security awareness for almost two years. A proponent of open-source technologies, he previously worked in the film and television industry in the camera division (2013-2021). After hours, he develops interests in smart homes and networking.

Komentarze (2)

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany. Wymagane pola są oznaczone *


This site uses Akismet to reduce spam. Learn how your comment data is processed.