Jellyfin弹幕插件终极指南：一键开启弹幕新体验
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-danmaku 功能亮点：重新定义你的观影方式
Jellyfin弹幕插件为你的媒体服务器带来了全新的互动观影体验。你可以通过简单的配置，在观看视频时显示来自多个平台的实时弹幕评论，让观影过程更加生动有趣。
🎯 核心特色功能
- 智能弹幕聚合：自动融合来自哔哩哔哩、Acfun、巴哈姆特等主流平台的弹幕内容
- 本地XML弹幕支持：兼容cxfksword/jellyfin-plugin-danmu的本地弹幕文件
- 多客户端兼容：完美支持Web端、Android和iOS客户端
- 个性化设置：自由调整弹幕透明度、速度、字体大小等参数
⚡ 界面设计革新
最新版本进行了全面的界面优化，播放界面仅保留核心的弹幕开关按钮，所有高级设置都整合到侧边栏中，操作更加直观便捷。
Jellyfin弹幕插件简洁播放界面 - 弹幕功能一键开关
实战部署：三种高效安装方案
我们建议根据你的使用场景选择合适的安装方式，确保弹幕功能稳定运行。
方案一：浏览器插件部署（推荐个人用户）
- 安装Tampermonkey浏览器扩展
- 添加弹幕脚本：https://cdn.jsdelivr.net/gh/Izumiko/jellyfin-danmaku@gh-pages/ede.user.js
- 确保开启开发者模式以运行用户脚本
方案二：反向代理集成（推荐多用户环境）
Nginx配置示例
location / {
proxy_set_header Accept-Encoding "";
sub_filter '</body>' '<script src="https://cdn.jsdelivr.net/gh/Izumiko/jellyfin-danmaku@gh-pages/ede.user.js" defer></script></body>';
sub_filter_once on;
}
Caddy服务器配置
如果你使用Caddy服务器，可以通过安装caddy2-filter或replace-response插件来实现自动注入。
方案三：服务端直接修改
对于有服务器管理权限的用户，可以直接修改Jellyfin的index.html文件，在</body>标签前添加脚本引用。
Docker环境操作命令：
sed -i 's#</body>#<script src="https://cdn.jsdelivr.net/gh/Izumiko/jellyfin-danmaku@gh-pages/ede.user.js" defer></script></body>#' /jellyfin/jellyfin-web/index.html
高级配置：打造专属弹幕体验
弹幕显示设置
进入"设置" → "弹幕设置"侧边栏，你可以精细调整以下参数：
- 透明度控制：0-1范围调节，适应不同背景场景
- 速度调节：20-600范围，找到最适合的阅读速度
- 字体大小：8-80像素，确保弹幕清晰可见
- 显示区域：设置弹幕占屏幕高度比例，避免遮挡重要内容
弹幕过滤策略
- 用户来源过滤：支持按哔哩哔哩、巴哈姆特、弹弹Play等平台筛选
- 弹幕类型过滤：可选择显示底部、顶部或滚动弹幕
- 密度控制：除0级外均带有垂直方向密度限制
Jellyfin弹幕插件设置界面 - 媒体服务器弹幕功能全面配置
智能匹配优化
- 手动搜索匹配：当自动匹配失败时，你可以手动输入信息进行精确匹配
- 自定义弹幕源：番剧刚发布时手动添加弹幕源地址
- 本地存储记录：匹配关系保存在浏览器本地，后续播放自动加载
生态整合：完美匹配方案
弹幕数据源整合
插件默认使用弹弹Play作为主要弹幕来源，该平台已实现多平台弹幕聚合。当启用"使用本地XML弹幕"选项后，系统会尝试调用相关API获取预先下载的XML弹幕文件。
客户端兼容性
- Jellyfin Web：完全支持所有功能
- Jellyfin Android：仅限网页播放器类型
- Jellyfin iOS：提供完整的弹幕体验
疑难解答：常见问题速查
弹幕加载失败排查
- 译名不匹配：如『よふかしのうた』在Emby中识别为《彻夜之歌》，而弹弹Play中为《夜曲》
- 多季内容识别：OVERLORD等存在多季/剧场版的作品需要规范的命名格式
- 首次播放检查：新内容播放时请确认弹幕匹配是否正确
性能优化建议
- 建议在网络环境良好时使用弹幕功能
- 可根据设备性能调整弹幕密度和速度参数
- 定期清理浏览器缓存以确保最佳性能
特殊场景处理
对于使用自定义弹幕服务器并通过HTTPS访问Jellyfin的情况，需要自行处理CORS跨域问题。
通过本指南，你可以轻松为Jellyfin媒体服务器添加弹幕功能，享受全新的互动观影体验。无论是追番还是观影，弹幕都能为你带来更多乐趣和共鸣。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
