Jellyfin 元数据刮削完整教程：用 MetaShark 插件一次刮对中文影视信息

Jellyfin 元数据刮削完整教程：用 MetaShark 插件一次刮对中文影视信息

【免费下载链接】jellyfin-plugin-metasharkjellyfin电影元数据插件项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark

把中文影视导入 Jellyfin 后，经常遇到系统认错片名、海报缺失、剧集信息查不到这三类问题。MetaShark 是一个针对这些痛点做的元数据刮削插件：影片信息主要从豆瓣获取，TheMovieDb（TMDB）负责补全缺失的剧集数据。下面带你把安装、配置和排障流程完整走一遍。

用 3 分钟安装并跑通 MetaShark 插件

选择安装方式

1. 插件仓库安装（推荐）：在 Jellyfin 控制台进入插件仓库添加页，填入 MetaShark 的仓库地址。国内加速版（manifest_cn.json）与国际版（manifest.json）两个地址都列在项目 README 中，按你的网络情况选择。添加成功后在仓库里搜索 MetaShark 并安装。
2. 手动下载解压：仓库地址无法访问时，到项目的 Release 页面下载最新插件包，解压到 Jellyfin 的插件目录即可使用。

媒体库里的两步启用

1. 打开控制台 → 插件，确认 MetaShark 状态为Active。
2. 打开控制台 → 媒体库，进入目标媒体库设置页，在元数据下载器中勾选MetaShark并把它移到第一位，保存。

为什么必须排第一：Jellyfin 按顺序查询下载器，排在最前时 MetaShark 的识别结果优先生效，内置数据源就不会抢先抓错片名。保存后触发一次媒体库扫描，看新增影片的元数据是否变正确。

根据你的媒体库配置豆瓣与 TMDB

豆瓣侧重点检查的 3 个开关

• 启用防封禁（默认关闭）：批量刮削时请求密集，容易触发豆瓣风控，IP 被限制后约 6 小时才能恢复。开启后刮削速度会变慢，但能避免整批任务失败，官方说明建议搭配网站 cookie 一起使用。
• 豆瓣网站 cookie（默认为空）：按分号分隔的格式填入后，可以搜索到需要登录才能访问的影片。保存后配置页会实时校验，直接显示"已生效"或"已失效"，cookie 过期不用猜。
• 豆瓣图片代理地址（默认为空）：用 Nginx 反向代理、Docker 或 HTTPS 部署、且豆瓣图片不显示时才需要填。填 Jellyfin 的访问域名，带端口时要把端口一起写上。

TMDB 开关速查表

TMDB 相关开关除两项默认关闭外，其余默认都是开启的，照默认用即可：

配置项	默认值	何时需要调整
TheMovieDb 自动匹配	开	保持开启：豆瓣匹配不到时会改用 TMDB，提高命中率
从 TMDB 获取剧集元数据	开	网络访问 TMDB 不畅时关闭；注意关闭后不会再获取剧集信息
显示 TheMovieDb 搜索结果	关	识别时想同时参考 TMDB 候选结果就打开
用 TMDB 补全背景图 / 商标	开	豆瓣缺背景图时自动补上，无需改动
从 TMDB 获取影片分级信息	开	开启后刮削会变慢，追求速度可关闭
显示 R18 评级内容	关	按需开启，搜索和刮削都会包含 R18 内容
按电影系列自动创建合集	开	与媒体库的"自动添加到合集"冲突，二选一

需要重启的 3 个进阶项

以下三项选填，多数用户用不到：

• 自定义 Api Key：内置默认 Key 频繁触发限流时，换成自己的。
• Api Host：在 api.tmdb.org 与 api.themoviedb.org 两个域名间选择，默认 api.tmdb.org。
• Api 代理：提供禁用、HTTP、HTTPS、Socks5 四种类型，再填 Host 和端口。

这三项官方标注均为需重启才能生效。各开关的默认值与定义，可以对照源码中的Jellyfin.Plugin.MetaShark/Configuration/PluginConfiguration.cs文件确认。

🛠️ 元数据刮削四大常见故障排查

图片加载失败的三步排查

1. 确认部署方式：使用 Nginx、Docker 或 HTTPS 时，把 Jellyfin 访问域名填进"豆瓣图片代理地址"。
2. 保存后对该影片重新触发图片刷新。
3. 仍不显示多半是豆瓣反盗链，此时依赖默认开启的 TMDB 背景图补全兜底。

豆瓣 IP 被限制

一旦触发防封禁风控，该 IP 约 6 小时内无法访问豆瓣。计划批量刮削前，先把"启用防封禁"打开，并避开高峰时段执行，而不是等被封了再处理。

修复 Bad IL format 错误

安装后插件加载失败、日志出现System.BadImageFormatException: Bad IL format时，通常是插件目录里有残留文件：删除 metashark 插件文件夹内所有隐藏文件和meta.json，重启服务后重新检查。

动画命名识别

插件采用 anitomy 方式解析动画文件名，支持"第 01 集""ep01"这类集数写法，也支持中英文混合标题（中文片名后接原名）。文件名里保留完整动画名和集数，是识别准确的最可靠做法。

两个定时任务自动补全数据

MetaShark 在控制台的计划任务页注册了两个任务：

• 扫描自动创建合集：需先在配置中开启"根据 TMDB 电影系列信息自动创建合集"，默认每天执行一次，按系列信息自动建立合集。
• 重新刮削失败的影片：找出仍缺少 provider ID 的影片重新刮削，把首次漏掉的元数据补回来。

下一步

现在就可以动手：先到"控制台 → 插件"确认 Active 状态，再进媒体库设置勾选 MetaShark 并置顶；然后对照上表按需求调整开关，最后触发一次媒体库扫描。如果库比较大，记得先把防封禁打开再开始刮削。

【免费下载链接】jellyfin-plugin-metasharkjellyfin电影元数据插件项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark