如何在 Jellyfin 中添加和组织库：完整指南

将媒体库添加到 Jellyfin 后，您可以将包含电影、电视节目、音乐、照片或个人视频的文件夹转换为可浏览的目录。 封面、剧情简介、季数和整理好的信息但是，为了获得正确的结果，Jellyfin 必须能够访问该文件夹并确切地知道其中包含什么类型的内容。

文件存储在何处并不重要 还能用的旧电脑可以是外置硬盘或NAS。基本原则是，路径必须对运行Jellyfin的计算机、服务或容器可见。您个人电脑上可以打开的文件夹可能不会自动对服务器可用。

在开始之前，最好先将每个类别分开。电影、电视剧和音乐使用不同的元数据结构和提供商。为每种类型创建专门的库可以减少错误识别，并简化未来的维护工作。

Jellyfin 中的库是什么？

图书馆是 由一个或多个文件夹组成的虚拟集合文件仍保留在原位置；Jellyfin 只分析路径，将有关路径的信息保存到其数据库中，并通过其应用程序显示结果。

一个媒体库可以包含来自多个位置的文件。例如，您可以创建一个名为“电影”的媒体库，并将内部硬盘上的一个文件夹和NAS上的另一个文件夹都添加到其中。即使文件存储在不同的设备上，它们也会同时显示在界面中。

但这并不意味着你应该混用不同类别的内容。你可以在一个电影库中合并多个电影文件夹，但最好不要将电视剧或音乐文件夹添加到同一个收藏集中。

添加文件夹前如何准备文件夹

在打开 Jellyfin 面板之前，请确认服务器可以读取该文件夹。Jellyfin 在执行扫描或尝试播放文件时，该路径必须始终可访问。

如果媒体文件位于本地磁盘上，请授予运行 Jellyfin 的用户权限。 文件夹和文件的读取权限只有当您希望允许 Jellyfin 将图像、NFO 文件或其他数据与内容一起保存，或者您已启用文件删除功能时，才需要写入权限。

使用 SMB 或 NFS 资源时，必须将其挂载到服务器操作系统上。Jellyfin 设计用于直接从文件系统读取数据，而不是存储从其他计算机访问的网络文件夹凭据。

如果您正在考虑如何存放大量藏品，可以查看以下选项： 家用NAS存储确保每次重启后以及启动 Jellyfin 之前，资源都已自动挂载。

Jellyfin 使用 Docker 时如何挂载媒体文件夹

容器无法自动访问主机系统上的所有文件夹。您必须添加一个卷，将实际位置连接到 Jellyfin 可访问的内部路径。

例如：

services:
  jellyfin:
    image: jellyfin/jellyfin
    volumes:
      - /mnt/multimedia/peliculas:/media/peliculas:ro
      - /mnt/multimedia/series:/media/series:ro

在这个例子中， /mnt/multimedia/peliculas 是主机的路线， /media/peliculas 这是 Jellyfin 可以在容器内识别的库。因此，创建库时，您必须选择：

/media/peliculas

不要在 Jellyfin 中输入主机路径，因为 容器内不存在该位置。后缀 :ro 以只读模式挂载媒体文件，这足以进行扫描和播放。仅当需要 Jellyfin 修改该文件夹时才使用写入权限。

如果文件夹已挂载但显示为空，请检查容器运行所使用的用户和组。他们的凭据必须具有访问目录和读取文件的权限。

如何一步一步地向 Jellyfin 添加库

文件夹可访问后，请使用管理员帐户完成以下步骤：

1. 打开 Jellyfin 网页界面。
2. 打开主菜单。
3. 进入 管理 > 控制面板.
4. 选择 服务器 > 库.
5. 按 添加媒体库.
6. 选择内容类型。
7. 请输入将显示在界面上的名称。
8. 按下该符号 + 添加文件夹。
9. 选择路线或手动输入路线。
10. 配置元数据的语言和国家/地区。
11. 查看其他选项并保存库。

