Location Tracker für n8n

Ein umfassendes n8n-Workflow-System zur Standort-Verfolgung mit mehreren Datenquellen und erweiterten Visualisierungsmöglichkeiten.

Überblick

Dieses Repository enthält drei n8n-Workflows für Location Tracking mit verschiedenen Speicher- und Datenquellen-Optionen:

1. tracker.json - Telegram-basiert mit Datei-Speicherung (einfach, keine Datenbank)
2. tracker-db.json - Telegram-basiert mit NocoDB-Speicherung (produktionsreif, persistent)
3. tracker-mqtt.json - MQTT-basiert mit NocoDB-Speicherung (für OwnTracks/IoT-Geräte)

Zusätzlich bietet das Repository zwei Web-Oberflächen zur Visualisierung:

• index.html - Erweiterte Oberfläche mit Filterung, mehreren Kartenebenen und Multi-Source-Support
• index_owntrack.html - Vereinfachte Oberfläche mit MQTT-spezifischen Features (Batterie, Geschwindigkeit)

Funktionen

Workflow-Features

• Multi-Source-Erfassung: Standorte über Telegram-Bot oder MQTT/OwnTracks
• Flexible Speicherung: Wahl zwischen Datei-basiert (einfach) oder NocoDB (persistent, skalierbar)
• Historien-Verwaltung:
  • tracker.json: Letzte 100 Standorte (konfigurierbar)
  • tracker-db.json / tracker-mqtt.json: Unbegrenzt (Datenbank-basiert)
• REST-API: Einheitlicher /location Endpunkt für alle Workflows
• Telegram-Benachrichtigungen: Automatische Bestätigung mit Koordinaten und Kartenlink
• Echtzeit-Updates: 5-Sekunden Auto-Refresh für Live-Tracking

Web-Oberflächen-Features

• 📍 Interaktive Karten mit Leaflet.js
• 🗺️ Mehrere Kartenebenen: Standard, Satellit, Gelände, Dunkel-Modus
• 📡 Datenquellen-Filter: Telegram, MQTT oder kombiniert
• 👤 Benutzer/Geräte-Filter: Separate Ansicht pro Person/Gerät
• ⏱️ Zeitfilter: 1h, 6h, 24h, 7 Tage, 30 Tage
• 🔄 Toggle Auto-Refresh: An/Aus-Schaltung für Live-Updates
• 📊 Standort-Historie: Polyline-Darstellung des Bewegungspfads
• 🔋 MQTT-Telemetrie: Batterie, Geschwindigkeit, Genauigkeit (index_owntrack.html)

Voraussetzungen

Basis-Anforderungen (alle Workflows)

• Eine laufende n8n-Instanz (Version 1.0+)
• Zugriff auf n8n-Credentials-Management

Workflow-spezifische Anforderungen

tracker.json (Datei-basiert):

• Schreibrechte für /tmp/n8n-locations.json auf dem n8n-Server
• Telegram-Bot mit gültigem API-Token

tracker-db.json (NocoDB):

• NocoDB-Instanz mit API-Zugriff
• NocoDB-Token mit Schreibrechten
• Telegram-Bot mit gültigem API-Token

tracker-mqtt.json (MQTT):

• MQTT-Broker (z.B. Mosquitto)
• MQTT-Credentials mit Subscribe-Rechten auf owntracks/#
• NocoDB-Instanz (siehe tracker-db.json)
• OwnTracks-App oder kompatibles MQTT-Gerät

Installation

Schritt 1: Workflow wählen und importieren

Wähle den passenden Workflow für deinen Anwendungsfall:

Workflow	Empfohlen für	Vorteile	Nachteile
tracker.json	Testen, Prototyping	Einfach, keine DB nötig	Begrenzte Historie, /tmp-Speicher
tracker-db.json	Produktion (Telegram)	Persistent, unbegrenzt	NocoDB erforderlich
tracker-mqtt.json	IoT-Geräte, OwnTracks	Multi-Gerät-Support	MQTT-Broker + NocoDB

Import-Schritte:

1. Öffne deine n8n-Instanz
2. Navigiere zu "Workflows" → "Import from File"
3. Wähle die gewünschte .json Datei aus

Schritt 2: Credentials konfigurieren

Telegram-Bot (tracker.json & tracker-db.json)

