chive/telly

telly镜像说明

镜像概述

telly是一款用Golang编写的IPTV代理工具，核心功能是将IPTV流转换为Plex Live可识别的虚拟DVR设备，帮助用户在Plex平台统一管理直播内容。它支持灵活配置播放列表、频道过滤和并发流数量，适用于个人或家庭媒体中心场景。

核心功能

1. M3U解析：支持本地文件或远程URL形式的M3U播放列表，自动提取IPTV频道信息。
2. 频道过滤：通过正则表达式实现频道黑白名单管理，可自定义包含/排除特定频道。
3. 多流支持：配置多个并发流（默认1个），满足多设备同时观看需求。
4. Plex集成：作为虚拟DVR设备被Plex自动识别，无缝接入Plex Live系统。

使用场景

• 个人用户将IPTV服务接入Plex，整合直播与点播内容。
• 家庭媒体中心搭建，实现多设备共享IPTV直播资源。

配置说明

基础步骤

1. 获取IPTV提供商的M3U播放列表（本地文件或远程URL）。
2. 通过环境变量或命令行参数设置播放列表路径、流数量、过滤规则等。
3. 启动telly服务，确保端口正常监听。
4. 在Plex中添加telly作为虚拟DVR，完成频道匹配和EPG配置。

Docker部署示例

docker run命令

bash
docker run -d \
  --name='telly' \
  --net='bridge' \
  -e TZ="Asia/Shanghai" \
  -e 'TELLY_IPTV_PLAYLIST'='http://your-iptv-provider/m3u' \
  -e TELLY_IPTV_STREAMS=2 \
  -e TELLY_FILTER_REGEX='.*CN.*' \
  -e TELLY_FILTER_REGEX_INCLUSIVE=true \
  -p '6077:6077/tcp' \
  -v '/path/to/local/m3u':'/tmp':'rw' \
  chive/telly --web.base-address=localhost:6077

docker-compose配置

yaml
version: '3'
services:
  telly:
    image: chive/telly
    ports:
      - "6077:6077"
    environment:
      - TZ=Asia/Shanghai
      - TELLY_IPTV_PLAYLIST=http://your-iptv-provider/m3u
      - TELLY_FILTER_REGEX='.*CN.*'
      - TELLY_FILTER_REGEX_INCLUSIVE=true
      - TELLY_WEB_LISTEN_ADDRESS=telly:6077
      - TELLY_IPTV_STREAMS=2
      - TELLY_DISCOVERY_FRIENDLYNAME=Tuner1
      - TELLY_DISCOVERY_DEVICEID=12345678
    command: -base=telly:6077
    restart: unless-stopped  

注意事项

• 调整流数量后需重启Plex生效；
• 频道过滤需明确设置TELLY_FILTER_REGEX_INCLUSIVE（true为包含匹配频道）；
• Plex Live功能需Plex Pass订阅支持。