Community-Lösung

Jellyfin-Portkonflikt 1900/1901 unter ZimaOS 1.2.5: Historische Lösung und aktueller Status

An October 2024 IceWhale support thread where new ZimaOS LAN-discovery services occupied ports used by Jellyfin. Staff provided temporary systemctl stop/disable commands, users saw the conflict return after reboot, and ZimaOS 1.3.0 later listed ports 1900/1901 as fixed for Plex/media compatibility.

Dies ist ein historisches, versionsspezifisches Problem und keine aktuelle Voraussetzung für eine Jellyfin-Einrichtung. In ZimaOS 1.2.5 fügte IceWhale Dienste zur Erkennung von Windows-LAN-Geräten und im Zusammenhang mit DLNA hinzu. Diese Dienste belegten die Ports 1900 und 1901, wodurch Jellyfin möglicherweise nicht normal gestartet oder neu gestartet werden konnte.

Die ursprüngliche offizielle Übergangslösung stoppte die Erkennungsdienste

777-Spider identifizierte minidlnad.service und ssdpd.service als die kollidierenden ZimaOS-Dienste und veröffentlichte vorübergehende Befehle zum Stoppen und Deaktivieren. Nachdem der Benutzer die Anweisungen befolgt hatte, funktionierte Jellyfin wieder.

Da diese Befehle von IceWhale-Mitarbeitern für genau diese historische Version veröffentlicht wurden, sind sie als Quellenbeleg gültig. Sie sollten jedoch nicht als aktuelle Standardkonfiguration betrachtet werden.

Der Konflikt trat nach dem Neustart erneut auf

Der Quellbenutzer berichtete, dass Jellyfin nach dem Neustart von ZimaOS erneut ausfiel. Der Docker-Fehler zeigte anschließend, dass der Port 1901/tcp bereits verwendet wurde.

Zima-Jerry identifizierte ssdpd als Besitzer von Port 1901

Zima-Jerry erklärte, dass der neuere UPnP-/Windows-Dienst zur Geräteübertragung Port 1901 belegte und dass die Deaktivierung erwartungsgemäß nicht dauerhaft wirksam geworden war. Bis zur nächsten Version musste der Benutzer ssdpd.service möglicherweise nach dem Systemstart erneut stoppen.

IceWhale kündigte an, den Port zu verlegen

In der offiziellen Antwort hieß es außerdem, dass der von ssdpd verwendete Port 1901 in der kommenden Version verlegt werde, sodass Jellyfin nicht mehr mit dem Erkennungsdienst kollidiert.

ZimaOS 1.3.0 führte den Portkonflikt später als behoben auf

In den Versionshinweisen zu ZimaOS 1.3.0 von IceWhale steht ausdrücklich, dass die Belegung der Ports 1900 und 1901 behoben wurde, um die Verfügbarkeit von Plex sicherzustellen. Diese Korrektur auf Versionsebene markiert die wichtige aktuelle Grenze: Benutzer moderner ZimaOS-Versionen sollten nicht allein deshalb mit der Fehlersuche bei Jellyfin beginnen, indem sie die alten Dienste deaktivieren, nur weil ein Artikel aus dem Jahr 2024 dies empfiehlt.

Aktuelle Portkonflikte anhand des tatsächlichen Fehlers diagnostizieren

Wenn ein aktueller Jellyfin-Container mit address already in use fehlschlägt, ermitteln Sie den genauen Port aus dem Docker-Fehler und stellen Sie fest, welcher Hostprozess oder Container ihn verwendet. Gehen Sie nicht automatisch davon aus, dass es sich um den historischen Fehler mit ssdpd/minidlnad handelt.

DLNA- und Erkennungsports unterscheiden sich vom Jellyfin-Webport

Die normale Browseroberfläche von Jellyfin verwendet einen anderen Port als die SSDP-/DLNA-Erkennung. Daher kann die WebUI funktionieren, während Erkennungsfunktionen kollidieren, oder ein Container kann fehlschlagen, weil die App-Konfiguration einen Hostport veröffentlicht, der bereits von einem anderen Dienst verwendet wird.

Warum systemctl disable nicht wie erwartet dauerhaft wirksam war

Der Benutzer berichtete, dass die Dienste nach dem Neustart zurückkehrten, obwohl die ursprünglichen Deaktivierungsbefehle ausgeführt worden waren. Zima-Jerry bestätigte, dass ssdpd in der ZimaOS-1.2.5-Umgebung nicht wirklich dauerhaft deaktiviert blieb. Deshalb musste der Dienst in der offiziellen Übergangslösung bis zum Erscheinen der Korrektur auf Versionsebene nach dem Systemstart erneut gestoppt werden.

Der Docker-Fehler identifizierte den genauen Port

Der Fehler beim Neustart enthielt failed to bind port 0.0.0.0:1901/tcp und address already in use. Eine solche Docker-Meldung ist der schnellste Weg, einen Portkonflikt von einem Fehler mit der Jellyfin-Datenbank oder fehlenden Medienberechtigungen zu unterscheiden.

Die alten systemctl-Befehle auf ZimaOS 1.2.5 beschränken

Die Befehle aus der Quelle waren eine offizielle Lösung für eine vorübergehende Regression in einer bestimmten Version. Bei einem modernen ZimaOS-Build kann das Stoppen der Erkennungsdienste Funktionen entfernen, ohne den tatsächlichen Konflikt zu lösen. Prüfen Sie zuerst, welcher Dienst den aktuellen Port verwendet, und ändern Sie anschließend den Dienst, der tatsächlich dafür verantwortlich ist.

Historische FAQ zu Jellyfin-Ports

Welche ZimaOS-Version hatte diesen dokumentierten Konflikt?

ZimaOS 1.2.5.

Welche Dienste waren betroffen?

minidlnad.service und ssdpd.service wurden von IceWhale-Mitarbeitern als betroffen identifiziert.

Hat IceWhale das Problem später behoben?

Ja. In den Versionshinweisen zu ZimaOS 1.3.0 wird das Problem mit der Belegung der Ports 1900 und 1901 als behoben aufgeführt.

Sollten aktuelle Benutzer diese Dienste automatisch deaktivieren?

Nein. Ermitteln Sie zuerst, welcher Dienst den tatsächlich betroffenen aktuellen Port verwendet.