让Jellyfin准确刮削,关键一步是换一个对中文内容支持更好的“刮削器”。目前中文社区最推荐的是 MetaShark 插件,它优先使用豆瓣的数据源,能极大提升中文影视内容的识别准确率。
🚀 为什么 MetaShark 是首选?
Jellyfin 默认的刮削器主要依赖 The Movie Database (TMDB),一个海外数据库,它连接不稳定,中文信息也经常不全。相比之下,MetaShark 的核心优势有:
中文识别率高:优先从豆瓣获取信息,解决了大部分国产影视剧的刮削难题。
信息更丰富:能带来更准确的海报、简介、演员表等信息,甚至能获取豆瓣评分。
双数据源保障:以豆瓣为主,如果豆瓣没有相关条目,会自动从 TMDB 补充数据,确保信息尽量完整。
📥 如何安装与配置 MetaShark
整个配置过程主要分三步:
1. 添加插件仓库
登录 Jellyfin 管理后台,进入 控制台,找到并点击 插件 菜单。
进入 存储库,点击 + 号添加仓库。
在 存储库名称 处填写
MetaShark,在 存储库 URL 处,为获得更快的下载速度,建议使用中国大陆镜像仓库地址https://ghfast.top/https://github.com/cxfksword/jellyfin-plugin-metashark/releases/download/manifest/manifest_cn.json点击 保存 即可。
2. 安装并激活插件
回到插件列表,在 目录 或 仓库 标签页中找到 MetaShark 插件,点击 安装。
安装完成后,根据页面提示 重启 Jellyfin 服务,让插件生效。
3. 配置媒体库刮削器
这是最关键的一步。重启后,进入 控制台 > 媒体库,选择需要优化的媒体库(如“电影”、“电视剧”),点击 管理媒体库。
在 元数据下载器 区域,只勾选
MetaShark,并将其拖动到列表最顶部,确保它是最优先使用的刮削器。其他元数据下载器(如 TheMovieDb)可以全部取消勾选,避免冲突导致数据错乱。
在 图片获取程序 区域,同样只勾选
MetaShark即可。
完成设置后,点击 确定 保存。
🔧 进阶优化:配置关键参数
为了让 MetaShark 发挥最佳效果,还需要对它进行一些关键配置。
找到插件:在 控制台 > 插件 > 我的插件 里找到
MetaShark,点击其右下角的菜单(三个点),选择 设置。TMDB API Key (强烈建议配置):这是获取电视剧集详细剧情和封面的关键。需要去 TMDB 官网 注册一个免费账号并申请 API Key,然后将获取到的 Key 填入
API Key字段。豆瓣 Cookie (建议配置):为稳定获取豆瓣信息,避免被限制。获取方法如下:
用电脑浏览器访问豆瓣电影首页 (
movie.douban.com) 并登录你的账号。在浏览器页面中按 F12 键(或右键选择“检查”)打开“开发者工具”。
切换到 网络 (Network) 标签页,刷新页面,然后在众多请求中找到任意一个指向
movie.douban.com的请求。点击该请求,在右侧出现的 请求头 (Request Headers) 中找到
Cookie:字段,将:之后的一大段完整字符串复制并粘贴到插件设置界面的豆瓣Cookie框中。
📁 为刮削扫清障碍:规范命名与结构
插件的准确度也依赖于规范的命名。良好的文件组织和命名是成功的一半。
📂 规范目录结构
电影:建议结构为
/电影库/蝙蝠侠:黑暗骑士 (2008)/蝙蝠侠:黑暗骑士 (2008).mkv。年份应放在括号内。电视剧:每一部剧集都应有单独的文件夹,其内按“季”划分。正确的结构是:
/电视剧库/绝命毒师 (2008)/Season 01/绝命毒师 S01E01.mkv。注意:即使是只有一季的电视剧,也必须创建
Season 01这样的季文件夹,将视频文件放入其中,否则刮削会失败。
✍️ 正确命名文件
电影:推荐格式
电影名 (年份).扩展名,例如肖申克的救赎 (1994).mkv。电视剧:推荐格式
剧集名 SXXEYY.扩展名,其中SXX代表季数,EYY代表集数,例如老友记 S01E01.mkv。强制匹配ID:如果某个电影始终无法正确刮削,可以在文件名或文件夹名中加入 TMDB 或 IMDb 的ID。例如,将文件夹命名为
楚门的世界 (1998) [tmdbid-331]来强制插件锁定该作品。
⚙️ 媒体库刷新策略
Jellyfin 提供了多种刷新方式,选对方式能避免已整理好的元数据被覆盖:
扫描新的和有修改的文件 (推荐):仅处理新增或有变动的文件,不会影响已存在的元数据。日常整理完文件后使用此选项最为稳妥。
搜索缺少的元数据:仅补充缺失的信息,会保留已有的手动修改。
替换所有元数据 (慎用):会完全覆盖已有的元数据,包括你手动修改过的信息。除非迫不得已,否则请避免使用。