如何快速增强Jellyfin媒体库？MetaShark元数据插件完整配置指南 🚀
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark Jellyfin电影元数据插件MetaShark是一款专为Jellyfin媒体服务器打造的高效元数据获取工具，能够自动从豆瓣和TheMovieDb获取电影、剧集的详细信息，完美兼容anime动画命名格式，让你的媒体库管理更轻松！
📌 为什么选择MetaShark插件？核心优势解析
MetaShark作为Jellyfin生态中备受欢迎的元数据插件，凭借两大核心优势脱颖而出：
- 双源数据聚合：深度整合豆瓣电影数据库与TheMovieDb资源，同时支持中文影视信息精准匹配和全球影视数据补充，解决单一数据源信息不全的痛点。
- 智能命名解析：内置AnitomySharp解析引擎（AnitomySharp/），轻松识别复杂的动画命名格式，如
[SubGroup] Anime Title S01E01 [1080p].mkv等特殊命名规则。
图：MetaShark插件官方标识，象征高效的元数据嗅探能力
🛠️ 技术架构速览：插件如何工作？
MetaShark采用分层架构设计，核心模块包括：
- 数据接口层：通过Jellyfin.Plugin.MetaShark/Api/实现豆瓣API（DoubanApi.cs）和TheMovieDb API（TmdbApi.cs）的数据交互
- 元数据处理层：Core/NameParser.cs负责文件名智能解析，StringMetric/JaroWinkler.cs提供字符串相似度算法
- 媒体库集成层：通过Providers/目录下的MovieProvider、SeriesProvider等实现与Jellyfin媒体库无缝对接
📥 3步快速安装：从下载到激活
准备工作
确保已安装：
- Jellyfin媒体服务器（10.9.x或10.10.x版本）
- .NET Core SDK 9.0（源码编译需用）
安装步骤
1️⃣ 获取插件安装包
推荐通过Jellyfin插件存储库自动安装：
- 国内用户：添加仓库地址
https://ghfast.top/https://github.com/cxfksword/jellyfin-plugin-metashark/releases/download/manifest/manifest_cn.json - 手动安装：从Release页面下载最新版本压缩包，解压至Jellyfin插件目录（通常为
/path/to/jellyfin/data/plugins/metashark/）
2️⃣ 启用插件
进入Jellyfin控制台 → 插件页面，确认MetaShark插件状态为Active（激活）。若未激活，点击"启用"按钮并重启Jellyfin服务。
3️⃣ 配置媒体库
在控制台 → 媒体库中选择目标媒体库：
- 进入编辑页面，在"元数据下载器"选项中勾选MetaShark
- 点击"上移"按钮将其调整为首选下载器
- 保存设置后，系统将自动使用MetaShark获取新添加媒体的元数据
⚙️ 高级配置技巧：让元数据获取更精准
核心设置项（Configuration/PluginConfiguration.cs）
| 设置项 | 推荐值 | 作用 |
|---|---|---|
| TheMovieDb数据开关 | 按需启用 | 关闭可提升国内网络环境下的刮削速度 |
| 防封禁功能 | 开启 | 自动控制请求频率，避免豆瓣API限制（Core/Utils.cs实现限流逻辑） |
| 图片代理设置 | 国内用户建议配置 | 解决豆瓣图片加载缓慢问题（需填写Jellyfin访问域名） |
常见场景配置方案
- 动画爱好者：保持默认配置，利用内置的AnitomySharp解析器（AnitomySharp/Tokenizer.cs）精准识别动画剧集
- 海量媒体库：开启防封禁功能并降低并发请求数，通过ScheduledTasks/RefreshMetadataTask.cs实现定时增量更新
- 低配置服务器：关闭TheMovieDb数据获取，仅保留豆瓣数据源，减少系统资源占用
💡 实用技巧：提升元数据获取成功率
- 文件名优化：保持文件名包含完整标题和年份，如
肖申克的救赎 (1994).mp4 - 批量更新：使用"媒体库 → 刷新元数据"功能批量更新现有媒体信息
- 问题排查：查看Jellyfin日志（路径：
/var/log/jellyfin/jellyfin.log）中的MetaShark相关记录，定位刮削失败原因
❓ 常见问题解答
Q：插件安装后不显示怎么办？
A：检查插件目录权限（确保Jellyfin用户可访问），删除meta.json文件后重启服务（FAQ）
Q：豆瓣数据刮削突然失败？
A：可能触发豆瓣API限制，开启防封禁功能后等待6小时（IP封禁自动解除）
Q：剧集信息不完整？
A：确认TheMovieDb数据源已启用，剧集数据主要由TmdbApi.cs提供
📚 开发与扩展
如需自定义功能，可基于源码进行二次开发：
- 克隆仓库：
git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark - 构建项目：
dotnet publish --configuration=Release（Jellyfin.Plugin.MetaShark.csproj） - 本地测试：将生成的DLL文件放入Jellyfin插件目录的
metashark文件夹
📝 免责声明
本项目代码仅用于学习交流编程技术，下载后请勿用于商业用途。如涉及侵权，请联系开发者删除相关内容。
通过以上步骤，你已掌握MetaShark插件的完整配置方法！现在就开始打造更丰富的Jellyfin媒体库体验吧～ 🎬
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
