jellyfin-plugin-douban新手配置指南请求间隔等5个关键设置一次讲透【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban如果你是 Jellyfin 用户想要让媒体库的电影和电视剧自动匹配豆瓣评分、简介、演员表与海报那么jellyfin-plugin-doubanJellyfin 豆瓣元数据刮削插件就是最合适的免费选择。本文是一份面向新手的 jellyfin-plugin-douban 配置指南重点讲解请求间隔等 5 个关键设置帮你避开封禁风险、一次配好豆瓣刮削器快速实现中文影视库的自动元数据刮削。jellyfin-plugin-douban 能做什么简单来说这个插件会把 Jellyfin 里的影视文件与豆瓣条目关联起来自动抓取以下信息电影 / 电视剧元数据中文片名、原名、简介、上映年份、国家地区、类型标签⭐豆瓣评分直接写入 Jellyfin 的评分字段演职人员导演、演员及头像️海报图片从豆瓣海报中自动挑选合适的图片️预告片链接部分影片会自动带上预告片地址插件的实现原理并不复杂它通过模拟豆瓣微信小程序的请求方式见 WechatClient.cs调用豆瓣的公开接口完成搜索与详情抓取因此不需要你提供任何账号或 API Key开箱即用。安装前的准备工作插件目录在哪里在配置之前先把插件放进正确的目录。手动安装步骤非常简单从 Release 页面下载最新版本并解压将Douban文件夹放入 Jellyfin 的plugins目录重启 Jellyfin 服务不同平台的插件目录位置如下这也是新手最容易卡住的一步系统插件目录路径Linux$HOME/.local/share/jellyfin/pluginsmacOS~/.local/share/jellyfin/pluginsDocker容器内/config/plugins宿主机路径看你的映射配置WindowsC:\ProgramData\Jellyfin\Server\plugins管理员权限启动装好后重启服务进入「控制台 → 我的插件」看到名为Douban的插件即表示安装成功。关键设置一请求间隔MinRequestInternalMs——防止被封禁的核心这是本插件唯一需要手动调节的数值型配置也是标题里提到的核心重点。豆瓣对频繁的接口请求非常敏感抓太快很容易触发风控导致 IP 被临时封禁。因此插件在 PluginConfiguration.cs 中提供了一个请求间隔参数MinRequestInternalMs最小请求间隔单位毫秒默认值为2000ms2 秒。配置入口在插件的配置页面对应 configPage.html进入「控制台 → 我的插件 → Douban → 设置」找到Minimum request Internal(ms)输入框建议保持2000ms 以上如果你批量导入大量影片、担心被抓可以调到 5000ms 更稳妥点击Save保存提示值越小刮削速度越快但被封风险越高值越大越安全但大批量刮削时等待更久。新手建议直接保持默认 2000ms不要低于 1000ms。关键设置二在库设置中启用豆瓣元数据提供方插件安装好并不代表立即生效你还需要在媒体库的元数据下载器中勾选它。打开「控制台 → 媒体库 → 对应影视库 → 编辑 → 元数据下载器」Series metadata downloaders勾选Douban TV Provider / Douban Movie Provider 豆瓣刮削器这里支持同时启用多个提供方并拖动排序比如把豆瓣放在 TheTVDB、TMDB 之前中文媒体就会优先使用豆瓣数据。保存后Jellyfin 在扫描媒体库时就会调用豆瓣刮削器电影走 MovieProvider.cs剧集走 TVProvider.cs。关键设置三启用豆瓣图片获取器记得先开高级设置海报获取是独立于元数据的另一套开关。在「编辑媒体库 → 图片获取器」Image Fetchers页面中勾选Douban Image Provider 豆瓣图片提供方⚠️新手常见坑很多人在图片获取器里找不到豆瓣选项是因为没有开启高级设置。请先点击页面右上角的齿轮或「显示高级设置」开启后图片获取器选项才会出现。豆瓣图片提供器由 ImageProvider.cs 实现会在豆瓣海报中尝试挑选最合适的图片覆盖电影和剧集两种类型。关键设置四调整刮削器优先级让中文数据排最前如果你同时安装了 TMDB、TVDB 等多个元数据插件它们之间是有竞争关系的。刮削器顺序决定了 Jellyfin 优先采用谁的数据。本插件的三个提供器电影、剧集、图片在源码中都设置了Order 3见各 Provider 文件属于中等优先级。建议你在媒体库设置中把豆瓣刮削器拖到列表最上方这样中文片名、豆瓣评分和简介会被优先采用如果某些冷门影片豆瓣没有条目Jellyfin 会自动回落到下一个提供方不用担心刮不到。关键设置五设置元数据语言与地区保证中文检索命中最后一个容易被忽略的设置是媒体库的元数据语言。豆瓣刮削器在搜索时会把片名中的.替换为空格见 BaseProvider.cs 中的搜索逻辑并按中文名称匹配条目。为了获得最佳匹配效果在「编辑媒体库 → 高级 → 元数据语言」中将首选语言设为中文地区建议选择「中国大陆」扫描模式建议设为「扫描所有文件」并勾选「替换已有元数据」以覆盖旧数据语言设置正确后搜索命中率会明显提升中文影视库的刮削体验会顺畅很多。常见问题与排错技巧Q1刮削出来的元数据是空的先确认是否已在媒体库中启用豆瓣提供方关键设置二并保证插件目录权限正常、服务已重启。也可以手动「刷新元数据」触发一次刮削。Q2大批量刮削时担心被封怎么办把请求间隔调大到 3000–5000ms并且不要在短时间内对上百部影片同时「刷新元数据」分批操作更安全。Q3多季电视剧能合并成一个条目吗目前插件不支持把多季剧集合并比如《权力的游戏》每一季会作为独立条目存在这是已知的功能限制。Q4插件装好后在哪里看配置代码配置文件与逻辑都很清晰配置类在 PluginConfiguration.cs配置页面在 configPage.html请求客户端在 WechatClient.cs想深入研究源码的同学可以直接查看。总结一份面向新手的快速配置清单最后把 5 个关键设置汇总成清单照着做即可完成 jellyfin-plugin-douban 配置✅ 确认插件已放入正确目录并重启服务✅ 请求间隔保持默认2000ms大批量刮削可调大✅ 在媒体库元数据下载器中勾选并置顶豆瓣刮削器✅ 开启高级设置后在图片获取器中勾选豆瓣图片提供方✅ 将媒体库元数据语言设为中文并手动刷新一次元数据验证效果按照这份 jellyfin-plugin-douban 新手配置指南操作你的 Jellyfin 就能稳定地从豆瓣获取中文影视元数据评分、简介、演员、海报一步到位从此告别「刮削全靠猜」的尴尬体验 【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
