Jellyfin.Plugin.MetaShark配置详解：10个关键设置优化你的元数据刮削体验
【免费下载链接】jellyfin-plugin-metasharkjellyfin电影元数据插件项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark
想要让你的Jellyfin媒体库拥有丰富的中文元数据吗？Jellyfin.Plugin.MetaShark是一款专为中文用户设计的元数据刮削插件，它能从豆瓣和TheMovieDb（TMDB）获取高质量的影片信息。本文将详细介绍10个关键配置设置，帮助你优化元数据刮削体验，让你的媒体库更加专业和美观！🎬
MetaShark插件的主要功能是从豆瓣获取影片信息，并由TheMovieDb补全缺失的剧集数据，特别适合中文用户使用。它支持anime动画命名格式，能够为你的Jellyfin媒体库提供丰富的中文元数据，包括影片简介、演员信息、海报和背景图等。
1️⃣ 豆瓣Cookie配置：解锁更多影片信息 🔓
在MetaShark的配置页面中，最重要的设置之一就是豆瓣Cookie。这个设置允许插件访问需要登录才能查看的影片信息。你可以在豆瓣网站登录后，复制浏览器的cookie信息粘贴到这里。
配置位置：Jellyfin.Plugin.MetaShark/Configuration/configPage.html中的DoubanCookies字段
使用技巧：
- Cookie格式应为：
_vwo_uuid_v2=1; __utmv=2; ... - 使用分号分隔不同的cookie项
- 配置后插件会显示"已生效"或"已失效"状态提示
2️⃣ 防封禁功能：安全刮削大量影片 🛡️
如果你需要刮削大量电影，强烈建议开启防封禁功能。这个设置在PluginConfiguration.cs中对应EnableDoubanAvoidRiskControl属性。
为什么需要开启？
- 频繁请求豆瓣可能导致IP被封（通常需要等待6小时才能恢复）
- 开启后刮削速度会变慢，但更加安全稳定
- 建议与豆瓣Cookie一起使用效果更佳
3️⃣ 豆瓣图片优化设置：提升显示质量 🖼️
MetaShark提供了两个重要的图片优化选项：
海报使用大图（EnableDoubanLargePoster）
- 默认开启，获取更高分辨率的电影海报
- 让你的媒体库封面更加清晰美观
背景图使用原图（EnableDoubanBackdropRaw）
- 默认关闭，因为豆瓣对原图访问限制更严格
- 仅在特殊需求时开启
4️⃣ 豆瓣图片代理地址：解决图片显示问题 🌐
当使用Nginx代理、Docker部署或启用HTTPS时，豆瓣图片可能无法正常显示。这时需要在DoubanImageProxyBaseUrl字段中填写你的Jellyfin访问域名。
填写格式：https://jellyfin.xxx.com:8920
- 如果有端口号，一定要加上
- 只有图片显示异常时才需要配置
5️⃣ TheMovieDb自动匹配：补全缺失元数据 🔄
EnableTmdbMatch设置允许插件在豆瓣匹配失败时，自动尝试从TheMovieDb获取元数据。这是确保刮削成功率的关键设置！
工作原理：
- 优先从豆瓣获取中文元数据
- 如果豆瓣找不到，自动切换到TheMovieDb
- 结合两者的优势，提供最完整的影片信息
6️⃣ 剧集元数据获取：电视剧和动漫支持 📺
对于电视剧和动漫爱好者，EnableTmdb设置至关重要。开启后，插件会从TheMovieDb获取详细的剧集元数据，包括：
- 每集标题和简介
- 播出日期
- 导演和编剧信息
- 剧集缩略图
7️⃣ TheMovieDb搜索结果：双重确认机制 🔍
EnableTmdbSearch设置让插件在识别时同时返回TheMovieDb的搜索结果。这提供了双重确认机制，确保匹配的准确性。
使用场景：
- 当豆瓣搜索结果不明确时
- 需要对比不同数据源的信息
- 确保影片匹配的准确性
8️⃣ 图片和商标补全：美化媒体库 🎨
MetaShark提供了多个图片相关的优化设置：
背景图补全（EnableTmdbBackdrop）
- 当豆瓣找不到背景图时，使用TheMovieDb的高质量背景
- 提升媒体库的视觉效果
商标获取（EnableTmdbLogo）
- 获取影片的官方商标图片
- 增强媒体库的专业感
9️⃣ 分级信息和成人内容：内容过滤设置 ⚠️
影片分级信息（EnableTmdbOfficialRating）
- 获取影片的官方分级信息（如PG-13、R级等）
- 注意：开启后会略微降低刮削速度
R18内容显示（EnableTmdbAdult）
- 控制是否显示成人评级内容
- 根据家庭使用需求进行配置
🔟 自动创建合集：智能整理系列电影 🎪
EnableTmdbCollection设置允许插件根据TheMovieDb的电影系列信息自动创建合集。
重要提示：
- 这个功能与媒体库配置中的"自动添加到合集"功能冲突
- 使用前需要先关闭媒体库的自动合集功能
- 可以自动整理如"漫威电影宇宙"、"哈利波特系列"等电影合集
TheMovieDb API配置：高级用户选项 🔧
对于有特殊需求的用户，MetaShark还提供了完整的TheMovieDb API配置选项：
自定义API Key（TmdbApiKey）
- 填写你自己的TheMovieDb API密钥
- 需要重启Jellyfin才能生效
API域名选择（TmdbHost）
- 可选
api.tmdb.org或api.themoviedb.org - 默认使用
api.tmdb.org
代理服务器配置
- 支持HTTP、HTTPS、Socks5三种代理类型
- 配置代理服务器Host和端口
- 同样需要重启才能生效
配置最佳实践：新手快速上手指南 🚀
根据不同的使用场景，我们推荐以下配置方案：
家庭影院用户：
- 开启豆瓣Cookie（可选）
- 开启TheMovieDb自动匹配
- 开启剧集元数据获取
- 开启背景图补全和商标获取
大量影片刮削：
- 开启防封禁功能
- 配置豆瓣Cookie
- 分批进行刮削操作
- 监控刮削进度
动漫爱好者：
- 确保文件名符合anime命名格式
- 开启所有TheMovieDb相关功能
- 特别注意剧集元数据的获取
常见问题解决：遇到问题怎么办 ❓
豆瓣图片无法显示：
- 检查豆瓣图片代理地址配置
- 确认网络连接正常
- 尝试关闭HTTPS重试
刮削速度过慢：
- 关闭防封禁功能（如果刮削量不大）
- 检查网络连接
- 分批进行刮削操作
影片匹配错误：
- 检查文件名格式
- 开启TheMovieDb搜索结果显示
- 手动指定影片ID进行匹配
配置文件位置：深入了解插件结构 📁
MetaShark的主要配置文件位于：
- 插件配置页面：
Jellyfin.Plugin.MetaShark/Configuration/configPage.html - 配置类定义：
Jellyfin.Plugin.MetaShark/Configuration/PluginConfiguration.cs - 豆瓣API实现：
Jellyfin.Plugin.MetaShark/Api/DoubanApi.cs - TheMovieDb API实现：
Jellyfin.Plugin.MetaShark/Api/TmdbApi.cs
通过合理配置这10个关键设置，你的Jellyfin媒体库将拥有更加丰富和准确的中文元数据，观影体验将得到显著提升！🌟 记得根据实际需求调整配置，并在大量刮削时开启防封禁功能保护你的IP地址。
【免费下载链接】jellyfin-plugin-metasharkjellyfin电影元数据插件项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metashark
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
