先把话说明白:大部分人不需要自建 iPTV。
家里只有一台电视在看直播,或者你根本不在乎某个台什么时候失效,那随便找一份现成的列表导进去就行,十分钟,不用读这篇。
该往下看的是另一种情况:两三台设备都在看,客厅一套、卧室一套、老人房一套,每套一份单独的文件。某个台黑了,你得挨个去改,改到第二次就烦了,第三次干脆不管。
自建能解决的就是这个"管不过来"。它解决不了"源本身会失效",这一点后面单独说。
它到底做了什么
一个开源项目,叫 akiralereal/iptv,跑在 Docker 里。
你把各种来源接进去——内置抓取模块、单条直链、别人给的 m3u 都行——它在浏览器里给你一个后台,把频道列出来。你可以分组、排序、改名、把不想看的藏掉。弄完之后,它吐出几个地址,播放器订阅这些地址。
关键就在这里:播放器订阅的是你的地址,不是网上的地址。
所以下次某个台坏了,你进后台关掉就行,三台设备同时生效。不用改三份文件,不用教家里人怎么重新导入。
装之前,先确认三样东西在不在
一、一台常年开着的机器。
NAS 最合适,软路由、闲置小主机也行。内存 2 G 起步,4 G 更稳。
这里有个容易翻车的点。项目自带 Chromium,用来解析那些必须走网页的来源,每开一路吃 200~400 MB。我第一台测试机是 2 核 2 G,装完十分钟容器自己重启了一次,日志里什么都看不出来,最后在 dmesg 里发现是被 OOM killer 杀了。
2 G 的机器照样能跑,但要加一行 mbrowserConcurrency=1,把并发压到 1。
二、愿意偶尔进后台看一眼。
这是自托管的固有成本,不是缺陷。上游的源会变,有的台会下架,有的模块要重新授权。频率不高,一个月一两次,但你不能指望装完三年不管。
三、真的不止一台设备在看。
这条最实在。只有一台设备,自建的收益几乎为零,反而多一个要维护的服务。
装起来大概五分钟
镜像 426 MB,单容器单端口,配置和数据全在一个目录里,搬走和备份都省事。
docker pull docker.xuanyuan.run/akiralereal/iptv:4.51.2
这是轩辕镜像的镜像源。我在 NAS 上一直用它,充一次钱没再管过。以前直连的时候,一个 426 MB 的镜像能拉到断两次。
你要是本来拉得动 Docker Hub,这段跳过,下面 image 那行写原地址。标签、Digest 在镜像页上能核对。
用版本号,别用 latest。这项目的 latest 每次发版后改指向,某天重启突然多个要授权的模块,很难往版本上想。
services:
iptv:
image: docker.xuanyuan.run/akiralereal/iptv:4.51.2
container_name: iptv
restart: always
ports:
- "1905:1905"
environment:
- mport=1905
- mdataDir=/iptv/data
- mbrowserConcurrency=1
volumes:
- ./data:/iptv/data
存成 compose.yaml,然后 docker compose up -d。起来之后浏览器开 http://机器IP:1905/admin,没有账号密码,直接进。
第一次启动会开始抓频道。这段时间分组数是 0,日志里写"interface.txt 不存在",都正常,等一分钟左右。
我这边抓完是 1036 个频道、56 个分组。央视频 73 个、咪咕 84 个、外部订阅 32 个,各抓取模块报出来的总和是 630——和页面上的 1036 对不上,因为页面把同名频道合并了。
配置项怎么对应、日志每一行什么意思,我在部署那篇里逐条写过,这里不重复。

地址别填错
后台给四个地址,长得像,用途完全不同。这一步错的人最多。
播放列表填 http://机器IP:1905/interface.m3u。APTV、TiviMate、Kodi、OK 影视、飞牛影视都用这个。
TVBox、影视仓、DIYP、百川影音这几个填 /txt。
节目单要单独再填一次 http://机器IP:1905/playback.xml,不填只有台名,没有时间轴。
/admin 是后台,别往播放器里填。
极空间极影视和一些老电视盒如果一直转圈,换成 interface.m3u?relay=1。这是兼容版,服务器替播放器把清单取好再给它。
还有个 ?relay=2,全代理,视频流也走你这台机器。能不用就别用——我在 2 核 2 G 的机器上试过,两路 1080p 同时开,上行直接拉满,两台设备一起卡。
真正好用的是分档
后台可以新建配置档,每个档有自己的地址:
http://机器IP:1905/interface.m3u?profile=客厅
http://机器IP:1905/interface.m3u?profile=老人房
底层频道是同一份,地址指向不同的编排。客厅留全量,卧室只留体育和新闻,老人房留十几个台、购物台全藏掉。
改一次源,三处一起变。这是它唯一比"找现成列表"强的地方——不是频道更多,是你能决定留下哪些。
它治不了什么
治不了源失效。 上游断了就是断了。自建只是让你知道断了、并且能快速关掉,不是让它起死回生。
治不了没授权。 公开能访问不等于可以拿去转售或公开转播。作者写明了这是个人学习和家庭自用的工具,权利边界以 README 里的免责声明为准。拿不准的来源,在后台关掉。
治不了不想维护。 如果你连一个月看一眼后台都不愿意,那就别装,用现成的。
一句话判断
三台以上设备在看、有台常开的机器、能接受偶尔维护一下——装。
缺任意一条,找一份能用的列表就够了,把时间省下来干别的。
版本 4.51.2,Ubuntu 24.04 实测。镜像入口:轩辕镜像|akiralereal/iptv 镜像详情