Jellyfin 将开始分析文件并显示进度条。小型图库可能几乎立即显示，而大型图库则需要更多时间来识别内容和下载图像。

在此过程中，您可以继续使用该界面，但封面图、季数和剧情简介将逐步显示，直到该过程完成。 图书馆初探.

你应该选择哪种类型的内容

类型决定了 Jellyfin 如何解析文件夹结构以及它使用哪些视频提供商。选择错误的类型可能会导致一部电影显示为一集，或者整个剧集显示为多个独立的视频。

图书馆类型	推荐内容
电影	按片名和年份分别排列的故事片。
系列	节目按剧集、季和单集文件夹进行分类。
音乐	专辑和歌曲的内部标签填写正确。
音乐视频	不属于电影或电视剧的音乐视频和表演。
照片	个人图片已整理成文件夹。
图书	通过相应的插件，可获取书籍、漫画和有声读物。
家庭录像和照片	不具备自动影片识别功能的个人录像。

请勿使用该类型 混合电影和剧集当前文档认为此方法已过时，不建议使用，因为它会产生不可靠的结果。如果一个文件夹同时包含这两个类别，请在创建库之前将它们分开。

如何整理电影、电视节目和音乐

本指南重点介绍如何向服务器添加路由。完整的命名结构在“如何操作”一文中有详细说明。 在 Jellyfin 中添加和整理电影和电视节目但这些是基本规则。

电影

每部影片都应该有自己的文件夹，并尽可能包含影片标题和年份：

Peliculas/
└── Nombre de la película (2025)/
    └── Nombre de la película (2025).mkv

年份有助于区分重制版和同名影片。您还可以添加厂商标识符以提高匹配度：

Nombre de la película (2025) [tmdbid-ID]

系列

剧集应按季划分，并使用易于识别的集数编号：

Series/
└── Nombre de la serie (2025)/
    ├── Season 01/
    │   ├── Nombre de la serie S01E01.mkv
    │   └── Nombre de la serie S01E02.mkv
    └── Season 02/
        └── Nombre de la serie S02E01.mkv

季节 00 它通常用于存放特别节目。一个文件可以包含多个连续的剧集，格式如下： S01E01-E02.

音乐

对于音乐文件而言，嵌入在文件中的元数据比文件名更重要。每个文件夹应该只包含一张专辑。

Musica/
└── Artista/
    └── Álbum/
        ├── Canción 01.flac
        └── Canción 02.flac

在执行首次扫描之前，请检查艺术家、专辑艺术家、专辑名称、曲目编号和光盘编号等字段。

如何配置库元数据

Jellyfin 从 TMDb、OMDb 等提供商以及本地 NFO 文件获取信息。在创建库时，您可以选择 首选语言和国家/地区 用于下载片名、剧情简介和评分。

可以为每个库配置语言，因此动漫、西班牙电影或原版电影的合集可以使用与其他合集不同的设置。

本地 NFO 文件优先于远程提供程序。如果重命名文件夹后 Jellyfin 仍然显示过时的信息，请检查该文件是否存在。 .nfo 那就是强加这些数据。

如果标题与错误的作品关联，请使用项目识别工具或在文件夹名称中添加标识符，例如： [tmdbid-ID], [imdbid-ID] o [tvdbid-ID]然后它会再次更新元数据。

对于更复杂的情况，请参阅如何 Jellyfin 中封面图和元数据问题的故障排除.

如何向同一个库中添加多个文件夹

您无需为每个磁盘创建单独的库。Jellyfin 允许您添加 多条同类型的路线 并将它们作为一个整体系列展示。

例如，电影库可能包括：

/media/disco-interno/peliculas
/media/nas/peliculas
/media/disco-usb/peliculas

这三个位置将同时显示在所选名称下。当您的收藏集不断增长，需要将其分布在多个硬盘驱动器上时，此设置非常有用。

