Access Log für Jellyfin — Installationsanleitung

Installation

Du brauchst Jellyfin Server 12.2 oder neuer und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (ein aktives Abonnement, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Paket oder den kostenlosen 30-tägigen Testzeitraum).

Aus deinem Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann von selbst.

1. Öffne in deinem MediaLab-Works-Konto Lizenzen → Jellyfin-Plugin-Repository und klicke auf Repository-URL erstellen. Kopiere sie: Sie ist privat (sie enthält einen Token), also teile sie nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Plugins → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
3. Suche in Dashboard → Plugins → Catalog nach Access Log by MediaLab, klicke auf Install und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die erlaubten Versionen. Seine Download-Links sind signiert und laufen nach wenigen Stunden ab, sodass Jellyfin immer eine frische Liste liest.

Aus dem öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build; medialab Server fügt ihn von selbst hinzu. Du kannst ihn auf dieselbe Weise hinzufügen, um ein Plugin zu installieren, bevor du einen Schlüssel hast: Das Plugin fragt dann auf seiner Lizenz-Seite nach der Lizenz oder startet den Testzeitraum. Bei einer Lifetime-Lizenz mit abgelaufenem Update-Zeitraum bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell, aus einer Zip-Datei.

1. Lade in Konto → Lizenzen jf-accesslog_x.y.z.zip herunter (die SHA-256 der Datei steht neben dem Button).
2. Entpacke sie in einen neuen Ordner Access Log by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner:
   • Linux (Paket): /var/lib/jellyfin/plugins/
   • Docker (offizielles Image): /config/plugins/ im Config-Volume
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Starte Jellyfin neu.

Lizenzaktivierung

1. Öffne die Plugin-Seite unter Dashboard → Plugins → Access Log by MediaLab und klicke auf Open License page.
2. Füge deinen Lizenzschlüssel ein und klicke auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Jellyfin-Server und zeigt die Lizenz als Active an.
3. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein und starte den kostenlosen 30-tägigen Testzeitraum (Karte erforderlich, heute nichts zu zahlen) oder kauf eine Lizenz; das Plugin aktiviert sich, sobald die Zahlung durch ist.

Die Lizenz wird einmal am Tag und bei jedem Jellyfin-Start geprüft. Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter. Ohne gültige Lizenz stoppt das Plugin seine Arbeit; nur seine License-Seite funktioniert weiter (Test, Schlüssel, Verlängerung). Es wird nichts gelöscht, und alles läuft weiter, sobald die Lizenz wieder gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Updates und Rollback

• Aus dem Repository: Jellyfin zeigt neue Versionen unter Dashboard → Plugins an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
• Über die Lizenz-Seite des Plugins: Mit gültiger Lizenz installiert Install update die neueste Version, die deine Lizenz erlaubt, und mit Roll back to x.y.z kehrst du zur vorherigen Version zurück (zum Beispiel, wenn nach einem Update etwas nicht mehr funktioniert). Starte Jellyfin danach jeweils neu. Beide Pakete werden gegen die Prüfsumme geprüft, die der Lizenzserver veröffentlicht.
• Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums veröffentlicht wurden; danach läuft das Plugin mit der letzten Version weiter, die es nutzen darf.
• Nach Roll back to x.y.z ist Jellyfins automatisches Update für dieses Plugin ausgeschaltet, bis du auf der Lizenz-Seite wieder Install update ausführst; die geplante Aufgabe Update Plugins (beim Start und täglich) holt die neuere Version also nicht zurück.
• Lifetime-Lizenz und automatische Updates. Der öffentliche Jellyfin-Katalog (https://medialab.works/jellyfin/manifest.json) bietet immer die neueste Version an. Ist der Update-Zeitraum einer Lifetime-Lizenz abgelaufen, sind danach veröffentlichte Versionen nicht lizenziert: Installiert Jellyfins automatische Plugin-Updates eine davon, stoppt das Plugin mit „version not licensed“, bis du mit Roll back to x.y.z auf seiner Lizenz-Seite zurückgehst oder einen Update-Pass kaufst. Um das zu vermeiden, lass Jellyfin dieses Plugin nicht automatisch aktualisieren: Füge dein privates Plugin-Repository hinzu, das nur die Versionen anbietet, die deine Lizenz erlaubt, anstelle des öffentlichen Katalogs, oder entferne die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Scheduled Tasks (das stoppt automatische Updates für alle Plugins).

Quellcode

Der GPL-3.0-Quellcode jeder Version liegt in Konto → Lizenzen (Quellcode) neben dem Download als .tar.gz-Archiv vor, das aus dem exakten Commit dieser Version erstellt wurde.

Konfiguration

Öffne Dashboard → Access Log → Settings.

1. Erstelle ein kostenloses Konto bei MaxMind (GeoLite2), dann Manage License Keys → Generate new license key.
2. Trage die Account ID und den License Key ein und speichere: Die Datenbanken GeoLite2 City und ASN werden sofort heruntergeladen und automatisch aktualisiert.
3. Wähle, wie viele Tage Ereignisse aufbewahrt werden, ob Wiedergabestarts und IP-Wechsel aufgezeichnet werden und welche Warnungen du willst.

Im Alltag

• Activity: jedes Ereignis, neueste zuerst, mit Filtern nach Benutzer, Zeitraum, Land und Gerät; CSV-Export.
• Devices: die bekannten Geräte jedes Benutzers.
• Users and countries: Zusammenfassung pro Benutzer und pro Land sowie die Adressen mit falschen Passwörtern.

Fehlerbehebung

• Jedes Ereignis zeigt dieselbe Adresse (dein Proxy oder Cloudflare): Füge den Proxy in Jellyfins Known proxies ein (Dashboard → Networking), damit Jellyfin die echte Adresse des Besuchers weitergibt.
• Kein Standort: Prüfe die MaxMind-Account-ID und den Key unter Settings.