jellyfin-plugin-douban剧集攻略电视剧、季与单集元数据刮削的完整指南【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban如果你正在使用 Jellyfin 搭建自己的影音库一定知道刮削Scraping意味着自动从网上获取评分、简介、海报、演员等信息。而jellyfin-plugin-douban正是一款让 Jellyfin 从豆瓣获取元数据的插件——它不仅能刮削电影还完整支持电视剧、季与单集三层元数据刮削。本指南将手把手带你完成安装、配置与排错让你的剧集库一次到位。 jellyfin-plugin-douban 剧集刮削能力一览jellyfin-plugin-douban 的核心是 BaseProvider.cs 抽象基类它统一处理豆瓣接口调用、搜索与信息转换再分别由 MovieProvider.cs 和 TVProvider.cs 实现。其中剧集部分的刮削能力如下层级支持内容说明 电视剧 Series评分、简介、年代、国家、类型、导演、演员、预告片支持按名称自动搜索也可用豆瓣 ID 精准锁定️ 季 Season季号IndexNumber、年代从豆瓣原名中的 Season N 识别季数️ 单集 Episode集名、集数、父级季号、简介依赖规范的剧集文件名️ 图片海报Primary、部分背景图Backdrop由 ImageProvider.cs 提供小提示插件的刮削器统一命名为豆瓣刮削器排序优先级 Order 为 3方便与其他刮削器如 TheTVDB、TMDB混合使用并调整先后顺序。 安装豆瓣刮削插件的两种最快方法方法一手动安装推荐新手获取最新版本插件包Release 产物或自行编译将解压后的Douban文件夹放入 Jellyfin 的plugins目录重启 Jellyfin 服务让插件被加载。不同系统的插件目录位置系统插件目录Linux~/.local/share/jellyfin/pluginsmacOS~/.local/share/jellyfin/pluginsDocker容器内/config/plugins宿主机路径看映射配置WindowsC:\ProgramData\Jellyfin\Server\plugins方法二clone 源码自行编译如果你希望尝试最新特性或二次开发可 clone 本仓库后编译git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban编译产物放入上述plugins目录即可。⚙️ 一步开启电视剧元数据刮削器安装并重启后进入 Jellyfin 控制台 →媒体库→ 找到你的剧集媒体库 → 点击「设置」找到Series metadata downloaders系列元数据下载器区域勾选Douban TV Provider豆瓣电视剧提供商可同时勾选 TheTVDB、TMDB 等作为备选并通过上移/下移调整优先级保存后执行「扫描媒体库」剧集元数据即开始刮削。设置界面中的绿色提示也强调请务必为Series剧、Seasons季、Episodes单集三层都启用「Douban Provider」。️ 开启豆瓣图片刮削记得先打开高级设置很多用户反馈为什么找不到豆瓣图片选项——因为Douban Image Provider 默认隐藏需要先在媒体库设置中开启「高级设置」Advanced Settings才会显示。开启后在Series Image Fetchers系列图片获取器中勾选Douban Image Provider即可。它会从豆瓣海报中寻找合适的图片作为封面与背景图。 防封禁提醒豆瓣对高频请求比较敏感。插件默认在每次请求之间保留最小 2000ms 间隔可在插件配置的MinRequestInternalMs中调整请勿把该值调得太小否则容易被豆瓣临时封禁导致刮削失败。 电视剧、季与单集三层刮削机制详解剧集刮削的难点在于三层结构。理解 jellyfin-plugin-douban 的机制能帮你少踩很多坑1️⃣ 电视剧 Series自动搜索 DoubanID 锁定Jellyfin 会调用 TVProvider.cs 中GetMetadata(SeriesInfo)先用剧名在豆瓣搜索取第一个匹配结果一旦刮削成功豆瓣 IDDoubanID会写回媒体库之后刷新时会直接按 ID 精准获取不再搜索。2️⃣ 季 Season靠豆瓣原名中的 Season N 识别季的刮削不单独搜索而是复用电视剧的 DoubanID从豆瓣条目的原名Original_Title中匹配Season (\d)模式来得到季号。这意味着若豆瓣条目原名不含 Season N季号可能无法正确识别每一季在豆瓣中是独立条目因此不支持把多季电视剧合并成一部——比如《权力的游戏》每一季都是单独刮削、单独展示的。3️⃣ 单集 Episode文件名必须规范单集刮削时插件会读取文件的IndexNumber集数与ParentIndexNumber季号并写入集名与简介。如果文件名不规范导致读不到集数插件会直接跳过并提示检查文件名格式。推荐命名规范建议格式示例剧名.S01E01.清晰度.编码权力的游戏.S01E01.1080p.BluRay剧名 - S01E01 - 集名绝命毒师 - S01E01 - Pilot规范的命名能让 Jellyfin 与插件都准确识别季号、集号刮削成功率更高。️ 剧集刮削的常见问题与解决技巧刮削出来是空的 / 搜索无结果先确认网络能访问豆瓣接口再把MinRequestInternalMs调大一些如 3000~5000ms避免触发风控。有文字信息但没有图片检查是否已开启「高级设置」并勾选了 Douban Image Provider。季号识别错误检查豆瓣条目原名是否包含 Season N必要时手动锁定正确的豆瓣条目。多季合并失败这是插件的已知限制请把每一季当作独立条目管理并在 Jellyfin 中设置正确的排序。想强制刷新某部剧在媒体库中选中剧集 → 「刷新元数据」勾选「替换现有元数据」即可重新刮削。 想深入了解源码速查剧集三层刮削入口Jellyfin.Plugin.Douban/Providers/TVProvider.cs公共元数据转换逻辑Jellyfin.Plugin.Douban/Providers/BaseProvider.cs海报与背景图获取Jellyfin.Plugin.Douban/Providers/ImageProvider.cs请求间隔配置项Jellyfin.Plugin.Douban/Configuration/PluginConfiguration.cs豆瓣 ID 映射ExternalIdJellyfin.Plugin.Douban/ExternalID.cs 结语掌握了 jellyfin-plugin-douban 的剧集刮削逻辑你就能轻松搞定电视剧、季与单集的元数据管理装好插件 → 开启三个层级的刮削器 → 规范命名 → 按需调整请求间隔一部井然有序的剧集影音库就完成了。如果刮削遇到问题优先检查文件名规范与高级设置九成问题都能迎刃而解。快去给你的 Jellyfin 装上这款豆瓣刮削利器吧【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/20 17:01:28 · 阅读 1.2k jellyfin-plugin-douban剧集攻略：电视剧、季与单集元数据刮削的完整指南
jellyfin-plugin-douban剧集攻略电视剧、季与单集元数据刮削的完整指南【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban如果你正在使用 Jellyfin 搭建自己的影音库一定知道刮削Scraping意味着自动从网上获取评分、简介、海报、演员等信息。而jellyfin-plugin-douban正是一款让 Jellyfin 从豆瓣获取元数据的插件——它不仅能刮削电影还完整支持电视剧、季与单集三层元数据刮削。本指南将手把手带你完成安装、配置与排错让你的剧集库一次到位。 jellyfin-plugin-douban 剧集刮削能力一览jellyfin-plugin-douban 的核心是 BaseProvider.cs 抽象基类它统一处理豆瓣接口调用、搜索与信息转换再分别由 MovieProvider.cs 和 TVProvider.cs 实现。其中剧集部分的刮削能力如下层级支持内容说明 电视剧 Series评分、简介、年代、国家、类型、导演、演员、预告片支持按名称自动搜索也可用豆瓣 ID 精准锁定️ 季 Season季号IndexNumber、年代从豆瓣原名中的 Season N 识别季数️ 单集 Episode集名、集数、父级季号、简介依赖规范的剧集文件名️ 图片海报Primary、部分背景图Backdrop由 ImageProvider.cs 提供小提示插件的刮削器统一命名为豆瓣刮削器排序优先级 Order 为 3方便与其他刮削器如 TheTVDB、TMDB混合使用并调整先后顺序。 安装豆瓣刮削插件的两种最快方法方法一手动安装推荐新手获取最新版本插件包Release 产物或自行编译将解压后的Douban文件夹放入 Jellyfin 的plugins目录重启 Jellyfin 服务让插件被加载。不同系统的插件目录位置系统插件目录Linux~/.local/share/jellyfin/pluginsmacOS~/.local/share/jellyfin/pluginsDocker容器内/config/plugins宿主机路径看映射配置WindowsC:\ProgramData\Jellyfin\Server\plugins方法二clone 源码自行编译如果你希望尝试最新特性或二次开发可 clone 本仓库后编译git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban编译产物放入上述plugins目录即可。⚙️ 一步开启电视剧元数据刮削器安装并重启后进入 Jellyfin 控制台 →媒体库→ 找到你的剧集媒体库 → 点击「设置」找到Series metadata downloaders系列元数据下载器区域勾选Douban TV Provider豆瓣电视剧提供商可同时勾选 TheTVDB、TMDB 等作为备选并通过上移/下移调整优先级保存后执行「扫描媒体库」剧集元数据即开始刮削。设置界面中的绿色提示也强调请务必为Series剧、Seasons季、Episodes单集三层都启用「Douban Provider」。️ 开启豆瓣图片刮削记得先打开高级设置很多用户反馈为什么找不到豆瓣图片选项——因为Douban Image Provider 默认隐藏需要先在媒体库设置中开启「高级设置」Advanced Settings才会显示。开启后在Series Image Fetchers系列图片获取器中勾选Douban Image Provider即可。它会从豆瓣海报中寻找合适的图片作为封面与背景图。 防封禁提醒豆瓣对高频请求比较敏感。插件默认在每次请求之间保留最小 2000ms 间隔可在插件配置的MinRequestInternalMs中调整请勿把该值调得太小否则容易被豆瓣临时封禁导致刮削失败。 电视剧、季与单集三层刮削机制详解剧集刮削的难点在于三层结构。理解 jellyfin-plugin-douban 的机制能帮你少踩很多坑1️⃣ 电视剧 Series自动搜索 DoubanID 锁定Jellyfin 会调用 TVProvider.cs 中GetMetadata(SeriesInfo)先用剧名在豆瓣搜索取第一个匹配结果一旦刮削成功豆瓣 IDDoubanID会写回媒体库之后刷新时会直接按 ID 精准获取不再搜索。2️⃣ 季 Season靠豆瓣原名中的 Season N 识别季的刮削不单独搜索而是复用电视剧的 DoubanID从豆瓣条目的原名Original_Title中匹配Season (\d)模式来得到季号。这意味着若豆瓣条目原名不含 Season N季号可能无法正确识别每一季在豆瓣中是独立条目因此不支持把多季电视剧合并成一部——比如《权力的游戏》每一季都是单独刮削、单独展示的。3️⃣ 单集 Episode文件名必须规范单集刮削时插件会读取文件的IndexNumber集数与ParentIndexNumber季号并写入集名与简介。如果文件名不规范导致读不到集数插件会直接跳过并提示检查文件名格式。推荐命名规范建议格式示例剧名.S01E01.清晰度.编码权力的游戏.S01E01.1080p.BluRay剧名 - S01E01 - 集名绝命毒师 - S01E01 - Pilot规范的命名能让 Jellyfin 与插件都准确识别季号、集号刮削成功率更高。️ 剧集刮削的常见问题与解决技巧刮削出来是空的 / 搜索无结果先确认网络能访问豆瓣接口再把MinRequestInternalMs调大一些如 3000~5000ms避免触发风控。有文字信息但没有图片检查是否已开启「高级设置」并勾选了 Douban Image Provider。季号识别错误检查豆瓣条目原名是否包含 Season N必要时手动锁定正确的豆瓣条目。多季合并失败这是插件的已知限制请把每一季当作独立条目管理并在 Jellyfin 中设置正确的排序。想强制刷新某部剧在媒体库中选中剧集 → 「刷新元数据」勾选「替换现有元数据」即可重新刮削。 想深入了解源码速查剧集三层刮削入口Jellyfin.Plugin.Douban/Providers/TVProvider.cs公共元数据转换逻辑Jellyfin.Plugin.Douban/Providers/BaseProvider.cs海报与背景图获取Jellyfin.Plugin.Douban/Providers/ImageProvider.cs请求间隔配置项Jellyfin.Plugin.Douban/Configuration/PluginConfiguration.cs豆瓣 ID 映射ExternalIdJellyfin.Plugin.Douban/ExternalID.cs 结语掌握了 jellyfin-plugin-douban 的剧集刮削逻辑你就能轻松搞定电视剧、季与单集的元数据管理装好插件 → 开启三个层级的刮削器 → 规范命名 → 按需调整请求间隔一部井然有序的剧集影音库就完成了。如果刮削遇到问题优先检查文件名规范与高级设置九成问题都能迎刃而解。快去给你的 Jellyfin 装上这款豆瓣刮削利器吧【免费下载链接】jellyfin-plugin-doubanDouban metadata provider for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考