避免同时添加父文件夹及其子文件夹。如果同时添加，则可能会出现问题。 /media/peliculas 而且 /media/peliculas/animacionJellyfin 可能会对同一内容进行两次分析，从而生成重复项。

如何让用户看到新库

拥有所有图书馆访问权限的用户将自动收到新合集。但是，仅配置为查看特定图书馆的用户将不会收到。 他们不会自动获得访问权限。.

批准它：

1. 打开 控制面板.
2. 进入 用户.
3. 选择相应的个人资料。
4. 打开 获取图书馆资源.
5. 为新图书馆做标记。
6. 保存更改。

这一步骤在以下情况下尤为重要： 在 Jellyfin 中配置子配置文件因为一座新的图书馆可能要经过审查和明确授权后才能对外公布。

如何更新或重新分析库

Jellyfin 会运行计划任务来检测更改，但您也可以启动手动扫描。打开库菜单并选择相应选项。 分析或更新它.

实时监控功能允许您在无需等待下次扫描的情况下检测新增或修改的文件。但是，它并非适用于所有文件系统。像 NFS 或 rclone 这样的工具可能不会生成必要的事件，因此您需要依赖计划任务或手动扫描。

如果您只更正了一个标题的 ID，则无需重新分析整个馆藏。只需更新受影响条目的元数据，即可避免不必要的调用和处理。

如何修改或删除库

从 控制面板 > 库 您可以打开收藏集的选项来更改其名称、添加或删除文件夹以及查看其元数据提供程序。

删除路径前，请检查它是否是某些文件的唯一存放位置。如果您使用的是 NAS 或 USB 驱动器，还要确认其已连接：暂时不可用的驱动器可能会显示为已不存在的路径。

网络存储断开连接时，请勿执行维护任务或完整扫描。Jellyfin 可能会从目录中移除找不到的项目。这些文件不会从 NAS 中删除，但您需要恢复连接并重新扫描媒体库。

在 Jellyfin 中添加库时常见的错误

该文件夹未出现在选择器中。

Jellyfin进程无法访问该位置。请确认驱动器已挂载，并且服务用户拥有访问文件夹和读取文件的权限。

Docker 路径似乎为空。

您可能已经输入了主机路径。请检查已配置的卷，并在 Jellyfin 中选择它。 容器的内部路径.

库已创建，但未显示任何文件。

检查权限、内容类型和文件夹结构。根据官方文档，最常见的两个原因是： 权限错误和组织不兼容 用扫描仪。

这些电影属于该系列。

你使用了混合文件夹或选择了错误的文件夹类型。请将类别分开，并为电影和电视剧创建专门的库。

相同的标题出现重复。

检查是否添加了重叠路径，例如父文件夹及其子文件夹。此外，还要检查是否使用两个不同的路径挂载了同一资源。

Jellyfin下载了错误的封面或简介

更正名称和年份，或添加供应商 ID。然后更新受影响商品的元数据。

新文件不会自动显示。

启动手动扫描并检查计划任务。如果文件夹使用 NFS、rclone 或其他不支持事件的系统，则实时监控可能无法正常工作。

NAS断开连接后，内容会消失。

Jellyfin 在路径不可访问时对其进行了扫描。请恢复挂载，确认文件再次可见，然后重新扫描库。

部分用户看不到新库

权限受限的用户账户需要手动授权。打开用户账户，进入“图书馆访问”页面，选择馆藏，然后保存更改。

音乐分组似乎有误。

检查文件的内部标签。Jellyfin 主要使用嵌入式元数据来识别艺术家、专辑、光盘和曲目。

正确地将库添加到 Jellyfin 包括选择正确的类型、指定服务器可访问的路径，以及遵循每个内容类的预期结构。大多数问题并非由播放器本身引起，而是由…… 不可见的路径、权限不足或名称不兼容.

导入大量书籍之前，请先尝试导入一个包含两到三本书的文件夹。如果 Jellyfin 能正确识别这些书，请展开路径或移动剩余的文件。此步骤可避免您在初始扫描后需要更正数百个条目。