Zenith Horizon

Jellyfin 媒体库刮削插件 MetaShark 安装配置指南

2026/04/18
loading

让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 发挥最佳效果,还需要对它进行一些关键配置。

  1. 找到插件:在 控制台 > 插件 > 我的插件 里找到 MetaShark,点击其右下角的菜单(三个点),选择 设置

  2. TMDB API Key (强烈建议配置):这是获取电视剧集详细剧情和封面的关键。需要去 TMDB 官网 注册一个免费账号并申请 API Key,然后将获取到的 Key 填入 API Key 字段。

  3. 豆瓣 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 提供了多种刷新方式,选对方式能避免已整理好的元数据被覆盖:

  • 扫描新的和有修改的文件 (推荐):仅处理新增或有变动的文件,不会影响已存在的元数据。日常整理完文件后使用此选项最为稳妥。

  • 搜索缺少的元数据:仅补充缺失的信息,会保留已有的手动修改。

  • 替换所有元数据 (慎用):会完全覆盖已有的元数据,包括你手动修改过的信息。除非迫不得已,否则请避免使用。

Author: Max

Permalink: /archives/jellyfin-metashark

Published: 2026-04-18 10:37:52

Updated: 2026-04-18 10:34:47

License: 本文采用知识共享署名-非商业性使用 4.0 国际许可协议进行许可

CATALOG