Access Links für Emby — Anleitung

Installation

Du brauchst Emby Server 4.10.1 oder neuer.

Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter (verfügbar bei einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
Kopiere die DLL in den Emby-Plugins-Ordner und starte Emby Server neu:
- Linux (Paket): /var/lib/emby/plugins/
- Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
- Windows: %AppData%\Emby-Server\programdata\plugins\
Öffne Access Links im Emby-Dashboard-Menü und klicke auf License. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Testzeitraum zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal täglich (und bei jedem Start von Emby) geprüft. Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter; danach wird es gestoppt, bis es wieder prüfen kann.

Lizenz

Ohne gültige Lizenz wird das Plugin gestoppt; nur die Seite License funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren).

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen ein Rollback auf die vorherige Version ausführen. Starte Emby danach in beiden Fällen neu.

Konfiguration

Öffne Access Links im Emby-Dashboard-Menü.

HTTPS: Access Links funktioniert nur mit HTTPS-Adressen. Wenn die Seite meldet, dass HTTPS nicht aktiviert ist, füge in den Netzwerkeinstellungen von Emby ein Zertifikat hinzu; bis dahin öffnen sich die https://-Links nicht.
Lokale Adresse: Lass sie leer, damit automatisch die Netzwerk-IP und der HTTPS-Port des Servers verwendet werden, gib einen Namen aus deinem Netz ein (zum Beispiel media.lan; der HTTPS-Port wird automatisch ergänzt) oder eine vollständige https://…-Adresse. Tipp: Wenn dein Zertifikat für einen Namen ausgestellt ist, nutze diesen Namen, der in deinem Netz zum Server aufgelöst wird; eine bloße IP-Adresse führt meist zu Browser-Warnungen.
Externe Adresse: Gib sie genau so ein, wie du sie außerhalb deines Zuhauses im Browser eingeben würdest, mit dem externen Port, zum Beispiel https://example.com:2096. Der externe Port kann vom lokalen abweichen. Wenn Emby bereits eine externe Adresse kennt, schlägt die Seite sie mit einer Schaltfläche vor. Alles, was du aus der Browser-Adressleiste hinter der Adresse einfügst (etwa /web/index.html#!/home), wird automatisch entfernt.
Klicke auf Save.

Tägliche Nutzung

Die Seite listet jeden Link in Gruppen: Emby (Web-App, Anmeldebildschirm, Admin-Dashboard, Serveradresse für Apps) und eine Gruppe für jedes auf dem Server installierte MediaLab-Plugin (Quick Connect, Registration, Cashier, Share Links, MediaLab TV, Headend). Jeder Link zeigt, für wen er gedacht ist, und seine lokale und externe Adresse.
Für jede Adresse: Open, Copy oder QR. Zeige den QR-Code auf dem Bildschirm an, damit ein Handy ihn scannen kann, etwa die Quick-Connect-Seite oder das Anmeldeformular.
Check all links liest die Zertifikate, prüft, ob die externe Adresse wirklich denselben Server erreicht, und testet jede Seite. Warnungen sagen genau, was nicht stimmt: HTTPS aus, Zertifikat abgelaufen oder läuft innerhalb von 14 Tagen ab, Zertifikat deckt die Adresse nicht ab oder eine externe Adresse erreicht einen anderen Server.
Andere Emby- / Jellyfin-Server: Füge einen Namen, den Typ und die https://-Adresse eines anderen Servers hinzu (bis zu 50). Seine Links werden automatisch erstellt; Check zeigt seinen Namen, seine Version, den tatsächlichen Typ und welche Plugin-Seiten es darauf gibt (eine fehlende Seite bedeutet meist, dass das Plugin dort nicht installiert ist).

Was es wohin sendet

Die Prüfungen laufen nur, wenn du auf Check all links oder Check klickst: Der Server verbindet sich mit den eingegebenen Adressen, um ihr Zertifikat, ihre öffentlichen Serverinformationen und ob jede Seite antwortet zu lesen. Dabei wird nichts Geheimes gesendet.
QR-Codes werden auf deinem Server erzeugt; keine Adresse geht an einen externen Dienst.
Zu medialab.works geht nur die Lizenzprüfung.

Fehlersuche

„HTTPS is not enabled on this server“: Füge in den Netzwerkeinstellungen von Emby ein Zertifikat hinzu und starte Emby dann neu.
„The certificate does not cover the local address“: Die lokale Adresse ist eine IP-Adresse oder ein Name, der nicht im Zertifikat enthalten ist. Nutze einen Namen, den das Zertifikat abdeckt, der in deinem Netz zum Server aufgelöst wird.
„The external address does not answer from the server“: Viele Router können ihre eigene externe Adresse von innen nicht erreichen („Hairpin-NAT“). Öffne den externen Link von einem Handy über mobile Daten, um ihn zu prüfen.
„The external address reaches ANOTHER server“: Die Portweiterleitung oder der Reverse Proxy leitet diese Adresse an einen anderen Emby- oder Jellyfin-Server; korrigiere die Weiterleitung oder die externe Adresse.