Jellyfin多版本电影合并机制解析与解决方案

背景概述

在媒体服务器应用中，用户经常需要管理同一部电影的不同版本（如1080p和4K版本）。Jellyfin作为一款开源媒体服务器，其多版本合并功能与用户预期的差异引发了本次技术讨论。典型场景涉及：

• 不同分辨率版本存储在不同路径（常见于多Radarr实例配置）
• 文件命名符合官方规范（包含tmdbid等元数据标识）
• 预期行为应自动合并为单一电影条目

核心问题分析

通过用户案例可见，当采用如下目录结构时：

/movies/1080p/电影名 (年份) [tmdbid=ID]/...
/movies/2160p/电影名 (年份) [tmdbid=ID]/...

Jellyfin 10.10.7版本未能像Emby那样自动合并版本。这主要涉及两个技术层面：

1. 路径识别机制
   Jellyfin默认将不同物理路径视为独立项目，即便元数据标识相同。这与部分用户的预期（基于元数据合并）存在差异。

2. 版本检测逻辑
   系统更倾向于通过文件名后缀（如- Director's Cut）或专用版本标识来区分，而非单纯依赖分辨率路径。

解决方案建议

方案一：调整目录结构（推荐）

采用Jellyfin官方推荐的多版本存储结构：

/movies/电影名 (年份) [tmdbid=ID]/
  ├─ 电影名 (年份) [1080p].mkv
  └─ 电影名 (年份) [2160p].mkv

关键点：

• 所有版本置于同一父目录
• 通过方括号标注版本特征
• 保持一致的tmdbid标识

方案二：使用硬链接（高级）

在不改变物理存储位置的情况下创建硬链接：

ln /movies/1080p/.../movie.mkv /movies/merged/电影名 (年份)/movie_1080p.mkv
ln /movies/2160p/.../movie.mkv /movies/merged/电影名 (年份)/movie_2160p.mkv

优势：

• 保持现有Radarr多实例配置
• 对Jellyfin呈现单一目录视图
• 不占用额外存储空间

方案三：自定义元数据（灵活方案）

通过.nfo文件强制指定关联：

<movie>
  <uniqueid type="tmdb" default="true">138843</uniqueid>
  <title>The Conjuring</title>
  <year>2013</year>
</movie>

注意需确保：

• 所有版本nfo文件包含完全一致的唯一标识
• 启用Jellyfin的nfo元数据读取功能

技术原理延伸

Jellyfin的媒体聚合逻辑遵循优先级：

1. 物理路径关联性
2. 文件名模式匹配
3. 嵌入式元数据
4. 外部nfo文件

理解这一层级关系有助于用户合理规划存储方案。对于需要保持多Radarr实例的场景，建议结合硬链接技术与标准化命名规范，既满足自动化工具需求，又保证Jellyfin的正确识别。

版本兼容性说明

该行为在10.10.x系列版本中保持稳定，用户需注意：

• 避免使用特殊字符作为版本标识符（如括号/引号）
• 4K版本建议标注HDR/DV等特性
• 定期执行"刷新元数据"强制重新识别