iPTV:把散落的电视直播源,收进自己的服务器

前两篇把电视桌面换成了 Aerial,又把厂商预装的推荐和遥测用 CleanYourTV 停了一批。桌面清净了,内容还没解决:家里人要看直播,还是得打开一个直播软件,先跳过购物台,再在一堆重复频道里找。

网上找 M3U 这事我也干过。今天能用,过几天一半失效;电视、手机各存一份,改一次要挨个更新。iPTV 换了个思路:源放在自己的服务器上,谁要看就来拿同一份列表。

项目在 GitHub 上开源,GPL-3.0,作者是 akiralereal。它本身不播节目,做的是直播源的管理和分发。下面几张是项目仓库里的演示图,不是我这台服务器的截图。

iPTV 后台的「我的频道」:左边是频道分组,右边是频道卡片,顶部是订阅地址

它不播节目,管的是源

iPTV 干的事不复杂:把各处的直播源收进来,去重、分组、排序、改名、隐藏,再输出成 M3U、TXT 和 EPG。M3U 是播放器认的频道清单,EPG 是节目单。

收的地方不少:央视频、咪咕、B 站、抖音、虎牙、斗鱼,各省市广电的官网和 App,iPanda 的熊猫机位,央视网的景观直播,还有体育赛事。自己手里的源也能加,M3U、TXT、单条直链都行。

播放器不用换。电视上的 TiviMate、Kodi、OK 影视,手机上的 APTV,电脑上的 PotPlayer、VLC,Emby 和 Jellyfin 也能把 M3U 当电视直播源、把 playback.xml 当节目单。播放器只认一个订阅地址,背后换了什么源,它不管。

频道比想象的多

项目默认聚合 1000 多路,我这边拉下来 1200 多。央视频有 63 个免登录公开频道,另有 10 个要登录会员;CCTV4K、CCTV16 4K、CCTV8K 默认走投屏源,不用自己找 4K 直链。iPanda 22 路,20 个熊猫机位加两路珍稀动物。

地方台是这项目最费功夫的部分。省台、市台、区县台,很多直接从官网或 App 的公开接口取流,短效签名、防盗链、CDN 轮换都在模块里处理。光四川就有几十路,成都的区县台、绵阳、泸州、凉山这些都在。景观直播、慢直播、昨天今天明天的赛事,也各有分组。

港澳和海外也有一批:凤凰、香港卫视、澳门澳广视、NHK World、YTN、France 24,还有 Red Bull TV、Xumo、YouTube 直播。澳门和「海外」那一组默认关着,要用自己在源管理里打开;开之前先看服务器的网络位置。

源管理:每个抓取模块单独开关,能看到状态和频道数

部署就一条命令

官方推荐 Docker Compose。一个 docker-compose.yml,一条 docker compose up -d,几分钟就能跑起来:

services:
  iptv:
    image: akiralereal/iptv:latest
    container_name: iptv
    init: true
    ports:
      - "1905:1905"
    environment:
      - mport=1905
      - mpass=ChangeMe2026
    volumes:
      - ./data:/iptv/data
    restart: always

有 NAS 的可以直接在 NAS 上跑,不必另买服务器。只在家里看,局域网地址就够;要在外面看,再反代出去。升级 4.77 那次,registry-1.docker.io 拉了半天不动,最后换加速源才下来,拉完 docker tag 回官方名就行。别用来路不明的镜像。

data 目录一定要挂出来。不挂的话,重建容器或升级镜像,配置和登录态就没了。设了 mpass 之后,后台和订阅地址都要带密码路径,比如 /你的密码/interface.m3u,换播放器时别忘了。示例里的密码只是占位,记得换掉。

跑起来后有三个地址:/admin 是后台,/interface.m3u 是标准订阅,/playback.xml 是节目单。DIYP、百川这类用 /txt;飞牛影视要保留 .m3u 后缀,写 /m3u 它不认。

