So migrierst du Jellyfin von einem Desktop zu einem Open-Source-Media-Stack

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

How to Migrate Jellyfin From a Desktop to an Open-Source Media Stack - Zima Store Online

Migrieren Sie Jellyfin, indem Sie Anwendungsstatus, Medien, Cache, Backups und Netzwerkzugriff expliziten Rollen zuweisen, bevor Sie Container oder ein NAS auswählen.

Ein Desktop bündelt normalerweise jede Rolle in einem Dateisystem und über einen einzigen Strompfad. Ein Open-Source-Medienstack trennt diese Rollen, sodass die Migration nur gelingt, wenn jeder Pfad, jede UID/GID, jede Dienstabhängigkeit und jede Wiederherstellungsaktion vor dem Start des ersten Containers erfasst wurde. Bewahren Sie den Desktop als Rückfallquelle auf, bis ein sauberer Neustart und ein echter Client-Test erfolgreich waren.

Ordnen Sie den Desktop Dienstrollen zu

Erfassen Sie die Jellyfin-Konfiguration und -Datenbank, die Medienbibliotheken, Metadaten- und Bildcache, Plugins, Untertitel-Cache, Benutzer sowie alle Abhängigkeiten von Reverse Proxy oder DNS. Kennzeichnen Sie jeden Bestandteil als persistenten Anwendungsstatus, unersetzliche Medien, neu erstellbaren Cache, Backup-Kopie oder Wiederherstellungsmedium. Kopieren Sie einen Cache nicht so, als wäre er eine Datenbank, und betrachten Sie ein gespiegeltes Medien-Volume nicht als zweites Backup.

Die Migrationsgrenze ist klar, wenn jede Rolle einen Verantwortlichen, ein Ziel, einen Zugriffspfad und eine Wiederherstellungsaktion hat. Wenn sich eine Rolle nicht unabhängig wiederherstellen lässt, behalten Sie sie auf dem Desktop, bis das Stack-Design überarbeitet wurde.

Wählen Sie die Zieltopologie vor den Images

Verwenden Sie eine Dienstrolle für Jellyfin, ein persistentes Daten-Volume für Konfiguration und Datenbank, ein Medien-Volume mit stabilen Pfaden und ein separates Backup-Ziel. Legen Sie Reverse Proxy, Monitoring und experimentelle Dienste auf eigene Pfade oder Netzwerke, wenn eine Kopplung von Ausfällen vermieden werden soll. Ein Migrationstool eines Drittanbieters zeigt, warum Pfadübersetzung und Datenbankverwaltung einen ausdrücklichen Plan statt eines blinden Ordnerkopiervorgangs erfordern (Hinweise zur pfadbewussten Jellyfin-Migration).

Bewahren Sie Pfade und Berechtigungen während des Umzugs

Stoppen Sie den Desktop-Dienst, erstellen Sie eine Kopie seiner persistenten Daten und überprüfen Sie die Kopie, bevor Sie sie umwandeln. Behalten Sie auf dem Zielsystem den Medienpfad innerhalb des Containers möglichst identisch zu dem in der Datenbank erfassten Pfad. Setzen Sie die Container-UID/GID auf einen Benutzer oder Dienstprinzipal, der Medien lesen und nur in den erforderlichen Anwendungsverzeichnissen schreiben kann. Testen Sie einen Bibliotheksscan und die Anmeldung eines Benutzers, bevor Sie Plugins importieren oder Automatisierungen hinzufügen.

Die Entscheidung ist PASS, wenn Jellyfin jede vorgesehene Bibliothek lesen, seine Datenbank schreiben und neu starten kann, ohne die Pfadzuordnung zu ändern. Wenn die Berechtigungen weitreichenden Schreibzugriff auf den Medienbaum erfordern, trennen Sie Daten- und Anwendungsrollen, bevor Sie fortfahren.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

Validieren Sie Wiedergabe, Benutzer und Wiederherstellung schrittweise

Führen Sie lokale Direct-Play-Wiedergabe, eine repräsentative Transkodierung, Untertitel und ein zweites Benutzerkonto aus. Stoppen Sie anschließend den Stack und erstellen Sie ihn anhand der Compose- oder Deployment-Definition neu, nicht aus einer interaktiven Shell. Stellen Sie das Backup der Anwendungsdaten an einem sauberen Testort wieder her und bestätigen Sie, dass Wiedergabestatus, Benutzer und Bibliothekspfade entweder erhalten bleiben oder bewusst neu erstellt werden.

Erst nach diesen Prüfungen sollten Sie den Fernzugriff oder zusätzliche Dienste hinzufügen. Ein kompakter Host wie ZimaCube 2 AI NAS kann in Betracht gezogen werden, wenn die neutralen Anforderungen – persistenter Speicher, ausreichende Container-Ressourcen und ein separater Backup-Pfad – bereits zum Stack passen.

Legen Sie Erweiterungs- und Abbruchgrenzen fest

Erweitern Sie den Stack durch eine zusätzliche Speicherebene, einen transkodierungsfähigen Compute-Knoten oder eine separate Netzwerkrolle. Versuchen Sie nicht, jede neue Arbeitslast durch die Vergrößerung eines einzigen gemeinsam genutzten Volumes zu lösen. Bewahren Sie die Desktop-Rollback-Kopie auf, solange ein Plugin, eine Pfadkonvertierung oder eine Benutzermigration nicht überprüft wurde. Der Stack ist bereit, wenn ein dokumentierter Neuaufbau denselben Bibliothekszugriff und dasselbe Wiedergabeergebnis liefert, ohne dass der ursprüngliche Desktop ausgeführt wird.