Jellyfin 元数据刮削完整教程用 MetaShark 插件一次刮对中文影视信息【免费下载链接】jellyfin-plugin-metasharkjellyfin电影元数据插件项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark把中文影视导入 Jellyfin 后经常遇到系统认错片名、海报缺失、剧集信息查不到这三类问题。MetaShark 是一个针对这些痛点做的元数据刮削插件影片信息主要从豆瓣获取TheMovieDbTMDB负责补全缺失的剧集数据。下面带你把安装、配置和排障流程完整走一遍。用 3 分钟安装并跑通 MetaShark 插件选择安装方式插件仓库安装推荐在 Jellyfin 控制台进入插件仓库添加页填入 MetaShark 的仓库地址。国内加速版manifest_cn.json与国际版manifest.json两个地址都列在项目 README 中按你的网络情况选择。添加成功后在仓库里搜索 MetaShark 并安装。手动下载解压仓库地址无法访问时到项目的 Release 页面下载最新插件包解压到 Jellyfin 的插件目录即可使用。媒体库里的两步启用打开控制台 → 插件确认 MetaShark 状态为Active。打开控制台 → 媒体库进入目标媒体库设置页在元数据下载器中勾选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文件确认。️ 元数据刮削四大常见故障排查图片加载失败的三步排查确认部署方式使用 Nginx、Docker 或 HTTPS 时把 Jellyfin 访问域名填进豆瓣图片代理地址。保存后对该影片重新触发图片刷新。仍不显示多半是豆瓣反盗链此时依赖默认开启的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考