tellytv/telly

telly镜像说明

镜像概述

telly是基于Golang开发的IPTV代理工具，主要用于将IPTV流转换为Plex Live可识别的格式，让用户能在Plex平台统一管理和观看IPTV直播内容。该镜像支持灵活配置，适配不同IPTV源与使用场景。

核心功能

• 多流支持：可配置同时输出的流数量，适配IPTV提供商限制；
• 频道管理：自定义起始频道号，支持从M3U文件读取频道编号；
• EPG集成：支持导入电子节目指南（EPG）数据；
• FFmpeg缓冲：可选通过FFmpeg处理流，解决格式兼容性问题并优化错误报告；
• 日志记录：支持多级别日志输出，记录HTTP请求详情；
• SSDP发现：支持SSDP协议，便于Plex自动识别代理设备。

使用场景

• 家庭用户将自有IPTV源接入Plex，实现直播内容统一观看；
• 整合多个IPTV源到Plex平台的场景；
• 解决Plex直接播放IPTV流的格式兼容性问题。

配置说明

需创建配置文件（如telly.config.toml），放置在/etc/telly/、$HOME/.telly/或运行目录下。示例配置如下：

toml
# 发现配置（必填）
[Discovery]
  Device-Auth = "telly123"
  Device-ID = "12345678"
  Device-UUID = ""
  Device-Firmware-Name = "hdhomeruntc_atsc"
  Device-Firmware-Version = "20150826"
  Device-Friendly-Name = "telly"
  Device-Manufacturer = "Silicondust"
  Device-Model-Number = "HDTC-2US"
  SSDP = true

# IPTV配置（必填）
[IPTV]
  Streams = 1               # 同时流数量
  Starting-Channel = 10000  # 起始频道号
  XMLTV-Channels = true     # 是否使用M3U中的频道号
# FFMpeg = true             # 启用FFmpeg缓冲（需对应镜像）

# 日志配置（必填）
[Log]
  Level = "info"            # 日志级别：debug/info/warn/error/fatal
  Requests = true           # 是否记录HTTP请求

# Web配置（必填）
[Web]
  Base-Address = "0.0.0.0:6077"
  Listen-Address = "0.0.0.0:6077"

# 源配置（至少一个，必填）
[[Source]]
  Name = ""                 # 源名称（可选）
  Provider = "Custom"       # 固定为Custom
  M3U = "http://myprovider.com/playlist.m3u" # M3U源地址/路径
  EPG = "http://myprovider.com/epg.xml"     # EPG源地址/路径
  Filter = "Sports|Premium Movies"          # 过滤规则（正则）
  FilterKey = "group-title"                 # 过滤字段
  FilterRaw = false                         # 是否对整行应用过滤
  Sort = "group-title"                      # 排序字段

Docker部署示例

1. docker run命令

bash
docker run -d \
  --name='telly' \
  --net='bridge' \
  -e TZ="Asia/Shanghai" \
  -p '6077:6077/tcp' \
  -v /host/path/to/telly.config.toml:/etc/telly/telly.config.toml \
  --restart unless-stopped \
  docker.xuanyuan.run/tellytv/telly:dev-ffmpeg

2. docker-compose配置

yaml
version: '3'
services:
  telly:
    image: docker.xuanyuan.run/tellytv/telly:dev-ffmpeg
    ports:
      - "6077:6077"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /host/path/to/telly.config.toml:/etc/telly/telly.config.toml
    restart: unless-stopped

注意事项

• 启用FFmpeg功能时，需使用dev-ffmpeg镜像（已预装FFmpeg）；
• 配置文件路径需正确，避免因工作目录问题导致无法读取；
• Windows用户需确保配置文件无隐藏扩展名（如.toml.txt）。