5分钟快速上手jellyfin-plugin-douban：免费为Jellyfin安装豆瓣刮削器的入门教程

5分钟快速上手jellyfin-plugin-douban：免费为Jellyfin安装豆瓣刮削器的入门教程

【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban

jellyfin-plugin-douban 是一款免费开源的 Jellyfin 豆瓣刮削器插件，能自动为电影和电视剧抓取豆瓣评分、剧情简介、导演演员与海报等元数据。本文提供一份完整的 Jellyfin 豆瓣插件入门教程，从安装到配置只需 5 分钟，帮你轻松解决中文影视库刮削不准、封面错乱的烦恼，让媒体库信息与豆瓣同步。

一、为什么你需要 Jellyfin 豆瓣刮削器？

用 Jellyfin 搭建私人影视库时，默认刮削源（TheMovieDb、TheTVDB）对中文影视的匹配并不友好：国产片、老剧常常识别成英文名，简介翻译生硬，海报也经常对不上。jellyfin-plugin-douban 就是为解决这个问题而生的豆瓣元数据插件：它直接从豆瓣抓取影片信息，中文识别率极高，尤其适合以华语影视为主的媒体库。

该项目基于 C# 编写，核心功能包括：

相关实现可以参考源码：MovieProvider.cs、TVProvider.cs 与 ImageProvider.cs。

二、安装前准备：确认你的插件目录

无论哪种安装方式，都需要先知道 Jellyfin 的插件目录在哪，常见平台如下：

📌 找不到目录也没关系，更多细节见项目文档 README.md。

三、两种安装方式任选其一

方式一：通过插件仓库一键安装（推荐新手）

1. 打开 Jellyfin 控制台 → 「插件」→「存储库」；
2. 添加插件仓库地址（具体仓库地址请查阅项目 README.md 中的说明）；
3. 回到「目录」页面搜索 Douban，点击安装并重启 Jellyfin。

方式二：手动安装（通用兜底）

1. 从 Release 页面下载最新版本压缩包（或自行编译）；
2. 解压后，将Douban文件夹放入上文对应的 plugins 目录；
3. 重启 Jellyfin 服务即可生效。

可选：自行编译最新版

想尝鲜最新功能，可以克隆仓库后自行编译：

git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban

项目已配置好解决方案文件 jellyfin-plugin-douban.sln，使用dotnet build即可构建，插件入口代码见 Plugin.cs。

四、5分钟配置教程：开启豆瓣刮削

第一步：打开「显示高级设置」

进入 Jellyfin 控制台 →「显示」→ 勾选「显示高级设置」。⚠️ 如果不开启，后面将看不到图片提供器的相关选项。

第二步：在媒体库中启用豆瓣元数据下载器

进入「媒体库」→ 编辑剧集或电影库 →「元数据下载器」区域，勾选Douban Provider，并把它拖到列表最上方以获得最高优先级。剧集部分记得对 Series、Seasons、Episodes 都启用：

第三步：启用豆瓣图片获取器

切换到「图片获取器」标签页，勾选Douban Image Provider，这样海报和背景图也会优先来自豆瓣：

第四步：调整请求间隔防止封禁

进入控制台 →「插件」→ Douban →「Minimum request Internal(ms)」即最小请求间隔，默认 2000 毫秒。如果你的媒体库很大、需要批量刮削，可以适当调大该值（比如 3000~5000），避免短时间内大量请求触发豆瓣反爬机制。配置逻辑见 configPage.html 与 PluginConfiguration.cs。

五、常见问题与使用技巧

Q1：刮削不到元数据怎么办？先检查媒体库是否已勾选 Douban Provider，再确认文件名是否规范（建议「影片名.年份」格式）。插件的搜索逻辑见 BaseProvider.cs。

Q2：多季美剧怎么处理？该插件目前不支持把多季合并成一个条目，例如《权力的游戏》每一季都是独立条目。建议按「剧名.年份.S01」等格式分目录存放。

Q3：被豆瓣限流/封禁了？调大最小请求间隔，并减少同时触发的扫描任务。插件内置了带延迟的请求客户端 WechatClient.cs 与结果缓存 LRUCache.cs，可有效缓解压力。

六、结语

至此，你的 Jellyfin 豆瓣刮削器已经配置完成。下次刷新或扫描媒体库时，中文影视会自动配上豆瓣评分、简介与海报，观影体验瞬间提升。如果遇到问题，欢迎查看项目的 CHANGELOG.md 了解版本变化，或查阅测试用例 MovieProviderTest.cs 学习更多用法。祝你的影视库越用越顺手！🎬

【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban