清和IPTV管理：一站式搞定直播源与EPG

最近在飞牛论坛发现了一个相当实用的开源项目——清和IPTV管理（v1st233/iptv）。它把直播源管理、EPG订阅、APK自动编译、UA代理播放这些原本繁琐的环节全部搬到了后台，电视端几乎不用再折腾。如果你也在为家里老人看电视直播而头疼，或者厌倦了每次改源都要跑到电视前操作，这篇文章会带你从零开始部署并玩转这个项目。

项目地址：https://github.com/v1st233/iptv

它能做什么？

先看看几个核心功能：

自动反编译/生成APK：后台直接编译TV端安装包，每个客户端可以单独设置频道分组，不用在电视上做任何配置。
EPG自动绑定：添加EPG订阅后自动匹配频道，图标和节目单不再缺失。
多源导入与管理：支持TXT、M3U等格式，可设定自动更新，支持自动聚合、频道重命名、手动分组。
UA与代理播放：针对需要特定UA才能播放的频道，可在后台设置UA并开启服务器转发，客户端零配置。
第三方播放器支持：可复制M3U/TXT订阅链接到酷9、天光云影、MyTV、APTV等播放器中使用。

作者更新非常频繁，最近几天就修复了EPG订阅缺失、频道保存、订阅token固定等一堆问题，还加入了APK大小实时预览、自定义useragent等功能。

部署清和IPTV

推荐使用Docker Compose部署，方便管理。在飞牛NAS的Docker镜像仓库搜索 v1st233/iptv 并下载，然后创建compose文件：

version: '3'

services:
  iptv_server:
    image: v1st233/iptv:latest
    container_name: iptv_server
    privileged: true
    ports:
      - "15760:80"    # 后台访问端口，可自行修改
      - "15770:8080"  # 可选：代理播放端口
    volumes:
      - /vol1/1000/Docker/iptv/config:/config
    restart: unless-stopped

部署完成后访问 http://你的IP:15760，会看到系统说明界面。点击“前往安装”，如果需要外网访问，在这里填入外网地址（后期也可在后台修改）。安装成功后先登录后台，稍后再下载APK。

基础配置：EPG与频道源

第一步：设置EPG

进入后台左侧的EPG管理，作者默认提供了51的EPG源。初次进入手动点一下更新，随后就能在EPG列表看到频道信息，包括图标和绑定状态。

第二步：添加直播源

到频道管理中添加你的直播源，建议勾选“频道重命名”。导入完成后，在频道分类管理里会看到新增的分组，点击分组后面的“EPG管理”，通常频道已经自动绑定了EPG信息，图标和节目单也就有了。

第三步：安装客户端

点击左上角“下载客户端”，下载APK后安装到电视、手机或模拟器。首次打开APP会没有任何频道，这是正常的。回到后台确认设备信息已显示，可以修改备注和套餐。然后到订阅管理，给默认套餐设置频道分组，保存后重启APP，频道就出来了。

进阶玩法

以下部分功能为赞助版，有条件可以支持作者或参与BETA测试：

中转访问：后台设置UA，播放端免设置，服务器直接转发视频流量。
分辨率/延迟测试。
EPG模糊识别。

第三方播放器

在订阅管理中选择对应套餐，复制M3U或TXT订阅链接，添加到酷9等播放器中即可。以酷9为例，打开“列表配置”-“列表订阅”，粘贴链接后启用就能播放。

自建EPG信息

如果默认EPG不够用，可以自建。推荐 taksss/php-epg 项目，根据上行EPG在本地生成频道图标和节目信息。

services:
  php-epg:
    image: taksss/php-epg:latest
    container_name: php-epg
    ports:
      - "15750:80"
    volumes:
      - "/docker/php-epg:/htdocs/data"
    environment:
      - PHP_MEMORY_LIMIT=512M
      - ENABLE_FFMPEG=false
    restart: unless-stopped

部署后添加上行EPG源，这里分享几个可用的：

http://epg.51zmt.top:8000/e.xml
http://epg.aptvapp.com/xml
https://epg.v1.mk/fy.xml
http://epg.112114.xyz/pp.xml
https://epg.112114.eu.org/pp.xml
https://epg.cdn.loc.cc/xml
https://epg.163189.xyz/pp.xml

在更多设置中粘贴清和订阅链接，解析频道后保存，点击“更新数据”。完成后将 你的IP:15750/epg/t.xml 或 t.xml.gz 填入清和后台的EPG来源，手动更新即可。部分图标缺失可以到 https://github.com/taksss/tv/tree/main/icon 下载，放到映射目录的 /config/logo 下。如果频道未绑定，可以手动修改绑定规则，或使用赞助版的EPG模糊识别。

频道聚合与重命名

在频道分类管理中添加分类，比如“上海地区”，开启自动聚合和频道重命名。不同直播源中的相同频道会被聚合，播放端显示为同一频道下的多条线路。聚合规则支持正则表达式，也可以用关键词，比如“系列”就写“”即可。

注意：频道需要先绑定EPG才能自动聚合成功。

中转访问（UA代理）

部分频道需要特定UA才能播放，中转播放就是为此设计的。在后台填入8080端口映射的地址（如 http://你的IP:15770），开启中转功能。然后到频道管理，对需要中转的分组进行设置，编辑频道时在URL中点击“切换代理地址”，复制到浏览器或PotPlayer测试，确认正常后再打开清和APP查看。

彩蛋：稳定的直播源项目

如果找不到稳定直播源，可以试试 develop767/migu_video：

version: "3.9"

services:
  migu_video:
    image: develop767/migu_video
    container_name: migu_video
    restart: unless-stopped
    ports:
      - "15500:3000"
    environment:
      mport: "3000"
      mhost: "http://192.168.1.5:15500"
      muserId: "用户id，网页端登录获取"
      mtoken: "用户token，网页端登录获取"
      mrateType: "4"    # 2标清 3高清 4蓝光

部署后使用 http://localhost:端口 填入清和即可。

小结

清和IPTV管理把直播源、EPG、客户端APK、UA代理这些环节整合到了一个后台，对于需要给家人维护电视直播的人来说，省去了大量重复操作。配合自建EPG和稳定的源项目，基本可以做到一次部署、长期省心。作者更新速度很快，有兴趣可以加群交流，也欢迎有条件的朋友赞助支持。

参考链接

清和IPTV项目：https://github.com/v1st233/iptv
php-epg项目：https://github.com/taksss/php-epg
migu_video项目：https://github.com/develop767/migu_video
图标库：https://github.com/taksss/tv/tree/main/icon
原贴地址：https://club.fnnas.com/forum.php?mod=viewthread&tid=43378