个人媒体库搭建实践：将 YouTube 视频整合至 Jellyfin NAS 系统
在数字内容所有权日益受到挑战的当下，对重要视频资源进行本地化存档已成为一种必要手段。随着企业互联网平台对艺术内容的管控趋严，用户往往无法真正拥有其收藏的内容。对于长期依赖 YouTube 的用户而言，定期备份“喜欢的视频”播放列表是确保数据可访问性的基础措施。
虽然存在许多易于上手且默认配置合理的下载工具，但要将数百个视频有效组织、存储并整合进现有的家庭实验室基础设施中，则需要更为复杂的定制化方案。以下案例展示了一位用户如何构建基于 NAS 和 Jellyfin 的自动化 YouTube 视频归档系统。
核心需求与技术挑战
该用户的媒体管理需求主要集中在以下四个方面：
- 电视端播放支持：视频需能在电视大屏上流畅播放。
- NAS 基础设施集成：必须无缝融入现有的网络附属存储（NAS）架构。
- 大规模播放列表管理：需要在几十个播放列表中组织数百个视频，这比单纯的文件存储更具挑战性。
- 自动化维护：新增视频或调整分类不能依赖手动操作，需实现批量自动化处理。
Jellyfin 与元数据结构适配
该用户的 NAS 媒体库核心基于 Jellyfin 搭建。Jellyfin 原生具备播放列表功能，但其逻辑设计主要针对音乐专辑场景，即从现有曲目中抽取部分歌曲组成独立于主库的播放列表。然而，Jellyfin 对电影、电视节目（季节/剧集结构）以及艺术家（专辑/歌曲结构）有着严格的层级定义，缺乏对 YouTube 频道内自定义播放列表的原生支持。
为解决这一结构性冲突，用户采取了“伪装”策略：在 Jellyfin 中创建一个名为“YouTube”的图书馆，并将其模式设定为“电视节目”。通过关闭所有外部元数据抓取器，并优先使用文件数据而非文件名解析，强制 Jellyfin 按照预设的文件路径结构进行索引。
自动化工具链：yt-dlp 与 ytdl-sub
系统的自动化核心由 yt-dlp 及其封装工具 ytdl-sub 构成。ytdl-sub 是一个自主托管的 Docker Compose 应用，允许用户通过 Web 应用程序（如 VSCode IDE）进行配置和管理。它负责维护播放列表结构，并根据自定义配置文件收集元数据。
在实际操作中，ytdl-sub 默认会将视频标记为特定字段，并存储在以播放列表命名的文件中。这种处理方式导致 Jellyfin 出现重复索引问题：每个视频同时出现在“年度系列”和“播放列表系列”两个位置。针对此问题，用户发现可以通过将播放列表标题映射为 ytdl-sub 配置文件中的“季号”来解决。尽管这一做法看似违背常规逻辑，但在实际运行中却能有效避免重复。
需要注意的是，一旦视频被 Jellyfin 导入，更新季号等元数据信息较为困难，通常需要通过媒体管理软件手动触发“更新元数据”操作来修复。
存储优化与 Tdarr 转码服务
存储容量是该系统的主要瓶颈。为此，用户引入了 Tdarr 服务，用于自动重新编码视频库。Tdarr 能够将视频转换为更小、更高效的格式或编解码器，从而节省存储空间，代价则是消耗大量的处理能力。
尽管 Tdarr 能够胜任重编码任务，但其用户界面复杂且设计欠佳，并不推荐给普通用户。只有当用户对构建复杂的工作流程有强烈兴趣，并愿意投入精力调试脚本以防止数据流错误时，才建议使用该工具。此外，通过更精细的下载参数控制，可以在一定程度上降低存储成本，但这需要较高的技术门槛。
总结
该案例展示了个人媒体服务器在应对非标准内容源时的灵活性。虽然像 yt-dlp 这样的命令行工具文档详尽，但对于大多数用户而言，图形化界面更易接受。家庭实验室项目的魅力在于其永远无法达到完美的状态，这种持续优化的过程本身构成了技术爱好者的动力源泉。
