链氪巴士
  1. 首页
  2. 站点导航
  3. 文章
  4. 快讯
  5. 软件
  6. 书刊
  7. GitHub 加速
  8. 关于
Featured image of post 直播源老失效,自己搭一套值得吗?先看有没有这三样东西

直播源老失效,自己搭一套值得吗?先看有没有这三样东西

家里三台设备各存一份直播源,改一次要改三处,改到第三次就不管了。自建能把这个麻烦收掉,但收不掉“源会失效”这件事。装之前先确认三样东西在不在:常开的机器、愿意看后台、不止一台设备。

先把话说明白:大部分人不需要自建 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 对不上,因为页面把同名频道合并了。

配置项怎么对应、日志每一行什么意思,我在部署那篇里逐条写过,这里不重复。

iPTV 后台我的频道: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 镜像详情

使用 Hugo 构建
主题 Stack,作者 Jimmy