Jellyfin TVHeadend插件配置填写教程

插件页面参数对照表

参数 填写值 说明
TVHeadend Hostname or IP Address 群晖NAS内网IP，例：192.168.0.51 ❌禁止填写localhost，localhost代表Jellyfin容器本身，无法访问外部TVHeadend容器
HTTP Port 9981 TVHeadend网页管理端口，部署容器必须映射9981端口
HTSP Port 9982 TVHeadend流媒体通信端口，容器必须映射9982端口
Username TVHeadend后台登录账号 在TVHeadend网页后台设置的账号，默认初始admin
Password TVHeadend后台登录密码 TVHeadend后台登录密码，首次进入TVHeadend后台需要修改默认密码
Priority of Recordings 5 默认5，录制优先级交给TVHeadend管理，无需改动
Pre-recording Padding in seconds 60 录制节目提前60秒开始，防止漏片头
Post-recording Padding in seconds 60 录制节目延后60秒结束，防止漏片尾
Use this channel type for channels tagged with Other Ignore 下拉选项保持默认Ignore

前置必要条件

  1. TVHeadend容器部署时，必须映射端口9981、9982
  2. 进入TVHeadend网页后台，提前导入M3U直播源、配置EPG节目单，并且设置好登录账号密码
  3. Jellyfin容器和TVHeadend容器在同一局域网，网络互通

操作流程

  1. 填入上述参数，保存插件配置
  2. 返回Jellyfin控制台【直播电视】，插件自动拉取TVHeadend内频道列表、节目指南

常见踩坑

  1. 使用localhost：连接失败，Jellyfin容器无法访问外部TVHeadend服务
  2. 未映射9981/9982端口：插件无法建立连接
  3. TVHeadend原生对中文频道名称兼容性差，导入含中文台名M3U会出现识别异常