阿喵前言
电视、手机、电脑各存一份直播列表,换个源还得挨个改,家里的 NAS 能不能把这件事一起管了?iPTV 可以把分散的频道整理成一套自己的订阅:在浏览器里开关来源、拖动分组、隐藏不看的频道,再把同一个播放列表交给家里的播放器。它更适合想长期维护家庭直播的人,省去反复手改列表的麻烦。
资源介绍
iPTV 是面向 NAS 和家庭服务器的开源 IPTV 管理与分发系统,支持 Docker Compose 部署,也可通过 Node.js 运行。央视频、咪咕、B站、抖音、虎牙、斗鱼及多地区电视台模块,与自己添加的直连地址、M3U/TXT 订阅,都能在同一个后台管理,统一整理成播放列表与 EPG 节目单。
默认配置可聚合 800 多个频道,实际数量随启用模块、地区网络和上游接口变化。频道分组、排序、重命名、隐藏和批量管理都有可视化入口;还能为不同电视或家人建立配置档,分别输出需要的频道组合。项目采用 GPL-3.0 许可证,当前正式版为 v4.53.1。
截图
特色
- 各个来源独立开关:只启用自己需要的平台和地区,不用维护一大张混杂的列表。
- 浏览器里整理频道:拖动排序、改名、分组、隐藏和批量调整,不必直接编辑播放列表文件。
- 一套后台,多端订阅:输出 M3U、TXT 与 EPG,播放器还可按需要选择兼容版或全代理版。
- 接入自己的订阅:支持直连地址、网页提取与订阅导入,也能添加外部 XMLTV 节目单。
- 按人或设备分配频道:多配置档配合用户令牌,为不同使用者保留各自的频道列表。
注意
- 这是需要自行部署的服务端系统;电视、手机等设备需要使用支持播放列表的播放器接入。部分频道依赖中国大陆网络,EPG 和回看覆盖也因来源而异。
- 部分高画质或会员频道需要本人有效账号及对应权益,软件开源不等于节目内容免费授权,使用时应遵守来源平台要求。
- 管理后台和订阅入口应留在可信网络内;需要远程访问时先配置访问保护。Docker 的数据目录务必持久化,避免重建容器丢失配置。
使用教程
- 在 NAS 或服务器上准备 Docker Compose,新建一个项目目录,并将下面的内容保存为
docker-compose.yml。首次使用建议先在家庭局域网内运行。
services:
iptv:
image: akiralereal/iptv:4.53.1
container_name: iptv
init: true
ports:
- "1905:1905"
environment:
- mport=1905
volumes:
- ./data:/iptv/data
restart: unless-stopped
- 在该目录执行
docker compose up -d,等待镜像下载和服务启动。打开http://你的NAS局域网IP:1905/admin进入管理后台。 - 在「源管理」保留需要的平台和地区模块;有自己的播放列表时,从自定义源添加订阅。在「我的频道」中调整分组、频道顺序及隐藏项。
- 复制后台显示的 M3U 订阅地址,添加到电视或手机的播放器。默认地址为
http://你的NAS局域网IP:1905/interface.m3u,EPG 地址为http://你的NAS局域网IP:1905/playback.xml;设置访问密码后,以后台生成的新地址为准。 - 不同设备需要不同内容时,创建配置档并使用各自的订阅。后续升级镜像时保留
./data目录;运行参数和平台账号配置可继续查阅项目文档。
资源获取
GitHub 项目、Docker 镜像与版本发布页见下方资源区。
声明:本站为个人非盈利博客,资源均网络收集且免费分享无限制,无需登录。资源仅供测试学习,请于24小时内删除,任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集。请支持正版!如若侵犯了您的合法权益,可联系我们处理。





