Este es un problema histórico específico de una versión, no un requisito actual de configuración de Jellyfin. En ZimaOS 1.2.5, IceWhale añadió servicios de descubrimiento de dispositivos Windows en la LAN y servicios relacionados con DLNA. Esos servicios ocupaban los puertos 1900 y 1901, lo que podía impedir que Jellyfin se iniciara o reiniciara con normalidad.
La solución oficial original detenía los servicios de descubrimiento
777-Spider identificó minidlnad.service y ssdpd.service como los servicios de ZimaOS en conflicto y publicó comandos temporales para detenerlos y deshabilitarlos. Después de seguir las instrucciones, Jellyfin volvió a funcionar.
Como estos comandos fueron publicados por personal de IceWhale para esta versión histórica específica, constituyen una fuente válida de evidencia. No deben considerarse una configuración predeterminada actual.
El conflicto volvió a aparecer después de reiniciar
El usuario de la fuente informó que, después de reiniciar ZimaOS, Jellyfin volvió a fallar. El error de Docker mostró entonces que el puerto 1901/tcp ya estaba en uso.
Zima-Jerry identificó a ssdpd como el propietario del puerto 1901
Zima-Jerry explicó que el nuevo servicio de difusión de dispositivos UPnP/Windows ocupaba el puerto 1901 y que la operación para deshabilitarlo no había persistido como se esperaba. Hasta la siguiente versión, quizá el usuario tendría que detener de nuevo ssdpd.service después del arranque.
IceWhale dijo que el puerto se cambiaría
La respuesta oficial también indicó que el puerto 1901 utilizado por ssdpd se había cambiado en la próxima versión, de modo que Jellyfin ya no entraría en conflicto con el servicio de descubrimiento.
ZimaOS 1.3.0 indicó posteriormente que el conflicto de puertos estaba solucionado
Las notas de lanzamiento oficiales de ZimaOS 1.3.0 de IceWhale indican explícitamente que se solucionó la ocupación de los puertos 1900 y 1901 para garantizar la disponibilidad de Plex. Esta corrección a nivel de versión marca el límite actual importante: los usuarios de versiones modernas de ZimaOS no deberían comenzar a solucionar problemas de Jellyfin deshabilitando esos servicios antiguos simplemente porque un artículo de 2024 lo recomiende.
Diagnostica los conflictos de puertos actuales a partir del error real
Si un contenedor actual de Jellyfin falla con address already in use, identifica el puerto exacto en el error de Docker y determina qué proceso o contenedor del host lo está utilizando. No supongas que se trata del antiguo error de ssdpd/minidlnad.
Los puertos de DLNA y descubrimiento son diferentes del puerto web de Jellyfin
La interfaz web normal de Jellyfin utiliza un puerto distinto del que emplea el descubrimiento SSDP/DLNA. Por lo tanto, un usuario puede tener una WebUI funcional mientras las funciones de descubrimiento entran en conflicto, o un contenedor puede fallar porque la definición de la aplicación publica un puerto del host que ya está siendo utilizado por otro servicio.
Por qué systemctl disable no persistió como se esperaba
El usuario informó que los servicios reaparecían después de reiniciar incluso tras ejecutar los comandos iniciales para deshabilitarlos. Zima-Jerry reconoció que ssdpd realmente no permanecía deshabilitado en el entorno 1.2.5. Por eso, la solución oficial seguía requiriendo detener el servicio de nuevo después del arranque hasta que se publicara la corrección a nivel de versión.
El error de Docker identificó el puerto exacto
El fallo posterior al reinicio incluía failed to bind port 0.0.0.0:1901/tcp y address already in use. Este tipo de mensaje de Docker es la forma más rápida de distinguir un conflicto de puertos de un problema con la base de datos de Jellyfin o con los permisos de los archivos multimedia.
Mantén los comandos antiguos de systemctl vinculados a ZimaOS 1.2.5
Los comandos de la fuente eran oficiales para una regresión temporal y específica. En una versión moderna de ZimaOS, detener los servicios de descubrimiento puede eliminar funcionalidades sin resolver el conflicto real. Comprueba primero qué servicio posee actualmente el puerto y, después, modifica el servicio verdaderamente responsable.
Preguntas frecuentes históricas sobre los puertos de Jellyfin
¿Qué versión de ZimaOS tenía este conflicto documentado?
ZimaOS 1.2.5.
¿Qué servicios estaban implicados?
El personal de IceWhale identificó minidlnad.service y ssdpd.service.
¿IceWhale lo solucionó posteriormente?
Sí. Las notas de lanzamiento de ZimaOS 1.3.0 indican que se solucionó el problema de ocupación de los puertos 1900/1901.
¿Los usuarios actuales deberían deshabilitar automáticamente esos servicios?
No. Primero diagnostica qué servicio posee realmente el puerto actual.
