MoviePilot-Plugins豆瓣书影音档案插件配置问题解析

MoviePilot-Plugins豆瓣书影音档案插件配置问题解析

MoviePilot-Plugins MoviePilot非官方插件库 项目地址: https://gitcode.com/gh_mirrors/movi/MoviePilot-Plugins

在使用MoviePilot-Plugins项目的豆瓣书影音档案插件(v1.9.5)配合MoviePilot(v2.3.5-1)时，用户遇到了插件无法正常运行的问题。本文将详细分析问题原因并提供解决方案。

问题现象

用户在使用Jellyfin媒体服务器时，发现豆瓣书影音档案插件无法正常工作，具体表现为：

1. 插件日志完全空白
2. Webhook手动测试请求正常
3. Jellyfin系统日志显示有回调请求
4. 插件配置界面显示正常

问题诊断

经过技术分析，发现问题根源在于MoviePilot v2版本对Webhook回调机制做了重要变更。在v2版本中，Webhook URL需要包含source参数来标识来源，而旧版插件没有适应这一变更。

解决方案

正确的Webhook URL格式应为：

http://[服务器IP]:3001/api/v1/webhook/?token=[API_TOKEN]&source=Emby

关键点说明：

1. source参数是必须的，用于标识媒体服务器类型
2. 对于Jellyfin用户，source参数值应为"Jellyfin"
3. 参数需要以查询字符串形式附加在URL末尾

配置建议

1. 媒体服务器配置：

   • 确保在Jellyfin/Emby/Plex等媒体服务器的Webhook设置中使用完整URL格式
   • 检查端口号(默认3001)是否与MoviePilot服务端口一致

2. 插件配置：

   • 更新到最新版插件
   • 检查日志级别设置，确保不是被设置为静默模式

3. 网络检查：

   • 确认媒体服务器可以访问MoviePilot服务
   • 检查防火墙设置，确保相关端口开放

技术背景

MoviePilot v2对Webhook机制进行了重构，主要改进包括：

• 支持多源区分：通过source参数可以识别不同媒体服务器的回调
• 增强安全性：强制要求token验证
• 更好的错误处理：提供更详细的错误日志

这一变更虽然提高了系统的灵活性和安全性，但也导致了旧版插件兼容性问题。

总结

当豆瓣书影音档案插件出现不记录日志但Webhook测试正常的情况时，首先应检查Webhook URL是否按照v2版本要求包含了必要的参数。正确配置后，插件应该能够正常记录用户观影数据并与豆瓣同步。

对于使用其他媒体服务器的用户，只需将source参数值替换为对应的服务器类型即可，如Plex用户应使用"source=Plex"。这一解决方案同样适用于MoviePilot-Plugins项目中的其他需要Webhook回调的插件。

MoviePilot-Plugins MoviePilot非官方插件库 项目地址: https://gitcode.com/gh_mirrors/movi/MoviePilot-Plugins