🛡️ CrowdSec Threat Map

Echtzeit-Angriffskarte — direkt aus eurer lokalen CrowdSec-Datenbank

📸 Preview

Interaktive Weltkarte · Animierte Angriffspfeile · Live-Feed · Mobile-ready

✨ Features

• 🌍 Interaktive Weltkarte mit animierten Angriffspfeilen (D3.js)
• 🎯 Auto-Fit Zoom — alle Angriffspunkte automatisch sichtbar
• 🔍 Echtzeit-Suche nach IP, Land, Stadt, Szenario, ASN
• 🚫📋 Ban-Status-Anzeige — 🚫 aktiver Ban / 📋 nur Alert/Historie
• 🔓 IP-Unban direkt aus dem Dashboard — löscht Decision UND Alert
• 📊 Sparkline — Angriffe/Stunde auf einen Blick
• 🎨 4 Farbthemen — Cyan, Alarm-Rot, Matrix-Grün, Amber
• 📥 CSV-Export — direkt neben den Feed-Seitenzahlen
• 📱 Vollständig responsive — Desktop und Mobile
• 〰️ Linien-Toggle — Angriffspfeile & Radar-Ringe ein-/ausblenden
• 🛡️ Dynamische IP-Whitelist — eigene IP automatisch alle 15 Min whitelisten
• 🟢 Whitelist-Badge — zeigt aktuelle IP + Status live im Dashboard
• 🌐 Sprache per Variable — LANGUAGE=de oder LANGUAGE=en in docker-compose
• 🏙️ Lokalisierte Stadtnamen — Nürnberg statt Nuremberg, München statt Munich etc.
• 📍 Korrigierte GeoIP — Vogtland/Plauen korrekt statt falscher Grenzregion

🚀 Installation — Unraid (App Store)

1. App Store öffnen

Unraid → Apps → Suchfeld: crowdsec-threat-map → Installieren

2. Pflichtfelder ausfüllen

Koordinaten finden: Rechtsklick auf Google Maps → „Was ist hier?"

CrowdSec-Pfad finden:

docker inspect crowdsec | grep -A5 "Mounts"
# → "Source": "/mnt/user/Docker/crowdsec/data"

3. Optionale Einstellungen

4. Starten

Auf Anwenden klicken → Container startet automatisch.

Dashboard: http://EURE-UNRAID-IP:8080

🚀 Installation — Docker

docker run -d \
  --name crowdsec-monitor \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /pfad/zu/crowdsec/data:/crowdsec/data:ro \
  -v /pfad/zu/crowdsec/postoverflows:/crowdsec/postoverflows \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --group-add 999 \
  -e SERVER_LAT=52.5200 \
  -e SERVER_LON=13.4050 \
  -e SERVER_NAME=Berlin \
  -e LANGUAGE=de \
  ghcr.io/kabelsalatundklartext/crowdsec-threat-map-docker:latest

Oder mit docker-compose.yml — die aktuelle Version findet ihr im Repository unter docker/docker-compose.yml.

⚙️ Alle Variablen

🔒 Sicherheit

Das Dashboard kann über den eingebundenen Docker-Socket CrowdSec-Bans aufheben (cscli). Behandelt Port 8080 daher wie eine Admin-Oberfläche:

Token setzen (Beispiel):

- UNBAN_API_TOKEN=a1b2c3d4e5f6...   # lang und zufällig

Ohne Token bleibt Unban wie bisher möglich — beim Start erscheint im Container-Log ein Hinweis.

Technische Absicherungen (ab v1.4.3):

• IP-Validierung (IPv4/IPv6) vor jedem Unban und bei der dynamischen Whitelist
• Kein offenes CORS mehr auf /unban
• Cooldown für automatische CrowdSec-Neustarts (CROWDSEC_RESTART_COOLDOWN)

📦 Volumes

Unraid-Beispielpfade:

• /mnt/user/Docker/crowdsec/data
• /mnt/user/Docker/crowdsec/postoverflows

🛡️ Dynamische IP-Whitelist

Heimanschlüsse bekommen meist täglich eine neue IP. Ohne Whitelist kann CrowdSec euch selbst bannen. Der eingebaute Hintergrund-Thread prüft alle 15 Minuten eure aktuelle öffentliche IP und aktualisiert die Whitelist-YAML automatisch.

Voraussetzungen:

• WHITELIST_ENABLED=true (Standard)
• Volume /crowdsec/postoverflows eingebunden
• /var/run/docker.sock eingebunden
• Docker-GID korrekt gesetzt (--group-add 999 bzw. in Unraid über group_add)

Wie es funktioniert:

1. Exporter ermittelt eure aktuelle öffentliche IP
2. Vergleich mit der aktuellen Whitelist-YAML
3. Bei Änderung: YAML wird aktualisiert, CrowdSec wird neu gestartet
4. Wartezeit nach Neustart konfigurierbar via CROWDSEC_RESTART_WAIT

Dashboard-Badge:

🔓 IP-Unban

Mit UNBAN_API_TOKEN ist der Unban-Endpunkt geschützt; das Dashboard sendet den Token automatisch mit.

Jeder Feed-Eintrag zeigt den Ban-Status direkt an:

🗺️ GeoIP & Stadtanzeige

Ohne GeoIP-Datenbank werden keine Städte angezeigt, nur Länderpunkte.

GeoLite2-City.mmdb einrichten:

1. Kostenlos registrieren: MaxMind GeoLite2
2. GeoLite2-City.mmdb herunterladen
3. In euren CrowdSec-Datenordner legen (gleicher Ordner wie crowdsec.db)
4. Container neu starten

🛠️ Fehlerbehebung

Dashboard leer / keine Daten:

docker logs crowdsec-monitor
curl http://EURE-IP:8080/metrics | head -10

Falscher CrowdSec-Pfad:

docker inspect crowdsec | grep -A5 "Mounts"

Unban funktioniert nicht:

# Docker-GID prüfen
getent group docker | cut -d: -f3
# → In Unraid unter "Extra Parameters" als --group-add eintragen

# Bei gesetztem UNBAN_API_TOKEN: 401 = Token fehlt oder falsch
curl -X POST http://EURE-IP:8080/unban \
  -H "Content-Type: application/json" \
  -H "X-API-Token: DEIN-TOKEN" \
  -d '{"ip":"1.2.3.4"}'

Whitelist-Fehler:

curl http://EURE-IP:8080/whitelist-status

Dashboard zeigt Verbindungsfehler:

# Prüfen ob entrypoint.sh die URL korrekt gesetzt hat
docker exec crowdsec-monitor grep "EXPORTER_URL" /var/www/html/index.html
# → Sollte '/metrics' zeigen

📋 Changelog

Vollständige Versionshistorie → CHANGELOG.md

🔗 Links

• MaxMind GeoLite2 — kostenlose GeoIP-Datenbank
• CrowdSec Docker Hub
• CrowdSec Docs

📄 Lizenz

GNU General Public License v3.0 (GPL-3.0)

Bei Weitergabe oder Veröffentlichung: Namensnennung + GPL-3.0-Lizenz beibehalten.

"CrowdSec Threat Map" von kabelsalatundklartext — GitHub