我这边是国内的 VPS,容器只绑 127.0.0.1:1905,外面用 OpenResty 反代到 443,再加一层认证。订阅地址只给家里几台设备。后台设了密码,数据目录单独备份;后台设置里有备份迁移,换机器能导出导入,我习惯升级前再把整个 /opt/iptv 打个包。

家里几台设备怎么用

电视、手机、电脑填同一个订阅地址,分组和顺序都一样。后台改完,1-2 秒重新生成清单,播放器下次刷新就能看到,不用挨个设备改。

后台第一眼信息量很大:左边分组,右边频道卡片,顶上是订阅地址;用一阵就顺手了。家里人不需要那么多台,可以建多套配置档,也能给每台设备发不同的用户令牌:客厅电视留央视、卫视、本地台和体育,卧室只留几个常看的,购物台和用不上的分组直接隐藏。隐藏不是删除,想恢复随时能找回来。

订阅分三种:标准版、兼容版、全代理版。标准版最省服务器,清单 302 跳到官方地址,视频由播放器直连;老盒子不跟跳转就用兼容版,清单由服务器取;兼容版还不行,才用全代理,视频分片也走服务器,这时候吃的是服务器的带宽。能标准就标准,别一上来就全代理。

后台自带的网页播放器,可以直接预览频道

节目单不是每个台都有。央视、卫视、部分省台有今明两天,咪咕的回看能补前几天;很多地方台只有当天,或者干脆是占位。项目会把能拿到的 EPG 聚合起来,拿不到的就空着。

几个坑

最常遇到的是维护。地方台的签名、CDN、App 接口都可能变,模块状态里能看到哪一路挂了;后台有失效检测,也能给同一个频道排多条源。别指望一份清单用一年。

网络位置也挑服务器。国内 VPS 能看大部分省市台,港澳和海外模块要能连出去;部署在海外,一些只放行大陆的地方台就取不到。买服务器之前先想清楚主要看哪几类。

全代理吃带宽,这个也要提前知道。标准版几乎不占服务器流量,全代理是视频全部经服务器。家里几个人同时看 4K,小水管扛不住,先试标准版,实在不兼容再换。

会员频道得用自己的账号。央视频会员、四川广电这些,项目用的是部署者本人的登录态,不是内置账号。后台按模块给登录方式:能扫码的扫码,Docker、NAS 这类没有桌面的,就按提示从浏览器复制 Cookie。凭据只存在自己的部署里。别把账号借出去,也别把带令牌的订阅地址发群里。

升级也别追最新。项目更新很快,我写这篇时上游是 4.79,我跑的是 4.77。升级要 docker compose pull 再 up -d,只重启容器不会换版本,升级前看一眼更新日志。我这边改过两处小地方:订阅加 ?logo=0 关台标,老盒子加载快一点;四川卫视 4K 保留独立音轨,不然有些播放器会选到空的那条。每次升级都要重打,所以等一两个版本再升,升完先验 4K 频道和台标。

它不是“免费电视”

iPTV 不托管节目,它只是把公开可访问的地址整理成清单。公开能打开,不等于可以随便转播;自己家里看,和把订阅地址发出去、拿去做商业转播,是两回事。会员频道用的是你自己的账号,地方台和赛事也有地域限制,源站一改就失效。它能把能看的收在一起。什么都能看、永远能看,做不到。

如果你有 NAS 或 VPS,愿意偶尔维护,家里老人固定看几个台,这套很合适。想装完永远不管的,别折腾。

三件套到这儿就齐了:Aerial 管桌面,CleanYourTV 管预装,iPTV 管内容源。三个都开源,都能备份,出了问题能回到原样。

项目在 github.com/akiralereal/iptv,镜像在 Docker Hub,README 写得很细,部署前先翻一遍“快速开始”和“播放器适配”。

假如哪位博友不想麻烦搭建的话,我这边也可以提供呢,为爱发电嘛。

😊
提交

评论区

共 1 条评论

  1. 头像
    从换桌面到停遥测再到收直播源,一套下来电视终于干净了。把直播源收自己服务器这步最关键。
    28分钟前 北京