Featured image of post 家里三块屏共用一个直播源地址,APTV 到底该填哪个

家里三块屏共用一个直播源地址,APTV 到底该填哪个

同一份直播源导进三台设备,改一次要改三处,这是我去年的做法。把列表挪到自己机器上之后,三块屏只填一个地址。含 APTV 该填哪个地址、节目单为什么要单独填、relay 参数的真实代价。

去年我干过一件挺蠢的事。

把同一份直播源列表,分别导进了客厅的 Apple TV、卧室的 iPad、还有老家那台安卓盒子。

导的时候没觉得有什么。三个月后问题露出来了——列表里的台开始一个个黑掉,我得打开三个不同的 App,一个一个重新导。

老家那台更麻烦,得在电话里指挥我爸:点右上角,找"直播源",把原来那条删掉,再粘一条新的。

他每次都问"哪个是右上角"。

今年换了个做法:把那份列表挪到自己的服务器上,三块屏只填同一个地址。

第一次装错了项目

一开始图省事,装的是 guovin/iptv-api。

很顺利。起来之后它自己抓了一份列表,进后台一看,几百个台,挺全。

问题出在第二天。我想把一堆购物台去掉,翻了半天配置,发现能改的只有"抓哪些源"“抓多少个”,没有"去掉哪个台"。

它生成的是一份结果,我不参与编辑。

这不是它做得不好,它的定位就是自动产出。但我要的是"我只要央视一套、十三套和几个省台",它不接这个需求。

后来换成 akiralereal/iptv。这个思路不一样:来源你自己接,频道你自己编排,最后它按你的编排吐出地址。

装的过程卡了两次

第一次卡在内存。

我拿一台 2 核 2 G 的小机器试,起来十分钟,容器自己重启了。docker compose logs 里干干净净,什么报错都没有。我一开始怀疑是 restart: always 在捣乱,改了半天没用。

后来在 dmesg | grep -i oom 里看到它被系统杀了。这项目自带 Chromium,用来解析那些必须走网页的来源,每开一路吃 200~400 MB,2 G 的机器扛不住。

加了一行 mbrowserConcurrency=1 就稳了。现在跑在 2 核 4 G 上,常驻不到 500 MB。

第二次卡在"文件不存在"。

起来之后日志里一直刷:

Error: ENOENT: no such file or directory, open '/iptv/data/interface.txt'

我去查了挂载路径、查了目录权限,还 chmod 777 试了一遍,全没用。

其实什么都不用做。那个文件是它抓完频道才生成的,我是在它还没抓完的时候就去请求了。等一分钟,它自己就出来了。

这两次加起来浪费了大概两个小时,都是因为不知道自己在看什么。

命令

docker pull docker.xuanyuan.run/akiralereal/iptv:4.51.2

镜像一直用轩辕的,充了一次钱用到现在。这台机器我不想再装 proxy,也不想动 daemon.json,图的就是省事。

你要是本来就能直连 Docker Hub,这句当我没说,image: 写原地址就行。

版本和 Digest 在镜像页上能对。

别用 latest。这项目每次发版会改 latest 的指向,我有次重启之后后台多出两个需要重新授权的模块,翻日志才想到是上游发版了。

sudo mkdir -p /www/wwwroot/iptv/data
sudo chown "$USER":"$USER" /www/wwwroot/iptv
cd /www/wwwroot/iptv
cat > compose.yaml <<'EOF'
services:
  iptv:
    image: docker.xuanyuan.run/akiralereal/iptv:4.51.2
    container_name: iptv
    init: true
    restart: always
    ports:
      - "1905:1905"
    environment:
      - mport=1905
      - mdataDir=/iptv/data
      - mbrowserConcurrency=1
    volumes:
      - ./data:/iptv/data
EOF

参数一个一个解释起来太长,我在那篇部署记录里写过,这里只留能跑起来的部分:

docker compose up -d
docker compose ps

看到 STATUS 是 Up 就行。浏览器开 http://机器IP:1905/admin,没有账号,直接就进去了。

第一次启动会抓频道,我这台机器上一分钟左右出来 1036 个频道、56 个分组。左边栏选「体育」,这一组 24 个台,CCTV5 和 CCTV5+ 点一下就能在网页里播。

iPTV 我的频道:1036 个频道,左侧选中体育分组(24 个频道)

APTV 到底填哪个地址

这是我最开始绕了远路的地方。

后台给了四个地址,网上说法也不一致,我一度把 /admin 填进 APTV 里,当然打不开。

正确的做法:

播放列表填 http://机器IP:1905/interface.m3u。

节目单单独填一次 http://机器IP:1905/playback.xml。

两个都要填。只填第一个也能出画面,但界面会一直显示"暂无节目信息",因为没有 EPG 就没有时间轴。

/txt 那个是给 DIYP、百川影音、TVBox 这类播放器用的,APTV 不认,填了也拉不到。

如果列表能拉到、点进去一直转圈,换成 http://机器IP:1905/interface.m3u?relay=1。这是兼容版,服务器先把清单取好再交给 APTV,视频流还是播放器直连上游,不怎么占带宽。

还有个 ?relay=2,全代理。我在 2 核 2 G 那台机器上试过,两路 1080p 一起开,上行直接满,两台设备同时卡。

能不用就不用。

三个档,三块屏

后台「我的频道」里可以新建配置档,每个档有自己的地址:

http://机器IP:1905/interface.m3u?profile=客厅
http://机器IP:1905/interface.m3u?profile=老人房

底层是同一份频道,编排不同。

我分了三个。

客厅的 Apple TV 留全量,想找什么都有。

卧室的 iPad 只留体育和新闻。体育加上新闻,够我看很久了,不用在几百个台里翻。

老人房那台旧盒子只留十五个。央视一套、十三套,加几个省卫视,购物台全部隐藏。这个档是我爸唯一不会弄乱的——他没得可弄。

改一次源,三个地址同时生效。现在老家那边的台黑了,我在后台关掉一个,他那边重启一下 App 就好了,不用再教"哪个是右上角"。

播放窗:CCTV5体育,体操比赛

几个走不通的地方

它不会让失效的台复活。 上游断了就是断了,自建只是让你知道断了、并且能一次关掉。

它需要一台一直开着的机器。 NAS、软路由、闲置小主机都行,2 G 内存起步。没有这样的机器,这事不值得折腾。

它需要你偶尔维护。 一个月进后台看一两次,把坏掉的源关掉或者换一个。这是自托管的代价。

它有权利边界。 公开能打开的地址,不等于可以拿去转售或者公开转播。README 里有免责声明,拿不准的来源,后台里关掉。

现在

三块屏各填一个地址,改频道只改一处。

升级是这样:

cd /www/wwwroot/iptv
docker compose pull
docker compose up -d

备份就是拷 ./data,配置、编排、订阅源全在里面。别执行 docker compose down -v,那会连数据卷一起删掉。

回头看,这件事没什么技术含量,就是把一份文件从三个 App 里抽出来,放到一台自己的机器上。

只是下次我爸那边黑了,我不用打电话了。

版本 4.51.2,Ubuntu 24.04 实测。

镜像入口:轩辕镜像|akiralereal/iptv 镜像详情

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