Jellyscrub常见问题解决为什么我的预览不显示10个实用排查技巧【免费下载链接】jellyscrubSmooth mouse-over video scrubbing previews for Jellyfin.项目地址: https://gitcode.com/gh_mirrors/je/jellyscrubJellyscrub是Jellyfin媒体服务器的平滑视频预览插件但有时候用户会遇到预览不显示的问题。本文将为您提供10个实用的排查技巧帮助您快速解决Jellyscrub预览不显示的问题让您的视频浏览体验更加流畅。 Jellyscrub预览不显示的主要原因Jellyscrub预览不显示通常由以下几个原因造成脚本注入失败- 客户端脚本未正确注入到Jellyfin界面权限问题- 文件访问权限不足配置错误- 插件设置不正确BIF文件未生成- 预览文件未创建或损坏网络路径问题- 基础路径配置错误 10个实用排查技巧1. 检查脚本注入状态Jellyscrub需要在Jellyfin的index.html文件中注入客户端脚本。首先检查插件配置页面中的Inject client script into jellyfin-web选项是否启用。如果脚本注入失败您可以手动添加以下代码到index.html文件的/body标签前script pluginJellyscrub version1.0.0.0 src/Trickplay/ClientScript/script2. 验证文件权限Docker用户常见的问题是权限冲突。如果您的Jellyfin容器以非root用户运行但Web文件由root拥有脚本注入会失败。解决方法移除Docker Compose文件中的User: 1000:1000等用户限制或者将Jellyfin用户添加到Web文件夹所属的用户组3. 清除浏览器缓存脚本注入后浏览器可能仍在使用缓存的旧版本。强制刷新页面或清除浏览器缓存按CtrlF5强制刷新清除Jellyfin网站的Cookie和本地存储使用隐私模式测试4. 检查BIF文件生成状态Jellyscrub需要生成.bif预览文件才能工作。检查以下位置内部存储/config/metadata/library/xx/默认位置媒体文件夹如果启用了Save trickplay files within media folders选项您可以在Jellyfin日志中搜索BIF来查看生成状态。5. 验证基础路径配置如果您的Jellyfin设置了基础路径Base URL需要在脚本中相应调整script pluginJellyscrub version1.0.0.0 src/YOUR_BASE_PATH/Trickplay/ClientScript/script6. 检查网络请求打开浏览器开发者工具F12查看网络请求中是否有以下API调用GET /Trickplay/{itemId}/GetManifestGET /Trickplay/{itemId}/{width}/GetBIF如果这些请求返回404错误说明插件API未正常工作。7. 查看Jellyfin日志Jellyfin日志是排查问题的关键。查看日志中是否有以下信息Attempting to inject trickplay script codeFinished injecting trickplay script codeFound client script injectedBIF生成相关的错误信息8. 检查硬件加速设置在Jellyscrub配置中硬件加速设置可能影响BIF文件生成None不使用硬件加速No Encode仅解码和过滤使用硬件加速Full完全硬件加速注意AMD VAAPI设备不要使用此选项9. 验证生成时机设置确保BIF文件正在生成On demand generation客户端请求时生成Extraction during library scan扫描库时生成Scheduled tasks定期任务生成建议至少启用一种生成方式。10. 手动触发BIF生成如果自动生成失败可以手动触发播放一个视频几分钟等待插件检测并生成BIF文件检查日志中的生成进度 高级故障排除检查客户端脚本文件验证客户端脚本文件是否存在访问/Trickplay/ClientScript或带基础路径的URL应该返回JavaScript代码而不是404错误查看插件版本兼容性注意Jellyfin 10.9.0已将Trickplay功能集成到核心中。Jellyscrub 2.0.0仅用于将现有的.bif文件转换为Jellyfin原生格式。检查FFmpeg配置BIF生成依赖于FFmpeg。确保FFmpeg路径正确配置有足够的磁盘空间线程数设置合理在配置中调整 性能优化建议调整生成间隔较短的间隔如10秒提供更流畅的预览但占用更多空间优化分辨率使用320px宽度平衡质量和性能调整线程数根据CPU核心数合理设置FFmpeg线程设置进程优先级如果生成影响性能降低优先级 快速检查清单✅ 插件已安装并启用 ✅ 脚本注入选项已开启 ✅ 浏览器缓存已清除 ✅ BIF文件正在生成 ✅ 网络请求正常 ✅ 日志无错误信息 ✅ 基础路径配置正确 ✅ 文件权限正确 ✅ 硬件加速设置合适 ✅ 生成时机配置正确 预防措施定期备份配置备份Nick.Plugin.Jellyscrub/Configuration/PluginConfiguration.cs相关设置监控磁盘空间BIF文件会占用额外空间更新前测试在主要Jellyfin更新前测试插件兼容性阅读官方文档参考README.md获取最新信息通过以上10个排查技巧您应该能够解决大部分Jellyscrub预览不显示的问题。如果问题仍然存在建议查看Jellyfin社区论坛或提交详细的问题报告包括您的Jellyfin版本、插件版本、操作系统信息和完整的错误日志。记住Jellyscrub的目标是为您提供流畅的视频预览体验适当的配置和定期维护是保持其正常运行的关键。祝您观影愉快【免费下载链接】jellyscrubSmooth mouse-over video scrubbing previews for Jellyfin.项目地址: https://gitcode.com/gh_mirrors/je/jellyscrub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
