Jellyfin电影分级常见技术问题：如何正确配置元数据和封面？

Question

**Jellyfin电影分级常见技术问题：如何正确配置元数据和封面？** 在使用 Jellyfin 搭建个人媒体库时，许多用户遇到电影分级信息显示异常、元数据抓取失败或封面无法加载的问题。常见疑问包括：应选择哪种元数据插件（如 The Movie Database, Local Metadata）？如何确保 Jellyfin 正确识别电影并匹配分级信息？本地元数据的文件结构与命名规范是怎样的？封面图片格式和存放路径有哪些要求？此外，部分用户反馈即使已配置正确，仍出现分级图标不显示或评级来源错误的情况。本文将围绕这些问题，深入解析 Jellyfin 中电影元数据与封面配置的关键步骤与排错方法。

Answer 1

一、Jellyfin 元数据插件的选择与配置

Jellyfin 支持多种元数据插件，其中最常用的是 The Movie Database (TMDb) 和 Local Metadata。TMDb 提供全球通用的电影信息数据库，适合大多数用户；而 Local Metadata 则适合已有本地元数据文件的用户。

• TMDb：需网络连接，自动抓取电影标题、简介、演员、分级等信息。
• Local Metadata：需手动维护 XML 文件和封面图片，适用于离线环境。

配置建议：优先使用 TMDb 插件，确保网络畅通；若需本地管理，则需严格遵循命名规范。

二、电影识别与分级信息匹配

Jellyfin 通过文件名识别电影。为确保分级信息正确匹配，需遵循以下命名规范：

1. 电影文件命名格式应为：电影名称 (年份).ext，如 Interstellar (2014).mp4。
2. 文件夹结构推荐为：/Movies/电影名称 (年份)/电影名称 (年份).mp4。
3. 若使用 Local Metadata，还需在电影文件夹中放置 movie.xml 文件。

在 Jellyfin 管理界面中，可启用“匹配电影标题”选项，并定期运行“刷新元数据”以更新分级信息。

三、本地元数据文件结构与命名规范

若使用 Local Metadata 插件，需构建符合 Jellyfin 识别规则的目录结构。示例如下：

/Movies/
└── Inception (2010)
    ├── Inception (2010).mp4
    ├── movie.xml
    ├── poster.jpg
    └── fanart.jpg

关键命名规则：

• movie.xml：必须存在于电影文件夹中，用于存储元数据。
• poster.jpg：主封面图，用于电影列表展示。
• fanart.jpg：背景图，用于电影详情页背景。

四、封面图片格式与存放路径要求

Jellyfin 支持常见的图片格式，如 JPG、PNG、GIF 等。但推荐使用 JPG 或 PNG 以保证兼容性。

封面图片应存放在电影文件夹内，或通过 Jellyfin 配置指定封面路径。以下为推荐设置：

图片类型	推荐格式	推荐文件名	存放位置
主封面	JPG / PNG	poster.jpg 或 movie.jpg	电影文件夹根目录
背景图	JPG / PNG	fanart.jpg	电影文件夹根目录

如需自定义封面路径，可在 Jellyfin 管理界面中设置“图像路径”。

五、分级图标不显示或评级来源错误的排查

即使配置正确，仍可能出现分级图标不显示或评级来源错误的问题。以下是常见原因及排查步骤：

1. 网络问题：检查 Jellyfin 是否能访问 TMDb API（需科学上网）。
2. 插件未启用：确认 TMDb 或 Local Metadata 插件已启用。
3. 元数据未刷新：进入电影详情页，点击“刷新元数据”。
4. 评级字段为空：检查 movie.xml 或 TMDb 返回数据中是否包含 rating 字段。
5. 客户端兼容问题：部分客户端（如 Android）可能不支持某些评级图标。

此外，可在 Jellyfin 的日志中搜索“rating”或“metadata”，定位具体错误。

六、高级配置与调试技巧

对于高级用户，可进一步优化 Jellyfin 的元数据抓取流程：

• 配置 manifest.json 自定义元数据抓取规则。
• 使用 Jellyfin API 获取电影元数据并调试。
• 启用调试日志，查看完整的元数据抓取过程。

示例命令：获取某部电影的元数据信息

curl -X GET "http://localhost:8096/Items?Ids=MovieIdHere&api_key=your_api_key"

七、总结与下一步建议

通过合理配置元数据插件、规范文件结构与命名、正确设置封面路径，可以有效解决 Jellyfin 中电影分级信息显示异常的问题。如仍存在问题，建议结合日志分析和 API 调试进一步排查。