¿Por qué Jellyfin pierde las sesiones después de un cambio de proxy o DNS?

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Un cambio de proxy o DNS no debería cerrar automáticamente todas las sesiones de Jellyfin. La pérdida de sesión suele producirse cuando el cambio también modifica el nombre de host, el esquema, la ruta, la identidad del servidor del backend, la capa de autenticación o la ruta del cliente que espera el estado de inicio de sesión existente.

Empieza por distinguir una simple actualización de un registro DNS de un cambio de origen. Mantén fijos una cuenta y un dispositivo conocidos, compara el acceso directo desde la LAN con el nombre de host público habitual y captura la primera solicitud fallida antes de borrar los datos del cliente. El objetivo es identificar qué límite cambió, no restablecer las cuentas de los usuarios hasta que desaparezca el síntoma.

Primero, determina si el origen público realmente cambió

Anota el esquema, el nombre de host, el puerto, la ruta base y la ruta del proxy, tanto antiguos como nuevos. Un registro DNS A o AAAA puede apuntar el mismo nombre de host a otra dirección sin cambiar el origen del navegador, mientras que pasar de un nombre de host a otro o cambiar la ruta base de una aplicación crea un límite distinto para el cliente. Las migraciones a dominios personalizados también requieren que la aplicación y la ruta de autenticación coincidan en el nuevo dominio; una lista de comprobación para la migración a dominios personalizados deja explícita esta dependencia entre DNS y aplicación.

El estado de autenticación depende del lugar donde se presenta. Una lista de comprobación del alcance de las cookies de sesión útil empieza por identificar el dominio y la ruta asociados a cada mecanismo de autenticación. Los clientes de Jellyfin no almacenan todos el estado exactamente de la misma manera, así que prueba el cliente afectado en lugar de suponer que el comportamiento del navegador describe todas las aplicaciones.

Si el nombre de host antiguo sigue funcionando, pero el nuevo solicita iniciar sesión, considéralo una migración de origen esperada hasta demostrar lo contrario. Si el mismo nombre de host cierra la sesión de todos solo después de cambiar el proxy, conserva el nombre de host y revisa la identidad del servidor ascendente, los encabezados y la autenticación del proxy.

Verifica que el DNS siga dirigiendo a la misma instancia de Jellyfin prevista

Resuelve el nombre de host desde un cliente de la LAN y, si importa el acceso remoto, desde un solucionador externo. Confirma que la dirección devuelta llega al proxy inverso previsto y que el proxy dirige al servicio Jellyfin esperado, no a un contenedor antiguo, una instancia de prueba, un clon restaurado o un segundo servidor con una base de datos persistente distinta.

Un cambio de DNS puede parecer un problema de sesión cuando en realidad dirige al cliente a otro backend. Compara una respuesta que identifique el servidor, el comportamiento de la lista de usuarios, el estado de la biblioteca y el destino del upstream del proxy antes de modificar la autenticación. Si la nueva ruta llega a una instancia de Jellyfin recién creada o restaurada, es posible que las credenciales existentes del cliente ya no representen una sesión válida en ella.

El flujo de trabajo relacionado de ZimaSpace para mantener separados los ciclos de vida del proxy y del estado de las sesiones resulta útil en este caso: un reinicio del ingreso no debería sustituir silenciosamente la identidad de la aplicación ni el estado que valida las sesiones existentes.

Compara Host, Scheme y Path reenviados, y la autenticación del proxy

Captura la configuración efectiva del proxy después del cambio. Compara el valor público de Host, el esquema reenviado, la dirección del cliente, la ruta de actualización de WebSocket, las redirecciones y cualquier middleware de autenticación con la última configuración que funcionaba. Una redirección de HTTPS a una URL HTTP inesperada o con un host alternativo puede hacer que parezca que un inicio de sesión válido ha desaparecido.

