jellyfin-plugin-douban实战教程：如何一键刮削电影评分、简介与演员元数据

jellyfin-plugin-douban实战教程：如何一键刮削电影评分、简介与演员元数据

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

喜欢用 Jellyfin 搭建家庭影音库的朋友，一定遇到过这样的烦恼：电影和剧集的海报、简介、评分、演员信息要么缺失，要么来自国外数据库，不符合中文用户的使用习惯。今天要介绍的jellyfin-plugin-douban就是一款专门解决这个问题的 Jellyfin 豆瓣刮削器插件，它能够自动从豆瓣抓取电影与电视剧的完整元数据，包括中文简介、豆瓣评分、导演与演员阵容等，让你轻松实现"一键刮削"。本文将从安装、配置到实战使用，带新手一步步完成整个部署流程。

jellyfin-plugin-douban 是什么？能刮削哪些元数据？

jellyfin-plugin-douban是 Jellyfin 官方生态下的第三方元数据插件（Metadata Provider），由开发者 Libitum 维护，核心定位是"Douban metadata provider for Jellyfin"。它的工作方式很简单：插件通过豆瓣 API 搜索片名，再拉取对应条目的详细信息，并写入 Jellyfin 的媒体库。

根据源码 BaseProvider.cs 的实现，插件主要刮削以下字段：

• 📊豆瓣评分：写入 Jellyfin 的 CommunityRating（社区评分）
• 📝剧情简介：同步豆瓣的影片介绍（Overview）
• 🎬导演与演员：自动关联导演、演员头像与角色信息
• 🗓️年份与首映日期：精确到上映时间（PremiereDate）
• 🌍制片地区与类型标签：如国家/地区、类型（Genres）
• 🖼️海报与剧照：从豆瓣海报中尝试匹配背景图片
• 🎞️预告片链接：有资源时会自动添加 Trailer

另外，插件在 MovieProvider.cs 中将豆瓣 ID（DoubanID）保存在媒体条目中，后续刷新元数据时无需重复搜索，效率更高。

一键安装豆瓣刮削器的 3 种方法

方法一：通过插件仓库在线安装（推荐）

这是最简单的方式，适合大多数普通用户：

1. 打开 Jellyfin 管理后台，进入「控制台 → 高级 → 插件」；
2. 点击「存储库（Repositories）」，添加豆瓣插件的仓库地址；
3. 保存后在「目录（Catalog）」中找到 Douban 插件，点击安装；
4. 重启 Jellyfin 服务，让插件生效。

方法二：手动安装插件文件

如果在线安装失败，也可以手动部署：

1. 从 Release 页面下载最新版本插件压缩包（或自行编译）；
2. 解压后，将Douban文件夹整个放入 Jellyfin 的 plugins 目录，不同系统路径如下：

3. 重启 Jellyfin 服务即可完成加载。

方法三：自行编译源码（进阶玩法）

想体验最新功能或二次开发的玩家，可以克隆源码自行编译：

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

仓库采用 .NET 编写，解决方案文件为 jellyfin-plugin-douban.sln，包含插件本体与测试项目 Jellyfin.Plugin.Douban.Tests，编译通过后按方法二部署即可。

刮削前的关键准备：先开启高级设置

不少新手反馈"装了插件却找不到入口"，这是因为豆瓣刮削器属于高级设置才显示的项目。请先进行以下准备：

1. 进入 Jellyfin「控制台 → 常规」；
2. 在「显示高级设置（Display advanced settings）」处开启开关；
3. 确认媒体库语言设置为中文，否则搜索匹配可能不够精准。

完成后再回到插件列表，就能看到 Douban 相关的下载器与图片获取器了。

最快配置方法：调整请求间隔避免封禁

豆瓣对高频请求比较敏感，插件默认内置了限流保护。进入「控制台 → 插件 → Douban → 设置」，可以看到配置项 PluginConfiguration.cs：

• MinRequestInternalMs（最小请求间隔）：默认2000ms，即两次请求至少间隔 2 秒，防止触发豆瓣风控。如果你刮削大批量影片，建议保持默认甚至调大。

保存配置后即可开始使用，无需重启服务。

实战：如何一键刮削电影元数据

第一步：启用豆瓣元数据下载器

打开「控制台 → 媒体库 → 电影」，点击「元数据下载器（Metadata downloaders）」，勾选Douban（即豆瓣刮削器），并将其拖动到列表顶部以优先使用。同理，电视剧需要在「剧集、季、集」三个层级都启用Douban TV Provider，官方截图参考如下：

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

海报与剧照同样重要。在「图片获取器（Image fetchers）」中勾选Douban Image Provider，确保封面能优先从豆瓣拉取：

💡 提示：界面上方提示了"只有在开启高级设置后才能看到此选项"，所以第一步的准备务必不要跳过。

第三步：执行刮削

1. 进入你的媒体库，找到未识别的电影；
2. 点击「编辑 → 搜索缺失的元数据」或「刷新元数据」；
3. Jellyfin 会调用 MovieProvider.cs 进行豆瓣搜索，选择正确的匹配项后，豆瓣评分、简介、演员等信息便会自动填入。

刮削完成后，你在影片详情页就能看到熟悉的豆瓣评分和中文简介了，信息展示与国内观影习惯完美契合。

使用技巧与注意事项

• 🎬电影与剧集分开处理：插件在 IDoubanClient.cs 中区分了movie和tv两种类型，搜索时会自动过滤，不用担心混淆。
• ⚠️不支持多季合并：目前插件不支持把多季剧集合成一条记录，例如《权力的游戏》每一季都是独立条目，属于已知限制。
• ⏱️批量刮削要耐心：受 2 秒最小请求间隔限制，大批量刷新会耗时较长，属于正常的防封策略，耐心等待即可。
• 🔄刷新失败时：可以先在 Jellyfin 中手动搜索片名确认豆瓣有该条目，排除片名拼写问题。

常见问题（FAQ）

Q1：启用后看不到 Douban 选项？请先确认已在「常规」中开启"显示高级设置"，然后重启 Jellyfin 服务。

Q2：插件能刮削电视剧吗？可以。支持电影与剧集两类，但需要在剧集、季、集三层分别启用下载器。

Q3：刮削速度很慢正常吗？正常。插件内置了请求限流（默认 2000ms），这是为了避免被豆瓣封禁而特意设计的。

Q4：评分和简介是中文的吗？是的，所有元数据均来自豆瓣，简介、评分、演员名均为中文信息。

总结

jellyfin-plugin-douban是目前在 Jellyfin 上体验中文元数据刮削的最佳方案之一，安装简单、配置灵活，尤其适合以中文影视内容为主的影音库。按照本文的步骤，从安装、配置到一键刮削电影评分与演员元数据，全程不超过 10 分钟。如果你也在为 Jellyfin 的中文元数据发愁，不妨立刻动手试试这款豆瓣刮削器！

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