Jellyfin NextPVR 插件｜IPTV直播、节目录制插件 功能详解+配置步骤
一、插件作用
NextPVR 是客户端对接插件，本身不自带IPTV源、不做M3U解析。 它的作用：把 Jellyfin 作为前端播放器，连接独立部署的 NextPVR 后端服务，读取后端里面配置好的电视频道、EPG节目指南、录像文件。
核心能力：
- 在Jellyfin内直接播放NextPVR后端添加的IPTV直播频道
- 读取EPG电子节目单，显示当前/后续节目信息
- 调用NextPVR后端的录制功能：预约定时录制电视节目，录好的视频直接在Jellyfin媒体库浏览播放
- 支持时移（Timeshift），直播暂停、回退回看（取决于后端配置）
⚠️ 重点提醒： 插件≠直播服务！必须单独部署 NextPVR 服务（Docker/Windows/Linux），插件只是用来连接这个后端，没有后端，插件装上也无法使用。 和TVHeadend插件逻辑完全一致：插件是客户端，服务端单独部署。
二、前置准备
- 已经部署 NextPVR 后端服务，可正常访问后台，并且已经导入好M3U/IPTV源、导入EPG节目源，频道可以在NextPVR后台正常播放。
- Jellyfin服务器可以网络连通 NextPVR 后端IP+端口，防火墙放行。
- 记录 NextPVR 的访问地址、账号密码。
三、插件安装步骤
- 打开Jellyfin后台 → 【插件】→【目录】，搜索
NextPVR - 点击安装，安装完成后重启Jellyfin服务（必须重启，插件才加载生效）
四、插件配置（核心设置）
- 重启完成，进入插件设置页面，找到NextPVR
- 参数填写：
- NextPVR Host：NextPVR后端内网IP，例
192.168.0.51（不要加http） - Port：NextPVR端口，默认
8866 - Username：NextPVR后台登录账号
- Password：NextPVR后台登录密码
- 保存设置，点击【测试连接】，提示连接成功即代表通信正常。
五、Jellyfin内使用直播
- 进入Jellyfin后台 →【直播电视】→【添加调谐器】，选择 NextPVR
- 选择刚刚配置好的NextPVR连接，保存
- Jellyfin会自动拉取NextPVR后端内全部频道列表、EPG节目信息
- 回到Jellyfin前端，【直播电视】分类，即可直接选台播放
六、录制功能使用
- 在Jellyfin直播节目单里，选中想要录制的节目，点击【录制】
- 录制任务会提交给NextPVR后端执行，由后端负责拉流保存视频文件
- 录制完成后，录像自动出现在Jellyfin【直播电视-录制】栏目，直接播放回看
七、常见排坑
- 测试连接失败：检查NAS防火墙、Docker容器网络，确认Jellyfin能ping通NextPVR的IP端口
- 连接成功，但频道空白：去NextPVR后端检查，确认后端本身频道正常、EPG已刷新
- 能看直播，无法录制：NextPVR后端设置存储目录权限，确保写入权限正常
- 播放卡顿：优先在NextPVR后台测试频道，确认源本身稳定，再排查Jellyfin转码设置