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 →

Configuración

Existen varios puntos de entrada disponibles para que los administradores gestionen la configuración de su servidor. Esta sección describe todos esos métodos de configuración, explica las opciones disponibles y detalla la función de cada opción.

nota

Las opciones de configuración aquí presentadas son distintas de los ajustes de tiempo de ejecución disponibles en el Panel de Administración del cliente web. Las opciones aquí descritas son generalmente estáticas y deben establecerse antes de iniciar el servidor.

Opciones de Línea de Comandos

La documentación de las opciones disponibles en la línea de comandos puede obtenerse añadiendo el flag --help al ejecutar el binario de Jellyfin.

Rutas del Servidor

Las rutas de archivo utilizadas por el servidor se determinan según las reglas que se describen a continuación. Por lo general, se sigue la especificación XDG de forma predeterminada para sistemas que no son Windows.

Directorio de Datos

Este directorio almacena todos los datos de Jellyfin y también sirve como ruta base predeterminada para otras rutas mencionadas a continuación. Se establece según las siguientes fuentes en orden decreciente de prioridad.

1. Opción de línea de comandos --datadir, si se especifica

2. Variable de entorno JELLYFIN_DATA_DIR, si se define

3. <%ProgramData%>\Jellyfin\Server, al iniciar desde la aplicación de bandeja de Windows

4. <%LocalAppData%>\jellyfin, al iniciar el servidor Windows directamente

5. $XDG_DATA_HOME/jellyfin, si existe $XDG_DATA_HOME

6. $HOME/.local/share/jellyfin

nota

Los usuarios de Windows también pueden especificar el directorio de datos mediante una clave de registro de tipo cadena llamada DataFolder en Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Jellyfin\Server

Adicionalmente, una clave llamada InstallFolder en Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Jellyfin\Server puede especificar la ubicación de instalación.

Directorio de Configuración

Este directorio contiene los archivos de configuración del servidor. Se establece según las siguientes fuentes en orden decreciente de prioridad.

1. Opción de línea de comandos --configdir, si se especifica

2. Variable de entorno JELLYFIN_CONFIG_DIR, si se define

3. <Data Directory>/config, si existe o si se ejecuta en Windows

4. $XDG_CONFIG_HOME/jellyfin si existe $XDG_CONFIG_HOME

5. $HOME/.config/jellyfin

Directorio de Caché

Este directorio contiene la caché del servidor. Se establece según las siguientes fuentes en orden decreciente de prioridad.

1. Opción de línea de comandos --cachedir, si se especifica

2. Variable de entorno $JELLYFIN_CACHE_DIR, si se define

3. <Data Directory>/cache, si Windows

4. $XDG_CACHE_HOME/jellyfin si existe $XDG_CACHE_HOME

5. $HOME/.cache/jellyfin

Directorio Web

Este directorio contiene los archivos compilados de una versión del cliente web. Se establece según las siguientes fuentes en orden decreciente de prioridad.

1. Opción de línea de comandos --webdir, si se especifica

2. Variable de entorno $JELLYFIN_WEB_DIR, si se define

3. <Binary Directory>/jellyfin-web, donde <Binary Directory> es el directorio que contiene el ejecutable de Jellyfin

nota

Esta configuración solo se utiliza cuando el servidor está configurado para alojar el cliente web. Consulta la opción hostwebclient en la sección Opciones de configuración principales a continuación para más detalles.

Directorio de registros

Este es el directorio donde se almacenarán los registros de Jellyfin. Se establece a partir de las siguientes fuentes en orden de prioridad descendente.

1. Opción de línea de comandos --logdir, si se especifica

2. Variable de entorno $JELLYFIN_LOG_DIR, si se especifica

3. <Data Directory>/log

Configuración principal

La configuración principal del servidor se basa en el marco de configuración de ASP .NET, que proporciona un enfoque por niveles para cargar la configuración. El directorio base para ubicar los archivos de configuración se establece mediante el ajuste del directorio de configuración. Las fuentes de configuración son las siguientes, siendo que las fuentes posteriores tienen mayor prioridad y sobrescriben los valores de las fuentes anteriores.

1. Valores predeterminados codificados: Estos valores predeterminados se especifican en el código fuente de Jellyfin y no pueden modificarse.

2. Archivo de configuración de registro predeterminado (logging.default.json): Este archivo no debe modificarse manualmente por los usuarios. Está reservado para que el servidor lo sobrescriba con nuevas configuraciones en cada nueva versión.

3. Archivo de configuración de registro específico del sistema (logging.json): Este es el archivo que debes modificar si deseas tener una configuración de registro personalizada. Jellyfin utiliza el marco de registro Serilog, y puedes leer sobre las opciones de configuración disponibles en su documentación.

   nota

   Este archivo puede modificarse en tiempo de ejecución, lo que recargará automáticamente la configuración y aplicará los cambios de inmediato.

4. Variables de entorno: La documentación proporcionada por Microsoft explica cómo establecer estas opciones de configuración mediante variables de entorno. Jellyfin utiliza su propio prefijo personalizado JELLYFIN_ para estas variables. Por ejemplo, para establecer un valor para el ajuste HttpListenerHost:DefaultRedirectPath, deberías establecer un valor para la variable de entorno JELLYFIN_HttpListenerHost__DefaultRedirectPath.

5. Opciones de línea de comandos: Ciertas opciones de línea de comandos se cargan en el sistema de configuración y tienen la prioridad más alta. Las siguientes opciones de línea de comandos se asignan a opciones de configuración asociadas.

   • --nowebclient establece el ajuste de configuración hostwebclient en falso

Opciones de configuración principales

Esta sección enumera todas las opciones de configuración disponibles y explica su función.

Key	Default Value	Description
hostwebclient	True	Set to True if the server should host the web client.
FFmpeg:probesize	"1G"	Value to set for the FFmpeg probesize format option. See the FFmpg documentation for more details.
FFmpeg:analyzeduration	"200M"	The value to set for the FFmpeg analyzeduration format option. See the FFmpg documentation for more details.
PublishedServerUrl	Server Url based on primary IP address	The Server URL to publish in udp Auto Discovery response.

Fuentes

Jellyfin utiliza fuentes para renderizar texto en muchos lugares.

Fuentes del sistema en el servidor

Las fuentes del sistema instaladas en el servidor se utilizan para incrustar subtítulos y renderizar imágenes de portada. La forma de instalarlas depende del sistema operativo o si se está utilizando un contenedor.

Fuentes del sistema en el cliente

Las fuentes del sistema instaladas en los dispositivos cliente se utilizan para mostrar el texto en la interfaz del cliente y renderizar subtítulos en algunos clientes. La forma de instalarlas depende del sistema operativo.

Fuentes de reserva

Las Fallback Fonts instaladas en el servidor son cargadas por el cliente web para renderizar subtítulos ASS. Se utilizarán si no hay otras fuentes existentes (como archivos adjuntos MKV o fuentes del lado del cliente) que puedan renderizar ciertos glifos, como caracteres CJK, evitando así mostrar un bloque "tofu" vacío.

Esta configuración se puede establecer en una carpeta del servidor que contenga fuentes para este propósito. Estas fuentes están limitadas a un tamaño total de 20 MB, ya que todas se precargarán siempre en el navegador, independientemente de si serán necesarias o no. Se recomiendan formatos ligeros optimizados para la web como woff2. Una herramienta para convertir fuentes TrueType (.ttf) y OpenType (.otf) normales a woff2 se puede encontrar en su repositorio.

Descarga de fuentes

Existen muchas fuentes disponibles en línea. Google Fonts es un buen lugar para descargar fuentes para la mayoría de los idiomas.