Il s’agit d’un problème historique propre à une version, et non d’une exigence actuelle pour configurer Jellyfin. Dans ZimaOS 1.2.5, IceWhale a ajouté des services de découverte des appareils Windows sur le réseau local ainsi que des services liés à DLNA. Ces services utilisaient les ports 1900 et 1901, ce qui pouvait empêcher Jellyfin de démarrer ou de redémarrer normalement.
La solution officielle initiale arrêtait les services de découverte
777-Spider a identifié minidlnad.service et ssdpd.service comme les services ZimaOS en conflit et a publié des commandes temporaires pour les arrêter et les désactiver. Après avoir suivi les instructions, l’utilisateur a pu utiliser Jellyfin à nouveau.
Comme ces commandes ont été publiées par des membres du personnel d’IceWhale pour cette version historique précise, elles constituent des éléments de preuve fiables. Elles ne doivent toutefois pas être considérées comme une configuration par défaut actuelle.
Le conflit est réapparu après le redémarrage
L’utilisateur à l’origine du signalement a indiqué qu’après le redémarrage de ZimaOS, Jellyfin ne fonctionnait de nouveau plus. L’erreur Docker indiquait alors que le port 1901/tcp était déjà utilisé.
Zima-Jerry a identifié ssdpd comme propriétaire du port 1901
Zima-Jerry a expliqué que le nouveau service de diffusion des appareils UPnP/Windows occupait le port 1901 et que la désactivation ne persistait pas comme prévu. Jusqu’à la prochaine version, il pouvait être nécessaire d’arrêter à nouveau ssdpd.service après le démarrage.
IceWhale a indiqué que le port serait déplacé
La réponse officielle indiquait également que le port 1901 utilisé par ssdpd avait été déplacé dans la prochaine version, afin que Jellyfin n’entre plus en conflit avec le service de découverte.
ZimaOS 1.3.0 a ensuite indiqué que le conflit de ports était corrigé
Les notes de version de ZimaOS 1.3.0 d’IceWhale indiquent explicitement que l’occupation des ports 1900 et 1901 a été corrigée afin de garantir la disponibilité de Plex. Cette correction au niveau de la version constitue la limite actuelle importante : les utilisateurs d’une version moderne de ZimaOS ne doivent pas commencer à diagnostiquer Jellyfin en désactivant ces anciens services simplement parce qu’un article de 2024 le recommande.
Diagnostiquer les conflits de ports actuels à partir de l’erreur réelle
Si un conteneur Jellyfin actuel échoue avec le message address already in use, identifiez le port exact indiqué dans l’erreur Docker, puis déterminez quel processus ou conteneur hôte l’utilise. Ne supposez pas qu’il s’agit du problème historique lié à ssdpd/minidlnad.
Les ports DLNA et de découverte sont différents du port Web de Jellyfin
L’interface Web normale de Jellyfin utilise un port différent de celui de la découverte SSDP/DLNA. Un utilisateur peut donc disposer d’une interface Web fonctionnelle alors que les fonctions de découverte sont en conflit, ou un conteneur peut échouer parce que la définition de l’application publie un port hôte déjà utilisé par un autre service.
Pourquoi systemctl disable n’a pas persisté comme prévu
L’utilisateur a indiqué que les services étaient revenus après le redémarrage, même après l’exécution des premières commandes de désactivation. Zima-Jerry a reconnu que ssdpd ne restait pas réellement désactivé dans l’environnement 1.2.5. C’est pourquoi la solution officielle exigeait toujours d’arrêter à nouveau le service après le démarrage, jusqu’à la publication de la correction au niveau de la version.
L’erreur Docker indiquait le port exact
L’échec après redémarrage comprenait failed to bind port 0.0.0.0:1901/tcp et address already in use. Ce type de message Docker est le moyen le plus rapide de distinguer un conflit de ports d’un problème lié à la base de données Jellyfin ou aux permissions des fichiers multimédias.
Limitez les anciennes commandes systemctl à ZimaOS 1.2.5
Les commandes d’origine étaient officielles pour une régression temporaire et spécifique. Sur une version moderne de ZimaOS, l’arrêt des services de découverte peut supprimer certaines fonctionnalités sans résoudre le véritable conflit. Vérifiez d’abord quel processus utilise actuellement le port, puis modifiez le service réellement responsable.
FAQ historique sur les ports de Jellyfin
Quelle version de ZimaOS présentait ce conflit documenté ?
ZimaOS 1.2.5.
Quels services étaient concernés ?
minidlnad.service et ssdpd.service ont été identifiés par le personnel d’IceWhale.
IceWhale a-t-il corrigé le problème par la suite ?
Oui. Les notes de version de ZimaOS 1.3.0 indiquent que le problème d’occupation des ports 1900/1901 a été corrigé.
Les utilisateurs actuels doivent-ils désactiver automatiquement ces services ?
Non. Commencez par identifier le processus qui utilise réellement le port.
