前言
最近发现一位大佬有个神仙项目 v1st233/iptv 给大家推荐下，结尾有彩蛋
部分项目功能介绍：
①添加自动反编译APK，自动生成APK，直接安装TV端，全程后台管理，每个客户端可以设置单独的播放频道分组。（再也不用TV端设置啦，对于给家里老人看直播更加便于管理。）
②可添加EPG订阅，EPG自动绑定频道，不必担心缺失图标，不显示节目单信息了。
③多直播源导入方式，支持TXT、M3U等，可设定自动更新。
④多直播源管理，可自动聚合所需频道、同时重命名相似频道，也可以手动维护分组。
⑤针对部分需要设置UA能正常播放频道，该项目也可以设置UA，并且开启代理播放模式，由服务器做视频转发，再也不用在客户端设置UA了
以下为最近作者更新的日志，不过很多新更新的功能并没有在日志中显示
2025-10-16
- 修改默认图标和背景(感谢群友 @0距离)(保留系统背景的二刺螈图片，二刺螈最后的倔强)
- 添加后台跳转到下载页面链接
- 添加加群按钮
- 添加版本号，更好定位问题
- EPG源、频道源添加 自定义useragent功能
- 编译APK添加apk大小实时预览
- 修复epg订阅
北京卫视4k格式缺少节目单
** 风云足球格式频道保存内容缺失问题- 修复若干小问题
2025-10-15
- 更新统一安装界面风格，更新日志独立出来了(太多了 啊~我的肝)
- 添加快速跳转到安装页面按钮
- 修复EPG订阅**-1格式无logo问题
- 修复EPG订阅**-1格式无节目单问题
- 修复epg编辑无法保存bug
- 修复订阅token无法固定问题
- 修复频道显示无**-1格式问题
- 修复节目单重复问题
- 修复非** epg输出缺失频道信息问题
- 修改频道绑定逻辑
2025-10-14
- 删除epg文件导入功能，改为url导入
- 整合菜单选项
- 添加epg logo上传、删除
- 添加订阅加密key持久化和手动更新
- epg订阅缺失bug
- 客户端显示缺失bug预览
界面预览
部署教程
下面让我们开始正式的安装教程
首先使用飞牛的同学可以在docker的镜像仓库搜索v1st233/iptv 并下载
下载完成后推荐大家使用docker compose的安装方式，便于管理
version: '3'
services:
iptv_server:
image: v1st233/iptv:latest
container_name: iptv_server
privileged: true # 添加特权模式
ports:
- "15760:80" #后台访问端口 左侧15760端口按自己喜欢的修改
- "15770:8080" #可选 代理播放端口 左侧15770端口按自己喜欢的修改
volumes:
- /vol1/1000/Docker/iptv/config:/config #本地目录
restart: unless-stopped
部署完成，然后访问后台，我这边是http://192.168.1.5:15760
打开后是系统说明界面，里面有项目说明、更新日志、以及项目交流群信息，我们这边直接点击前往安装
在系统安装界面需要说明下，这边部分同学可能需要外网访问，如需外网访问该项目的APK在这块区域可以添加自己外网访问的地址，当然这边也可以后期在配置文件或者网页管理后台修改
安装成功后，我们可以下载APK文件和登录，这边我们先登录，稍后下载
进入界面我们可以看到左侧为功能栏
这边我们先设置EPG，作者默认提供了51的EPG源，初次进入，我们手动点下更新，随后就可以在EPG列表看到我们的EPG频道信息，包含图标，绑定频道等
下一步我们去频道管理添加我们的直播源，建议勾选频道重命名
说明：本项目不提供任何直播源，需要各大网友自行查找（本文最后有彩蛋）
导入完成后，会在频道分类管理显示我们添加的【频道分组】，我们点击对应分组后面的EPG管理，我们会发现我们导入的频道已经绑定了对应的EPG信息，这样我们的源就有了logo和节目信息
然后我们点击左上角的下载客户端，会跳转到这个界面，点击立即下载即可
在模拟器、电视、手机等安卓端直接安装，打开APP后我们会发现没有任何频道
我们先去管理界面，确认下我们是否有设备信息，这边已经显示了我们刚刚登录APP的设备信息，这边可以修改备注，修改套餐等服务
随后我们去我们的订阅管理给我们的默认套餐设置频道分组，设置完成我们关闭之前 清和apk，再重新打开，就有我们的频道啦
进阶使用
注：以下部分功能为赞助版功能，有条件的可以赞助下项目作者或者积极参与BETA版测试。
- 中转访问：后台设置UA，播放端免设置，直接服务器转发视频流量
- 分辨率、延迟测试
- EPG模糊识别
第三方播放器使用
酷9、天光云影、MyTV、APTV等第三方播放器使用在订阅管理中，选择好对应套餐的订阅，复制M3U或者TXT订阅，添加到第三方播放器中，即可播放
这边以酷9为例，打开酷9，选择列表配置中的列表订阅，将复制的订阅链接添加进去，点击启用，即可播放
自建EPG信息
推荐项目taksss/php-epg 该项目可以根据上行EPG信息 在本地生成你的频道信息（图标、节目信息）
docker compose：
services:
php-epg:
image: taksss/php-epg:latest
container_name: php-epg
ports:
- "15750:80"
volumes:
- "/docker/php-epg:/htdocs/data" # 映射用户主目录下的epg文件夹到容器内的/htdocs/data
environment:
- PHP_MEMORY_LIMIT=512M
- ENABLE_FFMPEG=false
restart: unless-stopped
部署完成，添加上行EPG来源，这边分享下我的上行EPG源
#用时,仅需将 你的IP:15750/t.xml 或 t.xml.gz 填进 APP 即可
# http://192.168.1.5:15750/
# http://192.168.1.5:15750/t.xml
# http://192.168.1.5:15750/t.xml.gz
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
https://epg.163189.xyz/pp.xml.gz
#112114 gitee镜像
https://gitee.com/taksssss/tv/raw/main/epg/112114.xml.gz
#erw gitee镜像:
https://gitee.com/taksssss/tv/raw/main/epg/erw.xml.gz
# 老张的EPG:
#老张 gitee镜像:
https://gitee.com/taksssss/tv/raw/main/epg/51zmt.xml.gz
#epg.pw gitee镜像:
https://gitee.com/taksssss/tv/raw/main/epg/epgpw_cn.xml.gz
在更多设置中可以粘贴你的清和订阅链接，解析下你的频道，点击保存，
点击更新数据，如有链接卡住很久不下载，可以删除。
等待更新完成，使用时仅需将 你的IP:15750/epg/t.xml 或 t.xml.gz 填进 清和后台即可。
随后在清和IPTV的项目添加EPG来源信息，建议手动点下更新
随后我们可以在清和的EPG管理-EPG列表查看我们信息，部分图标可能缺失，推荐大家自行网上下载（https://github.com/taksssss/tv/tree/main/icon），下载后请放置到我们清和的目录，即我们创建docker时候映射的目录 /config/logo目录中
部分频道可能由于名称不一致或者识别问题，可能EPG未绑定频道，我们可以手动修改绑定规则，或者直接手动绑定，其中作者还提供了EPG模糊识别功能（赞助功能）
频道管理
我们之前已经添加了好几个源
我们在频道分类管理中添加分类，比如我这边想要上海地区频道，可以开启自动聚合、频道重命名，将不同直播源相同频道聚合，并且重命名为同一频道，在**播放端显示为同一频道多条路线，**这边聚合规则支持正式表达式，也可以用关键词，比如**系列，就写个**即可
注意：需要频道绑定EPG才可以自动聚合成成功
给大家看下自动聚合+合并相似频道功能的融合效果
我这边**有各种名称的频道，在EPG中显示已经绑定各种样式的频道，一共三个直播频道
这里已经合并成一个频道，三条线路了
中转访问
中转播放是为部分需要设置UA的频道使用的，无需在播放器设置，减少老人看电视时的操作
作者的提示写的比较清楚，这边我们在中转地址填入我们8080端口映射的地址，比如我的就如图所示地址，如我们需要放到公网，就修改我们对应的地址，然后点击开启中转功能
然后我转到频道管理，到对应需要中转的分组设置，设置完成，点击确认，并点击编辑频道，并在URL中点击切换代理地址，选择一个地址，复制到浏览器或者potplay打开测试下时候正常打开，确认没问题再打开清和APP，查看是否播放（记得在订阅管理选择对应分组）
ok，教程至此结束，给大家看下我最终的使用画面
结尾彩蛋
我知道大家很多人很难找到稳定的直播源，这边分享一个比较稳定的项目 develop767/migu_video
安装命令
docker run -p 3000:3000 -e mport=3000 -e mhost="http://localhost:3000" --name migu_video develop767/migu_video
compose
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:蓝光(需要登录且有VIP)
部署完成，可以使用http://localhost:port填到清和中使用即可
在最后推荐部署完清和项目后，可以进入QQ群交流，作者更新速度那叫一个火箭，快来一起折磨他