1. Erstelle einen Bot über @BotFather:

   /newbot
   Wähle Name: "My Location Tracker"
   Wähle Username: "my_location_tracker_bot"
   

2. Kopiere das API-Token (Format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
3. In n8n:
   • Gehe zu "Credentials" → "Create New"
   • Wähle "Telegram API"
   • Gib das Access Token ein
   • Speichere als "Telegram account n8n-munich-bot" (oder passe Workflow-Nodes an)

NocoDB (tracker-db.json & tracker-mqtt.json)

1. Erstelle in NocoDB:
   • Ein neues Project
   • Eine Tabelle mit dem Schema (siehe unten)
2. Generiere einen API-Token:
   • NocoDB: Account Settings → Tokens → Create Token
3. In n8n:
   • Gehe zu "Credentials" → "Create New"
   • Wähle "NocoDB API Token"
   • Gib Token und Base-URL ein
   • Notiere die Credential-ID für den Workflow

NocoDB Tabellen-Schema:

Tabelle: Locations
- latitude (Decimal)
- longitude (Decimal)
- timestamp (DateTime)
- user_id (Number)
- first_name (Text)
- last_name (Text)
- username (Text)
- marker_label (Text)
- display_time (Text)
- chat_id (Number)

MQTT-Broker (tracker-mqtt.json)

1. Installiere einen MQTT-Broker (z.B. Mosquitto):

   # Ubuntu/Debian
   sudo apt install mosquitto mosquitto-clients
   

2. In n8n:
   • Gehe zu "Credentials" → "Create New"
   • Wähle "MQTT"
   • Gib Broker-URL, Port, Username, Passwort ein
3. Passe im Workflow die Credential-ID an (aktuell Platzhalter: MQTT_CREDENTIAL_ID)

Schritt 3: Workflow-IDs anpassen (nur bei NocoDB)

Öffne den importierten Workflow und passe an:

• Project ID: Deine NocoDB-Projekt-ID
• Table ID: Deine NocoDB-Tabellen-ID

Diese findest du in der NocoDB-URL:

https://nocodb.example.com/nc/PROJECT_ID/TABLE_ID

Schritt 4: Workflow aktivieren

1. Öffne den importierten Workflow
2. Prüfe alle Credentials (rote Nodes = fehlende/falsche Credentials)
3. Klicke auf "Active" um den Workflow zu aktivieren

Schritt 5: Testen

Telegram-Workflows:

1. Öffne deinen Telegram-Bot
2. Sende einen Standort (📎 → Standort)
3. Du solltest eine Bestätigungsnachricht erhalten

MQTT-Workflow:

1. Konfiguriere OwnTracks-App mit deinem MQTT-Broker
2. Sende einen Location-Update
3. Prüfe in n8n die Workflow-Execution-Historie

Verwendung

Standort senden (Telegram)

1. Öffne den Chat mit deinem Telegram-Bot
2. Klicke auf das Büroklammer-Symbol (📎)
3. Wähle "Standort"
4. Sende deinen aktuellen Standort oder wähle einen auf der Karte
5. Der Bot bestätigt mit Details und einem Link zur Web-Ansicht

Standort senden (MQTT/OwnTracks)

1. OwnTracks-App konfigurieren:

   • Mode: MQTT
   • Host: Dein MQTT-Broker
   • Port: 1883 (oder dein Port)
   • Username/Password: Deine MQTT-Credentials
   • Device ID: z.B. "le" (wird als Marker-Label verwendet)

2. Tracking starten:

   • OwnTracks sendet automatisch Location-Updates
   • Konfiguriere Intervall und Genauigkeit in der App

REST-API abrufen

Alle Workflows stellen den gleichen API-Endpunkt zur Verfügung:

GET https://deine-n8n-instanz.de/webhook/location

Beispiel-Antwort:

{
  "success": true,
  "current": {
    "latitude": 48.1351,
    "longitude": 11.5820,
    "timestamp": "2025-11-14T10:30:00.000Z",
    "user_id": 123456789,
    "first_name": "Max",
    "last_name": "Mustermann",
    "username": "maxmuster",
    "marker_label": "Max Mustermann",
    "display_time": "14.11.2025, 11:30:00",
    "chat_id": 123456789
  },
  "history": [...],
  "total_points": 42,
  "last_updated": "2025-11-14T10:30:00.000Z"
}

MQTT-spezifische Felder (nur in index_owntrack.html angezeigt):

{
  "battery": 85,
  "speed": 5.2,
  "accuracy": 10,
  "altitude": 520
}

Web-Oberflächen

Das Repository enthält zwei Web-Interfaces mit unterschiedlichen Features:

index.html - Erweiterte Multi-Source-Oberfläche

Empfohlen für: Produktionsumgebungen mit mehreren Datenquellen

Features:

• 🗺️ 4 Kartenebenen: Standard (OSM), Satellit (Esri), Gelände (OpenTopoMap), Dunkel (CartoDB)
• 📡 Datenquellen-Filter: Telegram, MQTT oder alle
• 👤 Benutzer/Gerät-Filter: Dynamische Liste aller aktiven Quellen
• ⏱️ Zeitfilter: 1h, 6h, 24h, 7d, 30d oder alle
• 📊 Erweiterte Visualisierung: Farbcodierte Marker (rot=neuester, blau=Historie)
• 🔄 Auto-Refresh: Toggle-fähig, 5-Sekunden-Intervall

Verwendung:

1. Öffne index.html im Browser
2. Nutze die Filter-Dropdowns zur Datenauswahl:
   • Kartenebene: Wähle zwischen Standard, Satellit, Gelände, Dunkel
   • Datenquelle: Telegram, MQTT oder beide
   • Benutzer/Gerät: Filter nach spezifischem User/Device
   • Zeitraum: Begrenze Historie auf gewünschten Zeitraum
3. Klicke Marker für Details
4. Toggle Auto-Refresh nach Bedarf

index_owntrack.html - MQTT/OwnTracks-fokussierte Oberfläche

Empfohlen für: OwnTracks-Nutzer, die Telemetrie-Daten benötigen

Features:

• 🔋 Batteriestatus: Anzeige des Gerätebatteriestands
• 🚗 Geschwindigkeitsanzeige: km/h-Anzeige aus MQTT-Daten
• 📍 Vereinfachte Ansicht: Fokus auf aktuellen Standort
• 🔄 Auto-Refresh: Gleicher Toggle wie index.html

Verwendung:

1. Öffne index_owntrack.html im Browser
2. Die Karte zeigt automatisch den neuesten OwnTracks-Standort
3. Popups enthalten MQTT-spezifische Daten (Batterie, Speed)

Konfiguration der Web-Oberflächen

API-Endpunkt anpassen:

In beiden HTML-Dateien die API-URL ändern:

// Für index.html (Zeile 175)
// Für index_owntrack.html (Zeile 85)
const API_URL = 'https://deine-n8n-instanz.de/webhook/location';

Deployment-Optionen:

1. Webserver-Hosting (empfohlen für Produktion):

   # Apache
   cp index.html /var/www/html/tracker/
   
   # nginx
   cp index.html /usr/share/nginx/html/tracker/
   

2. Lokaler Test:

   • Öffne die .html Datei direkt im Browser
   • Funktioniert nur, wenn CORS korrekt konfiguriert ist

3. GitHub Pages / Static Hosting:

   • Pushe die HTML-Dateien zu GitHub
   • Aktiviere GitHub Pages
   • Oder nutze Netlify, Vercel, etc.

CORS-Konfiguration: Die n8n-Workflows haben CORS bereits aktiviert (Access-Control-Allow-Origin: *). Für Produktion sollte dies eingeschränkt werden (siehe Sicherheitshinweise)

Workflow-Architektur

tracker.json (Datei-basiert)

Standort-Erfassung:

Telegram Trigger
    ↓
Hat Location? (Filter)
    ↓
Location verarbeiten (JS: Daten extrahieren & formatieren)
    ↓
Lade existierende Daten (Shell: cat /tmp/n8n-locations.json)
    ↓
Merge mit History (JS: Array merge + 100-Entry-Limit)
    ↓
Speichere in File (Shell: echo > /tmp/n8n-locations.json)
    ↓
Telegram Bestätigung (Nachricht mit Koordinaten & Kartenlink)

API-Endpunkt:

Webhook - Location API (GET /webhook/location)
    ↓
Lade Daten für API (Shell: cat /tmp/n8n-locations.json)
    ↓
Format API Response (JS: JSON strukturieren)
    ↓
JSON Response (CORS + JSON zurückgeben)

tracker-db.json (NocoDB)

Standort-Erfassung:

Telegram Trigger
    ↓
Hat Location? (Filter)
    ↓
Location verarbeiten (JS: Daten extrahieren & formatieren)
    ↓
Speichere in NocoDB (NocoDB: Create Record)
    ↓
[Parallel]
    ↓
Hole letzten Eintrag (NocoDB: List Records, Limit 1, Sort desc)
    ↓
Zähle Einträge (NocoDB: Count)
    ↓
Merge (JS: Combine Results)
    ↓
Bereite Bestätigung vor (JS: Format Message)
    ↓
Telegram Bestätigung (Nachricht mit Stats & Link)

API-Endpunkt:

Webhook - Location API (GET /webhook/location)
    ↓
Lade Daten aus NocoDB (NocoDB: List Records, Sort by timestamp desc)
    ↓
Format API Response (JS: JSON strukturieren)
    ↓
JSON Response (CORS + JSON zurückgeben)

tracker-mqtt.json (MQTT/OwnTracks)

Standort-Erfassung (vereinfachter Single-Path):

MQTT Trigger (Topic: owntracks/#)
    ↓
Ist Location? (Filter: _type === "location")
    ↓
MQTT Location verarbeiten (JS: OwnTracks → NocoDB Schema Mapping)
    ↓
Speichere in NocoDB (NocoDB: Create Record)

Keine separate Bestätigung (MQTT ist unidirektional)

API-Endpunkt: Shared mit tracker-db.json (gleiche NocoDB-Tabelle)

Datenspeicherung & Schema

tracker.json (Datei-basiert)

Speicherung:

• Speicherort: /tmp/n8n-locations.json
• Format: JSON-Array mit Location-Objekten
• Maximale Einträge: 100 (älteste werden automatisch entfernt)
• Persistenz: Überlebt n8n-Neustarts, aber nicht System-Neustarts (da /tmp)

Empfehlung für Produktion: Ändere den Speicherort zu einem persistenten Pfad:

In den Nodes "Lade existierende Daten" und "Lade Daten für API":

cat /var/lib/n8n/locations.json 2>/dev/null || echo '[]'

In Node "Speichere in File":

echo '...' > /var/lib/n8n/locations.json

tracker-db.json & tracker-mqtt.json (NocoDB)

Speicherung:

• Backend: NocoDB Datenbank
• Project ID: pdxl4cx4dbu9nxi (Beispiel - muss angepasst werden)
• Table ID: m8pqj5ixgnnrzkg (Beispiel - muss angepasst werden)
• Maximale Einträge: Unbegrenzt (Datenbank-basiert)
• Persistenz: Vollständig persistent
• Shared Database: Beide Workflows nutzen die gleiche Tabelle

Location-Objekt Schema

Alle Workflows nutzen das gleiche Schema für Konsistenz:

{
  "latitude": 48.1351,              // Decimal (Breitengrad)
  "longitude": 11.5820,             // Decimal (Längengrad)
  "timestamp": "2025-11-14T10:30:00.000Z",  // ISO 8601 DateTime
  "user_id": 123456789,             // Number (Telegram ID oder 0 für MQTT)
  "first_name": "Max",              // Text (Telegram: Vorname, MQTT: tracker ID)
  "last_name": "Mustermann",        // Text (Telegram: Nachname, MQTT: source)
  "username": "maxmuster",          // Text (Telegram: @username, MQTT: tracker ID)
  "marker_label": "Max Mustermann", // Text (Anzeigename für Karte)
  "display_time": "14.11.2025, 11:30:00",  // Text (de-DE formatiert)
  "chat_id": 123456789              // Number (Telegram Chat ID oder 0 für MQTT)
}

Unterscheidung Telegram vs. MQTT

In der Datenbank/API können Einträge anhand folgender Felder unterschieden werden:

Feld	Telegram	MQTT/OwnTracks
user_id	Echte Telegram-User-ID (z.B. 123456789)	0
chat_id	Echte Telegram-Chat-ID (z.B. 123456789)	0
first_name	Telegram-Vorname (z.B. "Max")	Tracker-ID (z.B. "le")
last_name	Telegram-Nachname (z.B. "Mustermann")	Source (z.B. "fused")
marker_label	"Vorname Nachname"	"TID @ SSID" (z.B. "le @ HomeWifi")

MQTT-spezifische Daten

OwnTracks sendet zusätzliche Telemetrie-Daten, die nicht in der Datenbank gespeichert werden, aber im Node "MQTT Location verarbeiten" verfügbar sind:

{
  "acc": 10,        // Genauigkeit in Metern
  "alt": 520,       // Höhe über Meeresspiegel
  "batt": 85,       // Batteriestatus (0-100%)
  "vel": 5,         // Geschwindigkeit (m/s)
  "conn": "w",      // Verbindungstyp (w=WiFi, m=Mobile)
  "t": "u"          // Trigger (u=User, t=Timer, etc.)
}

Diese Daten können bei Bedarf zum Schema hinzugefügt werden (erfordert Anpassung der NocoDB-Tabelle und Workflows)

Anpassungen & Customization

Anzahl gespeicherter Standorte ändern (nur tracker.json)

Im Node "Merge mit History" die Limit-Logik anpassen:

// Aktuell: 100 Einträge
if (locations.length > 100) {
  locations = locations.slice(0, 100);
}

// Ändern zu z.B. 500 Einträge:
if (locations.length > 500) {
  locations = locations.slice(0, 500);
}

Hinweis: NocoDB-Workflows haben kein Client-Side-Limit.

Datumsformat ändern

Im Node "Location verarbeiten" (Telegram) oder "MQTT Location verarbeiten" (MQTT) das Locale anpassen:

// Aktuell: Deutsch (de-DE)
const displayTime = new Date(messageDate * 1000).toLocaleString('de-DE');

// Ändern zu z.B. Englisch (en-US):
const displayTime = new Date(messageDate * 1000).toLocaleString('en-US');

// Oder eigenes Format:
const displayTime = new Date(messageDate * 1000).toLocaleString('de-DE', {
  year: 'numeric',
  month: '2-digit',
  day: '2-digit',
  hour: '2-digit',
  minute: '2-digit',
  second: '2-digit'
});

CORS-Beschränkung (Sicherheit)

Im Node "Webhook - Location API" unter Options → Response Headers:

// Aktuell (unsicher für Produktion): Alle Origins erlaubt
"Access-Control-Allow-Origin": "*"

// Besser für Produktion: Spezifische Domain
"Access-Control-Allow-Origin": "https://deine-domain.de"

// Oder mehrere Domains (erfordert Logik im Node):
// const allowedOrigins = ['https://domain1.de', 'https://domain2.de'];
// const origin = request.headers.origin;
// return allowedOrigins.includes(origin) ? origin : allowedOrigins[0];

Auto-Refresh Intervall anpassen

In index.html oder index_owntrack.html:

// Aktuell: 5 Sekunden (5000ms)
refreshInterval = setInterval(loadLocations, 5000);

// Ändern zu z.B. 10 Sekunden:
refreshInterval = setInterval(loadLocations, 10000);

// Oder 30 Sekunden:
refreshInterval = setInterval(loadLocations, 30000);

MQTT Topic ändern

Im Node "MQTT Trigger" (tracker-mqtt.json):

// Aktuell: Alle OwnTracks-Topics
Topic: owntracks/#

// Ändern zu spezifischem User/Device:
Topic: owntracks/joachim/phone

// Oder eigene Topic-Struktur:
Topic: location/+/+  // location/user/device

Passe auch den Filter-Node "Ist Location?" entsprechend an.

NocoDB Tabellen-Felder erweitern

Um MQTT-Telemetrie-Daten zu speichern:

1. In NocoDB: Füge neue Spalten hinzu:

   • battery (Number)
   • speed (Decimal)
   • accuracy (Number)
   • altitude (Number)

2. Im Workflow (Node "MQTT Location verarbeiten"):

   // Füge zu locationData hinzu:
   battery: json.batt || null,
   speed: json.vel || null,
   accuracy: json.acc || null,
   altitude: json.alt || null
   

3. In index_owntrack.html: Daten sind bereits ausgelesen (Zeilen 137-145)

Kartenebene Standardauswahl ändern

In index.html:

// Aktuell: Standard (OSM)
let currentLayer = mapLayers.standard;

// Ändern zu z.B. Satellit:
let currentLayer = mapLayers.satellite;

// Und Dropdown synchronisieren:
document.getElementById('mapLayerSelect').value = 'satellite';

Sicherheitshinweise

Kritisch (vor Produktionseinsatz beheben!)

1. API-Authentifizierung fehlt:

   • Der /location Endpunkt ist öffentlich ohne Authentifizierung zugänglich
   • Jeder kann Standortdaten abrufen, wenn er die URL kennt
   • Empfehlung: Implementiere API-Key-Authentifizierung in n8n oder nutze einen Reverse-Proxy mit Auth

2. CORS für alle Origins offen:

   • Access-Control-Allow-Origin: * erlaubt Zugriff von jeder Domain
   • Risiko: Cross-Site-Scripting (XSS), Datenabfluss
   • Empfehlung: Beschränke auf deine spezifische Domain (siehe Anpassungen)

3. Standortdaten sind hochsensibel (DSGVO):

   • Personenbezogene Daten (Name, User-ID, exakte Koordinaten)
   • Pflichten: Informationspflicht, Einwilligung, Löschkonzept
   • Empfehlung:
     • Hole explizite Einwilligung von Nutzern ein
     • Implementiere automatische Löschung alter Daten (z.B. >30 Tage)
     • Dokumentiere Datenschutzmaßnahmen

Wichtig (empfohlene Sicherheitsmaßnahmen)

4. Credentials-Sicherheit:

   • Telegram-Bot-Token: Niemals in Code oder Logs speichern
   • NocoDB-Token: Nutze Read-Only-Token für API-Endpunkt (wenn möglich)
   • MQTT-Credentials: Nutze TLS-Verschlüsselung (Port 8883)

5. File-basierte Speicherung (tracker.json):

   • /tmp Verzeichnis ist evtl. für andere Benutzer lesbar
   • Empfehlung: Setze Dateiberechtigungen (chmod 600)
   • Besser: Nutze NocoDB-Variante für Produktion

6. Rate Limiting fehlt:

   • API kann beliebig oft abgerufen werden
   • Risiko: DoS-Angriff, Server-Überlastung
   • Empfehlung: Implementiere Rate Limiting (z.B. via nginx)

Best Practices

• HTTPS erzwingen: Stelle sicher, dass n8n-Webhooks nur über HTTPS erreichbar sind
• Monitoring: Überwache ungewöhnliche API-Zugriffe
• Backup: Sichere NocoDB-Datenbank regelmäßig
• Updates: Halte n8n, NocoDB und alle Dependencies aktuell

Fehlerbehebung

Telegram-Bot antwortet nicht

Symptome: Standort wird gesendet, aber keine Bestätigung

Lösungen:

1. Prüfe, ob Workflow aktiv ist (grüner "Active"-Toggle in n8n)
2. Prüfe Telegram-Credentials:

   # In n8n: Credentials → Telegram → Test Connection
   

3. Prüfe Workflow-Execution-Historie:
   • n8n → Workflows → tracker → Executions
   • Suche nach Fehlermeldungen (rot markiert)
4. Prüfe Telegram-Bot-Webhook:

   curl https://api.telegram.org/bot<TOKEN>/getWebhookInfo
   

API gibt leere/fehlerhafte Daten zurück

Symptome: API antwortet mit [], null oder HTTP 500

Lösungen:

Für tracker.json (Datei-basiert):

1. Prüfe, ob Datei existiert:

   ls -la /tmp/n8n-locations.json
   

2. Prüfe Dateiinhalt:

   cat /tmp/n8n-locations.json | jq .
   

3. Prüfe Berechtigungen:

   # n8n-User muss lesen können
   chmod 644 /tmp/n8n-locations.json
   

Für tracker-db.json/tracker-mqtt.json (NocoDB):

1. Teste NocoDB-Verbindung in n8n (Credentials → Test)
2. Prüfe Project/Table IDs im Workflow
3. Prüfe NocoDB-API direkt:

   curl -H "xc-token: YOUR_TOKEN" \
     https://nocodb.example.com/api/v1/db/data/v1/PROJECT_ID/TABLE_ID
   

MQTT-Daten kommen nicht an (tracker-mqtt.json)

Symptome: OwnTracks sendet, aber nichts in NocoDB gespeichert

Lösungen:

1. Teste MQTT-Broker-Verbindung:

   mosquitto_sub -h broker.example.com -p 1883 -u user -P pass -t 'owntracks/#' -v
   

2. Prüfe OwnTracks-Konfiguration:
   • Mode: MQTT (nicht HTTP!)
   • Topic: owntracks/USER/DEVICE
   • TLS: Nur wenn Broker TLS nutzt
3. Prüfe n8n MQTT-Node:
   • Credentials korrekt
   • Topic-Pattern passt (owntracks/#)
4. Prüfe Workflow-Filter:
   • Node "Ist Location?" muss _type: "location" filtern
5. Debug mit Workflow-Execution:
   • Trigger manuell mit Test-Payload

   {
     "_type": "location",
     "lat": 48.1351,
     "lon": 11.5820,
     "tid": "le",
     "tst": 1731582600
   }
   

Web-Oberfläche zeigt keine Karte

Symptome: Weiße Seite, Karte lädt nicht, Marker fehlen

Lösungen:

1. Prüfe Browser-Console (F12 → Console):
   • CORS-Fehler? → Siehe Sicherheitshinweise
   • 404 auf Leaflet.js? → CDN-Problem, lokale Kopie nutzen
   • API-Fehler? → Siehe "API gibt leere Daten zurück"
2. Prüfe API-URL in HTML:

   // index.html Zeile 175
   // index_owntrack.html Zeile 85
   const API_URL = 'https://...';  // Muss erreichbar sein!
   

3. Teste API direkt im Browser:

   https://deine-n8n-instanz.de/webhook/location
   

   Sollte JSON zurückgeben, nicht HTML/Fehlerseite
4. Prüfe Netzwerk-Tab (F12 → Network):
   • Status 200 für API-Request?
   • CORS-Header vorhanden?

Koordinaten sind falsch/vertauscht

Symptome: Marker erscheinen im Meer, falsche Position

Lösungen:

1. Prüfe Reihenfolge: Latitude (Breitengrad) kommt vor Longitude (Längengrad)
   • Richtig: [48.1351, 11.5820] (lat, lon)
   • Falsch: [11.5820, 48.1351] (lon, lat)
2. Prüfe MQTT-Mapping (nur tracker-mqtt.json):
   • Node "MQTT Location verarbeiten"
   • latitude: json.lat (nicht json.lon!)
3. Prüfe String-Parsing:

   // Koordinaten müssen Numbers sein, nicht Strings!
   const lat = parseFloat(loc.latitude);  // Gut
   const lat = loc.latitude;              // Schlecht, wenn String
   

Standorte verschwinden nach System-Neustart (tracker.json)

Symptome: Nach Neustart des Servers sind alle Standorte weg

Ursache: /tmp wird bei System-Neustart geleert

Lösungen:

1. Kurzfristig: Nutze persistenten Pfad (siehe "Datenspeicherung & Schema")
2. Langfristig: Wechsele zu tracker-db.json (NocoDB)

Repository-Inhalte

Datei	Beschreibung	Typ
tracker.json	Telegram + Datei-Speicherung	n8n Workflow
tracker-db.json	Telegram + NocoDB	n8n Workflow
tracker-mqtt.json	MQTT/OwnTracks + NocoDB	n8n Workflow
index.html	Erweiterte Multi-Source Web-UI	HTML/JavaScript
index_owntrack.html	MQTT-fokussierte Web-UI	HTML/JavaScript
locations-example.csv	Beispieldaten für Tests	CSV
README.md	Diese Dokumentation	Markdown
CLAUDE.md	Technische Architektur-Doku	Markdown

Lizenz

Dieses Projekt steht unter der MIT-Lizenz zur freien Verfügung.

Support & Contributing

• Issues: Melde Bugs oder Feature-Requests via GitHub Issues
• Pull Requests: Beiträge sind willkommen!
• Fragen: Öffne eine Discussion auf GitHub

Roadmap (Potenzielle Features)

• API-Authentifizierung (API-Key, JWT)
• Automatische Datenlöschung (DSGVO-Compliance)
• Geofencing / Location-Alerts
• Multi-Tenant-Support (mehrere Bots)
• Erweiterte Statistiken (Distanz, Durchschnittsgeschwindigkeit)
• Export-Funktion (GPX, KML)
• Push-Notifications bei Location-Updates
• Offline-Support für Web-UI (PWA)