Si hay otra capa de autenticación delante de Jellyfin, mantén estables su clave de firma, el nombre de la cookie, el dominio de la cookie y el almacén de sesiones durante el reemplazo del proxy. Los diseños de balanceadores de carga usan sesiones persistentes y estado de enrutamiento para mantener una solicitud en el backend previsto; cambiar esa capa puede provocar un cierre de sesión o un bucle aunque Jellyfin siga funcionando correctamente.

No copies a ciegas encabezados de un ejemplo de proxy que no tenga relación. Cambia un solo valor únicamente cuando la solicitud fallida o la redirección demuestre que el valor actual es incorrecto. La configuración de proxy más segura es la más sencilla que conserva el origen público y llega de manera sistemática al backend correcto.

Prueba con un cliente limpio sin borrar las pruebas originales

Antes de borrar nada, guarda la hora del fallo, la versión del navegador o de la aplicación, el estado de la solicitud, la cadena de redirecciones, la línea del registro del proxy y la entrada del registro de Jellyfin. Después, usa una ventana de navegación privada o un segundo dispositivo de prueba para iniciar sesión a través de la nueva ruta. Que funcione un nuevo inicio de sesión demuestra que se puede acceder; no explica por qué el estado anterior dejó de ser utilizable.

Compara estas tres rutas en este orden: la dirección de Jellyfin en la LAN, el nombre de host habitual desde la LAN y el nombre de host habitual desde fuera de la LAN. Si el acceso directo funciona y el nombre de host falla, no modifiques los usuarios ni el estado de la base de datos e investiga el DNS, TLS, el proxy o el middleware. Si todas las rutas rechazan la misma cuenta que sabes que es válida, el problema vuelve a estar dentro de Jellyfin o de su estado persistente.

Borra solo los datos específicos del sitio en el cliente afectado después de recopilar las pruebas de la ruta de solicitud. Evita eliminar todos los dispositivos registrados o revocar todas las sesiones como primer paso, ya que eso elimina la comparación que podría distinguir una migración del enrutamiento de un fallo de autenticación del servidor.

Valida el cambio tras la expiración del DNS, el reinicio del proxy y el reinicio del sistema

Después de aplicar la solución correspondiente, espera a que venza el TTL de DNS anterior, reinicia solo el proxy, luego reinicia el servicio de Jellyfin y, por último, reinicia el host. Después de cada evento, repite las pruebas de inicio y cierre de sesión, inicio de reproducción, búsqueda y reconexión usando el mismo nombre de host.

Un resultado estable significa que el nombre de host sigue resolviendo al proxy previsto, que el proxy vuelve a conectarse a la instancia de Jellyfin prevista, que las sesiones existentes se mantienen tras los reinicios normales de los componentes cuando corresponde y que un nuevo inicio de sesión sigue siendo válido. Si los fallos solo aparecen durante el arranque completo de la pila, usa la ruta de recuperación del proxy al servidor de origen para distinguir los problemas de disponibilidad de los de autenticación.

Anota en las notas de implementación el nombre de host final, el nombre del servidor de origen del proxy, la ruta base, el origen del certificado y cualquier secreto de sesión del proxy. Así, los futuros cambios de DNS o del proxy se podrán probar con una referencia de identidad conocida, en lugar de tener que deducirla a partir de lo que ocurre en el navegador.

Preguntas frecuentes

¿Cambiar un registro DNS invalida por sí solo las sesiones de Jellyfin?

Por lo general, no, si se siguen usando el mismo nombre de host, esquema, ruta e instancia de Jellyfin. Un cambio de DNS afecta a las sesiones cuando envía los clientes a otro backend, cambia el origen público, modifica TLS o las redirecciones, o cambia una capa de autenticación delante de Jellyfin.

¿Debería revocar todas las sesiones de Jellyfin después de cambiar un proxy?

No como primera medida de reparación. Conserva un cliente que falle como evidencia, confirma que la nueva ruta llega al servidor previsto y prueba un inicio de sesión nuevo por separado. Revoca las sesiones solo cuando hayas rotado las credenciales deliberadamente, sospeches que se han filtrado tokens o hayas confirmado que ya no se debe confiar en el estado antiguo del cliente.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.