Jellyfin在Windows安装时如何配置媒体库路径？

Question

**问题：** 在Windows系统上安装Jellyfin后，如何正确配置媒体库路径以确保媒体文件被顺利识别和展示？是否需要特定的文件夹权限设置或路径格式要求？

Answer 1

一、Jellyfin媒体库配置概述

Jellyfin 是一个功能强大的媒体服务器软件，支持在 Windows、Linux 和其他平台上运行。正确配置媒体库路径是使用 Jellyfin 的关键步骤之一，决定了媒体文件是否能被顺利识别和展示。

在 Windows 系统上安装 Jellyfin 后，用户需要通过其 Web 管理界面配置媒体库路径。路径的设置不仅包括文件夹位置，还涉及文件夹权限和命名规范等。

二、配置媒体库路径的基本步骤

1. 打开 Jellyfin Web 管理界面（默认地址为 http://localhost:8096）。
2. 进入“Dashboard”（仪表盘） > “Library”（媒体库） > “Add media library”（添加媒体库）。
3. 选择媒体类型：电影、电视剧、音乐等。
4. 点击“Add path”（添加路径）按钮，选择本地磁盘上的媒体文件夹。
5. 确认路径格式是否为绝对路径（如 D:\Media\Movies）。
6. 设置元数据语言、图像语言等选项后，点击“Save”保存。

保存后，Jellyfin 会自动扫描该路径下的媒体文件，并尝试匹配元数据。

三、路径格式要求与注意事项

Jellyfin 对媒体路径的格式有一定要求，尤其在 Windows 系统上需要注意以下几点：

• 路径必须为绝对路径，不支持相对路径或网络路径（UNC）。
• 路径中避免使用中文或特殊字符，建议使用英文命名。
• 路径应为标准的 NTFS 格式，避免 FAT32 或其他格式。
• 如果媒体文件位于另一个分区或外部硬盘，需确保该盘符已挂载并被 Jellyfin 服务访问。

例如，一个推荐的路径格式为：D:\Media\TV_Shows

四、文件夹权限设置详解

Jellyfin 在 Windows 上默认以“LocalSystem”账户运行，因此需要确保该账户对媒体文件夹具有读取权限。若使用自定义服务账户，则需为该账户设置访问权限。

操作步骤如下：

1. 右键点击媒体文件夹 > “属性” > “安全”标签。
2. 点击“编辑”按钮，添加用户“LocalSystem”或服务运行账户。
3. 勾选“读取”权限，确认保存。

若权限未正确设置，Jellyfin 将无法访问该路径，导致媒体库为空或扫描失败。

五、媒体文件命名规范与结构要求

Jellyfin 能自动识别媒体文件的前提是文件命名和文件夹结构符合其扫描逻辑。以下为常见命名规范：

• 电影文件命名示例：Movie.Title.2023.1080p.BluRay.x264.mkv
• 电视剧文件夹结构示例：

    TV_Shows/
    └── Friends
        ├── Season 01
        │   ├── Friends.S01E01.mkv
        │   └── Friends.S01E02.mkv
        └── Season 02
            └── Friends.S02E01.mkv
    

遵循上述结构，有助于 Jellyfin 正确识别剧集信息并展示为剧集列表。

六、常见问题与排查流程

在配置媒体库路径过程中，常见问题包括：

• 媒体库为空：检查路径权限和扫描设置。
• 无法识别剧集：检查文件命名是否符合规范。
• 扫描进度卡住：查看 Jellyfin 日志（位于安装目录下的 logs 文件夹）。

以下为问题排查流程图：

            graph TD
                A[开始] --> B{路径是否正确?}
                B -- 是 --> C{权限是否设置?}
                C -- 是 --> D{命名是否规范?}
                D -- 是 --> E[媒体识别成功]
                D -- 否 --> F[调整命名格式]
                C -- 否 --> G[设置文件夹权限]
                B -- 否 --> H[修改路径为绝对路径]
        

七、进阶配置与优化建议

对于有经验的 IT 工程师，可以考虑以下优化措施：

• 使用符号链接（symlink）将多个分区或网络路径映射到统一目录。
• 配置 Jellyfin 使用外部元数据插件（如 TheMovieDB）提升识别准确率。
• 启用“自动刷新”功能定期扫描媒体库。
• 通过脚本定期清理无效文件或重命名文件以符合规范。

例如，使用 PowerShell 创建符号链接的命令如下：

        mklink /D "D:\Media\TV_Shows" "\\NAS\Media\TV_Shows"
    

此命令将 NAS 上的媒体路径映射到本地，便于 Jellyfin 扫描。