终极指南：如何快速为Jellyfin配置豆瓣元数据插件，打造完美观影体验 🎬

Jellyfin豆瓣元数据插件（jellyfin-plugin-douban）是一款专为Jellyfin媒体服务器设计的免费插件，能够自动从豆瓣抓取电影、电视剧的评分、简介、演员等中文元数据，让你的私人媒体库瞬间拥有影院级信息展示！

📌 为什么选择这款豆瓣插件？

对于中文用户来说，Jellyfin默认的元数据提供商往往存在中文信息缺失、评分不准确等问题。这款插件通过深度整合豆瓣API，完美解决了以下痛点：

• ✅ 本土化数据优先：优先展示豆瓣评分、影评和演员信息
• ✅ 全自动匹配：智能识别媒体文件，一键拉取完整元数据
• ✅ 轻量无广告：仅300KB大小，不占用系统资源
• ✅ 持续维护更新：活跃的开源项目，兼容最新版Jellyfin

🔍 适合人群：家庭影院爱好者、NAS用户、Jellyfin新手玩家

🚀 2种超简单安装方法（附图文教程）

方法1：通过插件仓库一键安装 🌟

1. 登录Jellyfin管理界面，进入 控制台 → 插件 → 存储库
2. 点击 添加，输入仓库地址：
   https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban/releases/latest/download/manifest.json
3. 在可用插件列表中找到 "Douban"，点击 安装 并重启服务

图：在Jellyfin插件设置中启用豆瓣元数据提供商的界面

方法2：手动安装（适合离线环境）

1. 从项目仓库克隆源码编译或下载Release包：
   git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-douban.git
2. 解压获得 Douban 文件夹，根据系统放入对应目录：
   • Linux：~/.local/share/jellyfin/plugins
   • Docker：/config/plugins（需映射宿主机目录）
   • Windows：C:\ProgramData\Jellyfin\Server\plugins
3. 重启Jellyfin服务使插件生效

⚙️ 3步完成插件配置

1. 进入 控制台 → 插件 → 已安装 → Douban → 配置
2. 调整 最小请求间隔（MinRequestInternalMs）：
   建议设置为 1000ms（1秒），避免触发豆瓣API限制
3. 点击 保存 并重启Jellyfin服务

图：豆瓣插件配置界面，可设置请求间隔等高级参数

🖼️ 启用豆瓣图片提供商（可选）

若需要显示豆瓣风格的海报和背景图：

1. 进入 控制台 → 媒体库 → 你的媒体库 → 图片获取器
2. 勾选 "Douban Image Provider" 并移至首位
3. 点击 保存 后刷新媒体库元数据

图：在媒体库设置中启用豆瓣图片提供商的选项

🌍 地区与语言设置优化

为确保元数据显示为中文：

1. 进入 控制台 → 仪表板 → 语言和地区
2. 设置 首选语言 为 "中文（中国）"
3. 地区格式选择 "中国"，时间格式选择 "24小时制"

图：正确配置语言和地区可提升元数据匹配准确率

🛠️ 常见问题解决

Q：插件安装后不显示怎么办？

A：检查Jellyfin版本是否≥10.8，确保插件文件夹权限正确（755）

Q：元数据拉取缓慢？

A：在配置页面增加请求间隔（建议1000-2000ms），避免被豆瓣API限制

Q：如何手动刷新元数据？

A：在媒体详情页点击 "... → 刷新元数据"，选择 "替换所有元数据"

📚 开发与贡献

该项目基于.NET Core开发，核心代码位于 Jellyfin.Plugin.Douban/Providers/ 目录，欢迎通过PR参与功能改进。主要技术栈包括：

• C# 异步编程
• LRU缓存机制（LRUCache.cs）
• 豆瓣API客户端（FrodoAndroidClient.cs）

⭐ 项目地址：通过git克隆获取完整源码进行二次开发

💡 使用小贴士

1. 媒体文件命名建议：电影名称.年份.分辨率.ext（例：流浪地球.2019.1080p.mkv）
2. 电视剧建议按 季/集 文件夹结构存放
3. 定期更新插件获取最新功能：控制台 → 插件 → 已安装 → 检查更新

通过这款插件，你的Jellyfin媒体库将完美融合豆瓣的优质中文内容，让每一次观影都充满仪式感！现在就动手试试，打造专属你的家庭影院系统吧～ 🎥✨