Ir al contenido principal
Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Jellyfin Vue

Jellyfin Vue es un cliente web experimental alternativo basado en navegador para Jellyfin, desarrollado con Vue.js.

nota

Jellyfin Vue no está planificado para reemplazar el cliente web principal de Jellyfin, y no tiene todas las funcionalidades implementadas.

A continuación encontrarás instrucciones concisas para poner en marcha tu propia instancia de Jellyfin Vue. Si te identificas con al menos una de estas situaciones:

  • Quieres probarlo rápidamente por primera vez

  • No estás seguro si deseas desplegar tu propia instancia

  • No necesitas personalizaciones avanzadas que modifiquen el comportamiento global de la aplicación.

  • Ya tienes configurado HTTPS funcional.

Probablemente sea mejor que uses nuestra instancia alojada. Más información en el repositorio de Jellyfin Vue.

Despliegue​

precaución

Dado que Jellyfin Vue es solo una interfaz para un servidor de Jellyfin, todas estas instrucciones asumen que ya tienes un servidor funcionando. Configúralo ahora si aún no lo has hecho.

RECOMENDADO: Usar Docker​

  • Si no tienes Docker instalado, sigue primero la guía de instalación oficial. También se recomienda aprender sobre Compose.

  • Docker Compose ahora se incluye con Docker, por lo que no necesitas instalarlo por separado. Se recomienda desinstalar la versión anterior de docker-compose.

  • La clave version está obsoleta en Docker Compose, por lo que no se incluye en los ejemplos siguientes.

Usaremos el siguiente docker-compose.yml como punto de partida:

services:
  jellyfin_vue:
    container_name: jellyfin_vue
    image: ghcr.io/jellyfin/jellyfin-vue:unstable
    restart: always
    ports:
      - 8080:80
    labels:
      - 'com.centurylinklabs.watchtower.enable=true'

  watchtower:
    container_name: watchtower
    image: ghcr.io/nicholas-fedor/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      TZ: Europe/Madrid
      WATCHTOWER_CLEANUP: 1
      WATCHTOWER_INCLUDE_RESTARTING: 1
      WATCHTOWER_POLL_INTERVAL: 60
      WATCHTOWER_LABEL_ENABLE: 1
    # Needed so watchtower doesn't restart-loop when updating itself
    restart: on-failure
success

Ponerlo en marcha es tan sencillo como ejecutar docker compose up -d en tu terminal ubicado en el directorio donde está el archivo docker-compose.yml.

Con este archivo compose:

  • Jellyfin Vue será accesible en el puerto 8080 de la máquina que ejecute los contenedores

  • Watchtower (fork, el original no tiene mantenimiento) se encarga de actualizar el contenedor al último commit disponible en el repositorio. Esto es recomendable porque:

    • Actualmente no existen versiones estables, solo prelanzamientos que no necesariamente cumplen criterios de calidad, sino que representan hitos importantes de desarrollo.
    • Solo se admite la imagen unstable más reciente.

Tras acceder a la instancia en tu navegador preferido, se te solicitará añadir un servidor. Puedes usar tu propio servidor o nuestra instancia de demostración en https://demo.jellyfin.org/stable

nota

La dirección del servidor que debes introducir es relativa al dispositivo desde el que accedes a Jellyfin Vue. Por ejemplo, si tu servidor Jellyfin está en 192.168.0.10 y has desplegado Jellyfin Vue en ese mismo servidor, y tu cliente está en 192.168.0.20, la dirección que debes ingresar es http://192.168.0.10, no http://127.0.0.1 ni http://localhost.

Puedes obtener más información sobre cómo funciona la conexión a tu servidor en el aviso de privacidad del repositorio de Jellyfin Vue

Usar variables de entorno​

Este es un ejemplo de cómo configurar variables de entorno en el contenedor añadiendo las siguientes claves a la definición de jellyfin_vue en el docker-compose.yml anterior:

environment:
  HISTORY_ROUTER_MODE: 1

Consulta la referencia completa de variables de entorno disponibles para personalizar Jellyfin Vue a tu gusto en el wiki de Jellyfin Vue.

Usando tu propio servidor web​

Dado que Jellyfin Vue es una aplicación web SPA, puedes utilizar cualquier servidor web para servirlo: Apache, nginx (el que se usa en la imagen de Docker de Jellyfin Vue), Traefik, etc...

Si ya tienes configurado un proxy inverso y quieres realizar configuraciones más complejas que están fuera del alcance de esta documentación, como servirlo en una subruta, en otro subdominio, etc., quizás prefieras servir Jellyfin Vue con tu propio servidor web en lugar de la instancia de nginx incluida en la imagen de Docker.

Para lograrlo, en la definición del servicio jellyfin_vue del archivo docker-compose.yml mostrado anteriormente:

  • Elimina la clave ports.

  • Añade las siguientes claves, reemplazando _path_ por la carpeta donde tu servidor web espera los activos de Jellyfin Vue:

network_mode: none
volumes:
  - _𝘱𝘢𝘵𝘩_:/dest
# This makes the container do nothing and sleep forever,
# frontend will be copied to _𝘱𝘢𝘵𝘩_ and will be served by your web server
command: /bin/sh -c 'rm -rf /dest/* && cp -r . /dest && sleep infinity'

Este enfoque:

  • Mantiene el cliente siempre actualizado de forma sencilla, como se explica arriba.

  • Si usas variables de entorno, seguirán aplicándose.

Manualmente​

precaución

Asegúrate de entender las implicaciones antes de usar estos métodos. Ninguno de ellos es compatible con Jellyfin Vue.

docker run​

Si no quieres usar Docker Compose ni actualizaciones automáticas, pero aún así prefieres Docker, este comando es suficiente:

docker run -d -p 8080:80 ghcr.io/jellyfin/jellyfin-vue:unstable

Desde el código fuente / resultados de compilación​

información

Esto podría no ser necesario si solo quieres probar un Pull Request. Consulta estas instrucciones en su lugar

peligro

Por defecto, nunca confíes en activos proporcionados fuera de los canales oficiales si no puedes inspeccionar primero el código fuente. ¡Podrían comprometer tu sistema o rastrear tu actividad!

Dado que Jellyfin Vue es una aplicación web, usarla requiere configurar tu propio servidor web y apuntarlo a los activos de Jellyfin Vue. Puedes obtenerlos:

  • Construyendo tu versión desde nuestro código fuente. El wiki del repositorio tiene instrucciones para configurar el entorno de desarrollo.

  • Obteniéndolos de los artefactos de GitHub Actions.

    • Aunque estos artefactos se construyen en el CI/CD de nuestro repositorio, ¡algunas ejecuciones provienen de Pull Requests creados por colaboradores externos que podrían no ser confiables!
    • Todos los artefactos generados por GitHub Actions se construyen con procedencia verificable.
    • Nuestra imagen oficial de Docker se construye desde GitHub Actions y todo el proceso es transparente y auditable.

Otra documentación​

  • El resto de la documentación sobre Jellyfin Vue está disponible en su wiki.

  • Puedes consultar GitHub Packages (GHCR) (recomendado) o DockerHub para todas las imágenes de Docker etiquetadas.