Sí. Jellyfin puede funcionar detrás de un proxy inverso en una subruta como https://example.com/jellyfin, pero Jellyfin y el proxy deben coincidir en la misma ruta base.
Un fallo de subruta suele manifestarse como un sitio que funciona a medias: la página de inicio de sesión puede cargar, mientras que JavaScript, las imágenes, WebSocket, las redirecciones o los clientes nativos fallan. Comprueba la ruta por capas—primero la URL base, después la ruta del proxy y, por último, los encabezados reenviados y la dirección del cliente—para distinguir una discrepancia de ruta de un problema de TLS o de identidad del proxy.
Haz que la URL base de Jellyfin coincida con la subruta pública
Configura la URL base de Jellyfin con el prefijo público exacto que quieras usar, por ejemplo, /jellyfin. No añadas un prefijo interno distinto solo porque el proxy use un bloque de ubicación con nombre; la ruta visible en el navegador y la URL base de Jellyfin deben corresponder a la misma raíz de la aplicación.
La documentación de Apache de Jellyfin para el proxy inverso incluye explícitamente un ejemplo de subruta e indica a los administradores que configuren la URL base como /jellyfin antes de conectar los clientes a esa dirección completa. ejemplo oficial de subruta
Reinicia Jellyfin después de cambiar la URL base y abre la subruta pública en una ventana privada nueva del navegador. Si la redirección inicial elimina inmediatamente /jellyfin o lo duplica, corrige la URL base antes de modificar la configuración de WebSocket o de autenticación.
Enruta el mismo prefijo a través del proxy inverso
Configura el proxy inverso para que las solicitudes que comiencen con el prefijo público se reenvíen a Jellyfin sin aplicar transformaciones de ruta adicionales. El diseño más sencillo es un prefijo público, una URL base de Jellyfin que coincida y un servicio upstream.
La guía de Caddy para Jellyfin muestra el mismo patrón: configura la ruta base de Jellyfin, redirige el prefijo sin barra final a la versión con barra y envía las solicitudes bajo ese prefijo al backend de Jellyfin. ruta base y ruta del proxy coincidentes
Si el navegador recibe un error 404 del proxy antes de que Jellyfin registre la solicitud, la ruta está mal configurada en la capa del proxy. Si Jellyfin recibe la solicitud, pero genera enlaces sin el prefijo, la URL base está mal configurada en la capa de la aplicación. No confundas estos dos patrones de error.
Comprueba los recursos estáticos y WebSocket, no solo la página de inicio de sesión
Una respuesta HTML correcta no basta para considerar que la configuración de la subruta funciona bien. Abre las herramientas para desarrolladores o el registro del proxy y verifica que las solicitudes de JavaScript, CSS, imágenes, API y WebSocket permanezcan bajo el mismo prefijo público.
Los ejemplos de proxy inverso de Jellyfin incluyen la gestión de WebSocket porque los clientes interactivos mantienen una conexión de socket, además de las solicitudes HTTP habituales. Por eso, una regla del proxy que solo gestiona solicitudes de páginas puede parecer correcta hasta que falla el estado de reproducción, la actualización de sesiones o el comportamiento de la interfaz en tiempo real. requisitos del proxy inverso
El criterio para darlo por bueno es sencillo: no hay respuestas 404/502 repetidas para los recursos con prefijo, la conexión WebSocket se establece correctamente y la navegación no redirige a la raíz del sitio. Si solo falla una clase de solicitud, corrige esa regla del proxy en lugar de cambiar la biblioteca o la configuración de autenticación de Jellyfin.
Conserva la identidad del cliente a través del proxy
Cuando la ruta funcione, verifica la información del cliente reenviada. Jellyfin utiliza la configuración de confianza del proxy para decidir si acepta las direcciones y los protocolos reenviados, lo que afecta al comportamiento entre el acceso local y remoto y a las reglas de acceso externo.
La guía de redes de Jellyfin advierte que se descartan los encabezados reenviados por un proxy que no es de confianza y recomienda configurar la dirección del proxy en «Proxies conocidos». Configuración de proxies conocidos Una comprobación independiente de la IP del cliente resulta útil cuando el sitio funciona, pero parece que todas las solicitudes se originan en el proxy.
No soluciones un problema de identidad confiando en todas las subredes privadas o en todos los encabezados reenviados. Añade únicamente el salto real del proxy o la red controlada del proxy; luego compara una solicitud desde la LAN y otra desde una ubicación remota en los registros de Jellyfin para confirmar que se clasifican como se espera.
Prueba por separado las direcciones del navegador y del cliente nativo
Cuando un cliente de Jellyfin te pida la URL del servidor, introduce la dirección completa, incluida la subruta. Un cliente configurado con https://example.com no puede deducir que Jellyfin está en /jellyfin.
Prueba un navegador y un cliente nativo desde la LAN y, luego, repite la prueba con el nombre de host público. Si funciona con el nombre de host, pero no con el acceso directo mediante la IP local, puede ser lo esperado cuando la ruta del proxy y el certificado dependen del nombre de host; las pruebas con nombre de host y dirección IP ayudan a identificar ese caso sin debilitar el proxy.
Detente cuando la URL con prefijo siga funcionando después de iniciar sesión, navegar, usar WebSocket y reproducir contenido en los clientes que realmente admites. Si solo falla un cliente mientras el navegador y los demás funcionan, considéralo un problema de dirección o compatibilidad del cliente, en lugar de reescribir una configuración de proxy que ya funciona.
Soporte y consejos
Más para leer

Cómo mantener ocultos de tu familia los vídeos para adultos en tu NAS
Mantén privados los vídeos para adultos en un NAS familiar. Comprueba los permisos de las carpetas, el acceso a las bibliotecas de Plex y...

Qué comprobar antes de cargar un modelo de la comunidad en Transformers
Usa la actualización del entorno aislado de Jinja para Transformers para revisar la procedencia del modelo, las plantillas de chat, el código remoto, los...

Ejecuta Mirage localmente: OCR y detección de objetos a partir de una sola imagen
Prueba el pequeño modelo de visión local de Cactus Compute, valida el OCR y la extracción de objetos con datos reales y comprende las...



