Access Log — Anmeldeverlauf, IP und Standort für Emby

Access Log führt den Anmeldeverlauf deines Emby-Servers: Es zeichnet jede Authentifizierung auf und zeigt sie in einer übersichtlichen Tabelle: Benutzer, Zeit, IP-Adresse, Gerät und App sowie den ungefähren Standort aus der GeoLite2-Datenbank.

Was es macht

• Jede Anmeldung und jeder Fehlversuch, mit Benutzer, IP, Client-App, Gerätename und Version.
• Standort (Land, Stadt) aus einer lokalen GeoLite2-Datenbank — keine Daten verlassen deinen Server.
• Filter nach Benutzer, Zeitraum, Land und Gerät; Export als CSV.
• Aufbewahrungsdauer einstellbar, damit das Protokoll so lange bleibt, wie du es brauchst.

Voraussetzungen

• Emby Server 4.10.1 oder neuer.
• Optional: ein kostenloses MaxMind-Konto für die Datenbanken GeoLite2 City und ASN (Standorte); ohne Konto wird keine Datenbank heruntergeladen.

Häufige Fragen

Wie sehe ich, wer sich an meinem Emby-Server angemeldet hat, und von wo? Installiere Access Log und füge die kostenlose Datenbank GeoLite2 City hinzu. Jede Anmeldung und jeder Fehlversuch erscheint dann auf der Plugin-Seite mit Benutzer, IP, Gerät, App, Land und Stadt; filtere nach Benutzer, Zeitraum, Land oder Gerät oder exportiere als CSV. Siehe die Anleitung.

Werden für den Standort Daten außerhalb meines Servers gesendet? Nein. Der Standort kommt aus der GeoLite2-Datenbank, die auf deinem Server gespeichert ist.

Was es wohin sendet

• MaxMind GeoLite2 (download.maxmind.com) — optional, standardmäßig aus: Nur wenn du dein eigenes kostenloses MaxMind-Konto (Account ID + License Key) einträgst, lädt das Plugin die Datenbanken GeoLite2 City und ASN herunter (mit deinem Konto authentifiziert; es werden keine IP-Adressen oder Benutzerdaten gesendet). Aktualisiert, wenn sie älter als 7 Tage sind (einstellbar).
• Die IP-Geolokalisierung erfolgt lokal, in der heruntergeladenen Datenbank; IP-Adressen werden nie an einen externen Dienst gesendet. Private/lokale Adressen werden nicht nachgeschlagen.
• Warnungen (neues Gerät, neues Land, gehäufte Fehlanmeldungen) gehen nur in das lokale Aktivitätsprotokoll des Servers.
• Keine CDN-Skripte oder externen Schriftarten in den Seiten.
• Dazu der Lizenz-Client, in jedem Plugin gleich: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert (Datenordner des Plugins):

• events/events-YYYY-MM.jsonl: jede Anmeldung / jeder Fehlversuch / jede Wiedergabe / jede Adressänderung — Zeit, Benutzer, IP, Standort (Land, Region, Stadt, ungefähre Koordinaten, ASN/ISP), Zugriffsweg (direkt oder über Cloudflare, Host, User-Agent, X-Forwarded-For-Kette), App, Version, Gerät, Sitzung. Das versuchte Passwort wird nie gespeichert.
• events/known.json: bekannte Geräte und Länder pro Benutzer (ohne Ablauf).
• geoip/*.mmdb: die MaxMind-Datenbanken. Die MaxMind-Account-ID steht in der Plugin-Konfiguration; der MaxMind-License-Key wird verschlüsselt in secrets.enc.json im Datenordner des Plugins gespeichert (AES-256-GCM, zufälliger Schlüssel aus secrets.key, an die Server-ID gebunden, beide Dateien mit Modus 600) und nie an den Browser gesendet (die Seite zeigt nur „set ✓“) (ab Version 0.1.6; frühere Versionen speichern ihn im Klartext in der Konfiguration).
• Aufbewahrung: standardmäßig 365 Tage (einstellbar); gelöscht werden ganze Monatsdateien, es kann also bis zu etwa einem zusätzlichen Monat auf der Festplatte bleiben. Der CSV-Export wird vom Administrator ausgelöst.
• Das Plugin liest das lokale Protokoll embyserver.txt, um die Request-Header zu erhalten.

Kompatibilität mit Clients

Die Erfassung erfolgt serverseitig (die Anmelde- und Sitzungsereignisse des Servers) und funktioniert daher mit jedem Client; die Oberfläche ist nur die Admin-Seite.

• Emby Web: ✅ (Seiten in Chrome verifiziert; Erfassung auf dem Server getestet).
• Native Emby-Apps (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV), TV-Browser: 🟢 die Erfassung hängt nicht vom Client ab; ❔ nicht einzeln getestet. Der angezeigte App-/Gerätename ist der, den der Client meldet.
• Die Erkennung „über Cloudflare / direkt“ hängt von den Zeilen ab, die Emby in embyserver.txt schreibt; Emby akzeptiert X-Forwarded-For von jedem — das Plugin markiert gefälschte Header.

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder im Emby-Paket enthalten. 30 Tage kostenlos testen.