
电视盒子里的直播软件越来越难用:源失效、广告多、清晰度随缘。折腾一圈之后我换了个思路——不去找别人的源,自己搭一个。
最后跑起来的东西长这样:一台闲置的 NAS 上跑一个 Python 服务,负责”每次现算”央视的播放地址;手机、电脑、电视盒子拿到的都是一个固定的播放列表地址,打开就能看,63 个频道,含 4K。整套服务占 16 MB 内存,CPU 0.02%。
这篇文章把原理、部署、踩过的坑和实测数据都写清楚。注意:文中域名、token、IP 全部替换成了占位符。
一、先搞清楚:直播地址为什么不能”存下来”
网上流传的直播源大多是 .m3u 文本,里面写着一堆 .m3u8 地址。这类文件的生命周期通常是几天到几周,原因不是”被墙了”,而是签名会过期。
我实测了央视 CDN 的校验逻辑,结论比较明确:
分片地址长这样:
/tcloud.cctv.com/<192 位签名字符串>/.../1234.ts?timeshift=1&sid=xxx&starttime=&endtime=
- 192 位路径 hash 与
sid参数绑定。拿当前有效的 hash 去配另一个sid,直接 403;拿旧 hash 配当前参数,也是 403。 starttime/endtime不参与校验。我把整个时间窗口往前挪一小时,照样 200。- 分片文件只在时移窗口内存在。用当前有效签名去取两小时前的分片号,返回 404——文件已经被清掉了。
所以任何”静态直播源”都是在赌签名还没过期。要稳定,必须有一个服务端,每次请求时现算。
二、原理:拿”回看”接口当直播用
央视频的 H5 播放器有一个时移(回看)接口,请求参数是一段时间窗口 [t-300, t]。把 end 设成”现在”,拿到的就是直播。
中间有几个技术细节,简单说一下:
| 环节 | 做什么 |
|---|---|
| 协议 | JCE/Tars RPC,需要手写 W/R 编解码 + QMF 封装(魔数 0x13、app_id 10012、gzip 压缩) |
| 设备伪装 | 伪造机型与客户端版本号,_qua() 里写死 Pixel 6 / 特定版本号 |
| 签名 | bkliveinfo 接口返回加密的 cKey,自定义 CBC 链 TEA + 校验和 + 双密钥 guard,签名大约只能用 2 次 |
| 清单 | 返回的 m3u8 每 12 秒滚动 3 个分片,正常直播行为 |
关键的一点:这些频道分两套链路,性质完全不同。
- 58 路频道,清单里的分片地址指向
tlivecloud-playback-cdn.ysp.cctv.cn。播放器直连央视 CDN,你家只出几百字节的清单流量。 - 5 路高码率频道(cctv5 / cctv5p / cctv16 / cctv4k / cctv8k),走另一个后端,分片得经过自己的服务器中继。
这个区别后面会决定”外网能不能看”,先记住。
flowchart LR
A[播放器 / 电视盒子] -->|1. 带 token 要清单| B[NAS: ysp-live]
B -->|2. 现算签名| C[央视频接口]
C -->|3. 返回带签名清单| B
B -->|4. 返回 m3u8| A
A -->|5a. 58 路: 直连| D[央视 CDN]
A -->|5b. 5 路: 经中继| B
B -->|中继| E[4K 后端 :38766]
一句话总结:NAS 只负责发地址,视频是央视 CDN 发的。
三、部署
架构
宿主机 (NAS, host 网络)
├── ysp-live :8767 Python 3.12-alpine,主服务 + 鉴权 + 中继
└── uhdiptv (已有) :38766 4K 后端,只监听本机
主服务用 network_mode: host。这一点不能省,原因见后面的坑 #3。
docker-compose.yml
services:
ysp-live:
image: python:3.12-alpine
container_name: ysp-live
network_mode: host # 必须:容器内要访问宿主机的 127.0.0.1:38766
restart: unless-stopped
env_file: .env
volumes:
- .:/app
working_dir: /app
command: python3 ysp-live-nas.py 8767
.env
YSP_TOKEN=改成你自己的随机串
YSP_BACKEND=1
YSP_BACKEND_PORT=38766
# 可选
YSP_TS_TTL=300
YSP_TS_CACHE_MB=400
启动:
docker compose up -d
curl http://127.0.0.1:8767/health # 期望返回 ok
加了什么
原版脚本是纯标准库单文件,我改了几处:
- token 鉴权:
?token=xxx或Authorization: Bearer xxx,无 token 全部 403,/health保持开放给探活。 - 外部后端探测:原版只认自己拉起来的子进程,改成启动时读后端的
/4kfifa.m3u自动发现频道表。 - 同端口 TS 中继:
/ts?q=<base64>,把后端分片透传出去,这样公网只需要开一个端口。 - 分片缓存 + 单飞:解决 CDN 限频(见坑 #6)。
四、七个坑,一个都别踩
| # | 现象 | 原因 | 解决 |
|---|---|---|---|
| 1 | 所有频道”暂无数据” | macOS 上代理环境变量是 socks5://,而 Python urllib 不支持 socks5 | 启动前清空 http_proxy/https_proxy/all_proxy |
| 2 | 频道卡 40 秒后超时 | 后端只提供 5 路,其余频道被 302 跳到推广页,urllib 默认跟随重定向 | 自动发现频道表 + 使用不跟随重定向的 opener |
| 3 | 容器里连不上后端 | 桥接网络下 127.0.0.1 指向容器自身 | 改 network_mode: host,且不能写 ports: |
| 4 | 外网只能看部分频道 | 分片地址被改写成 内网IP:38766,外网不可达 | 改成同端口 /ts 中继 |
| 5 | 同一频道反复 403 | CDN 对同一签名的重复请求约 2 次即拒绝 | 分片缓存 + 单飞去重 |
| 6 | 起播就 403 | 后端清单只有 4 片,最老的一片接近签名失效 | 只保留最新 3 片并修正 MEDIA-SEQUENCE |
| 7 | 每次重启都收到”频道异常”推送 | 4K 后端冷启动重新生成清单常超过 3 秒探活超时 | 超时放宽到 8 秒,连续 2 次失败才告警 |
第 7 条值得多说一句:告警系统最怕的不是漏报,是误报。一旦用户开始忽略通知,监控就等于没有。所以规则改成了——连续两次坏才告警,没真正告过警的状态好转时不发”已恢复”。
五、日志里的”刷新失败”其实是正常的
部署完我盯着日志看了半天,有一行很刺眼:
cctv14 地址疑似过期, 已重取
cctv14 刷新失败: HTTPError: HTTP 403
但同一时间电视上播得好好的。
原因是:日志报的是”后台取新地址失败”,播放用的是”上一次成功取到的清单”。清单只在成功时覆盖,失败不会清空。而签名大约只能用 2 次,后台每 10 秒刷一次,必然反复 403。
改了三处收尾:
- 撞 403 立即换新地址(原来是每个地址
sleep 2白等) - 地址 TTL 从 300 秒降到 20 秒,主动重取
- 日志节流:换地址 5 分钟才打一行,避免刷屏
判断真假故障,不要看日志,看 /diag 里的”最后成功”时间戳。
六、带宽:一条别自欺欺人的底线
实测家宽上行 1.27 MB/s ≈ 10 Mbps。而:
| 内容 | 需要带宽 | 结论 |
|---|---|---|
| 58 路 CDN 直连(1080p) | 0(不占上行) | 外网随便看 |
| 后端 1080p | ~12 Mbps | 勉强,会卡 |
| 后端 4K | ~33 Mbps | 不可能 |
所以”外网看 4K”这件事,在没有专线的前提下无解。我加了个 ?src=jce 参数,强制回落到直连 1080p 源——对家里上行没压力,外网也能稳。
如果你也打算做类似的事,先测上行,再谈画质。
七、电视端怎么接
这部分踩坑最多,因为”直播 App”这个词对应好几种完全不同的接口体系。
| 客户端 | 用什么 | 说明 |
|---|---|---|
| 电视盒子(TVBox 系) | JSON 配置里的 lives 字段 | 只认 m3u / txt,不认 JS 扩展 |
| 安卓电视(观屿TV 等) | 直接填 all.m3u 地址 | 只支持 M3U/M3U8 + XMLTV 节目单 |
| iOS / Apple TV(XPTV App) | subscription.json | 这套才认 JS 扩展 |
TVBox 的配置可以写成一个 JSON 托管在服务上,一次性搞定:
{
"spider": "",
"sites": [],
"lives": [
{
"name": "央视频直播",
"type": 0,
"url": "http://你的域名:8767/all.m3u?token=你的TOKEN",
"epg": "https://epg.example.com/?ch={name}&date={date}",
"logo": "https://epg.example.com/logo/{name}.png"
}
]
}
把这段的地址填进 TVBox 的”配置地址”即可。
一个容易踩的误区:TVBox 的 type: 3 JS 扩展要求实现 homeContent / categoryContent / detailContent / playerContent 这一套函数;而 XPTV App 的扩展要求 getConfig / getCards / getPlayinfo。两者长得像,函数名完全不同,互相不兼容。我第一次就把 XPTV 的扩展塞进 TVBox,结果一个台都出不来。
八、运维:让它自己盯着自己
频道失效通知
服务内置了轻量监控,只检查”最近 5 分钟有人看过”的频道(不额外请求,零风控成本),180 秒无成功刷新就推送,30 分钟冷却,恢复时补推。
坑:凭证错误也返回 HTTP 200,错误码在 body 里。所以通知函数必须解析 code 字段才算成功,否则你会以为一切正常。
容器存活看门狗
服务本身挂了,内置监控自然也没了。所以外面再套一层:
*/5 * * * * /path/to/watchdog.sh
逻辑:curl /health 连续 2 次失败才推送,6 小时冷却,日志保留 200 行。
测 cron 千万别用带 $(...) 的复杂命令。我第一版测试脚本引号转义错了,cron 根本没执行,误判成”cron 坏了”排查半天。正确做法是用极简探针:
* * * * * /usr/bin/touch /tmp/cronprobe
文件出现了,就说明 cron 本身没问题。
九、成本
| 项目 | 数值 |
|---|---|
| 内存 | 302 MB(缓存生效后) |
| CPU | 0.02% |
| 端口 | 1 个(8767) |
| 依赖 | 纯 Python 标准库 + 一个现成后端镜像 |
硬件是本来就在跑的 NAS,增量成本接近零。
十、几个需要说清楚的风险
- 上游协议随时可能变。伪装机型、客户端版本号、加密算法全是写死的,官方一升级客户端就可能失效。这不是”一劳永逸”的方案,需要偶尔维护。
- 有风控。单设备取链太频繁会被拒,所以监控才要做得这么克制。
- 只适合小范围自用。公开分享等于把你的带宽和风控额度摊给陌生人,
/ts那 5 路上行很快会被占满——这也是要加 token 的真实原因,不是防盗链那么严肃。 - 请遵守相关法律法规与平台服务条款,本文仅作技术记录。
写在最后
这套东西的价值不在于”能看电视”,而在于把一件黑盒的事拆开看清楚了:一个直播地址由哪些参数决定、校验靠什么、什么情况下会失效。
搞清楚这些之后,那些”三天两头换源”的焦虑就消失了——因为你知道它在哪一步、为什么坏、怎么修。