跳至主内容
非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

配置

管理员可通过多种方式配置服务器设置。本节将概述所有配置方法，解释可用选项及其功能。

备注

此处配置选项与Web客户端管理员控制台的运行时设置不同。本节配置选项通常需在服务器启动前静态设置。

命令行选项​

运行Jellyfin可执行文件时添加--help标志可查看可用命令行选项文档。

服务器路径​

服务器使用的文件路径根据下方规则确定。非Windows系统默认遵循XDG规范。

数据目录​

此目录存储所有Jellyfin数据，同时也是下方其他路径的默认基础目录。按优先级从高到低顺序确定：

  1. 若指定命令行选项--datadir

  2. 若指定环境变量JELLYFIN_DATA_DIR

  3. 若通过Windows托盘应用启动：<%ProgramData%>\Jellyfin\Server

  4. 若直接启动Windows服务：<%LocalAppData%>\jellyfin

  5. 若存在$XDG_DATA_HOME：$XDG_DATA_HOME/jellyfin

  6. $HOME/.local/share/jellyfin

备注

Windows用户还可通过注册表键值指定：

  • 数据目录路径键：Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Jellyfin\Server下的字符串键DataFolder
  • 安装位置键：Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Jellyfin\Server下的字符串键InstallFolder

配置目录​

此目录包含服务器配置文件。按优先级从高到低顺序确定：

  1. 若指定命令行选项--configdir

  2. 若指定环境变量JELLYFIN_CONFIG_DIR

  3. <Data Directory>/config，若存在或在 Windows 上运行

  4. 若存在$XDG_CONFIG_HOME：$XDG_CONFIG_HOME/jellyfin

  5. $HOME/.config/jellyfin

缓存目录​

此目录包含服务器缓存文件。按优先级从高到低顺序确定：

  1. 若指定命令行选项--cachedir

  2. 若指定环境变量$JELLYFIN_CACHE_DIR

  3. Windows系统：<Data Directory>/cache

  4. 若存在$XDG_CACHE_HOME：$XDG_CACHE_HOME/jellyfin

  5. $HOME/.cache/jellyfin

Web资源目录​

此目录包含Web客户端构建文件。按优先级从高到低顺序确定：

  1. 若指定命令行选项--webdir

  2. 若指定环境变量$JELLYFIN_WEB_DIR

  3. <Binary Directory>/jellyfin-web（其中 <Binary Directory> 是包含 Jellyfin 可执行文件的目录）

备注

此设置仅在服务器配置为托管网页客户端时生效。详细信息请参阅下方主要配置选项章节中的 hostwebclient 选项。

日志目录​

该目录用于存储 Jellyfin 的运行日志，按以下优先级顺序确定存储路径：

  1. 若指定了命令行参数 --logdir

  2. 若设置了环境变量 $JELLYFIN_LOG_DIR

  3. <Data Directory>/log

主配置文件​

服务器主配置基于 ASP .NET 配置框架构建，采用分层配置加载机制。配置文件的基础目录由配置目录设置决定。配置源按以下顺序加载（后加载的配置优先级更高，会覆盖先前设置）：

  1. 硬编码默认值：这些默认值在 Jellyfin 源代码中设定，用户无法修改

  2. 默认日志配置文件 (logging.default.json)：用户不应手动修改此文件。服务器会在每次新版本发布时覆盖更新该文件

  3. 系统专用日志配置文件 (logging.json)：如需自定义日志配置，应修改此文件。Jellyfin 使用 Serilog 日志框架，具体配置选项请参阅其官方文档

    备注

    此文件支持运行时修改，配置变更将自动重载并立即生效

  4. 环境变量：通过 Microsoft 文档说明的方式设置。Jellyfin 使用自定义前缀 JELLYFIN_。例如：要为 HttpListenerHost:DefaultRedirectPath 配置项赋值，需设置 JELLYFIN_HttpListenerHost__DefaultRedirectPath 环境变量

  5. 命令行参数：部分命令行参数会注入配置系统并拥有最高优先级。以下命令行参数会映射到对应配置项：

    • --nowebclient 会将 hostwebclient 配置项设为 false

主要配置选项​

本节列出所有可用配置选项并说明其功能

KeyDefault ValueDescription
hostwebclientTrueSet 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.
PublishedServerUrlServer Url based on primary IP addressThe Server URL to publish in udp Auto Discovery response.

字体配置​

Jellyfin 在多处场景需要使用字体渲染文本

服务端系统字体​

服务器安装的系统字体用于烧录字幕和渲染封面图片。安装方式取决于操作系统或容器环境

客户端系统字体​

客户端设备安装的系统字体用于界面文本显示及部分客户端的字幕渲染。安装方式取决于操作系统

后备字体​

服务器安装的 Fallback Fonts 会被网页客户端加载用于渲染 ASS 字幕。当其他字体源（如 MKV 内嵌字体或客户端字体）无法渲染特定字形（如 CJK 字符）时，将使用这些字体避免显示为空白方块（"tofu"）

此设置可指向服务器上包含字体的文件夹。这些字体的总大小限制为 20 MB，因为无论是否需要，所有字体都会在浏览器中预加载。推荐使用针对 Web 优化的轻量级格式（如 woff2）。将常规 TrueType (.ttf) 和 OpenType (.otf) 字体转换为 woff2 格式的工具可在其代码库中找到。

下载字体​

网上有大量字体资源可供下载。Google Fonts 是获取支持多语言字体的优质资源平台。