用一台 NAS 自建央视频直播源:从抓地址到电视端落地

电视盒子里的直播软件越来越难用:源失效、广告多、清晰度随缘。折腾一圈之后我换了个思路——不去找别人的源,自己搭一个。

最后跑起来的东西长这样:一台闲置的 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

加了什么

原版脚本是纯标准库单文件,我改了几处:

  1. token 鉴权:?token=xxx 或 Authorization: Bearer xxx,无 token 全部 403,/health 保持开放给探活。
  2. 外部后端探测:原版只认自己拉起来的子进程,改成启动时读后端的 /4kfifa.m3u 自动发现频道表。
  3. 同端口 TS 中继:/ts?q=<base64>,把后端分片透传出去,这样公网只需要开一个端口。
  4. 分片缓存 + 单飞:解决 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同一频道反复 403CDN 对同一签名的重复请求约 2 次即拒绝分片缓存 + 单飞去重
6起播就 403后端清单只有 4 片,最老的一片接近签名失效只保留最新 3 片并修正 MEDIA-SEQUENCE
7每次重启都收到”频道异常”推送4K 后端冷启动重新生成清单常超过 3 秒探活超时超时放宽到 8 秒,连续 2 次失败才告警

第 7 条值得多说一句:告警系统最怕的不是漏报,是误报。一旦用户开始忽略通知,监控就等于没有。所以规则改成了——连续两次坏才告警,没真正告过警的状态好转时不发”已恢复”。


五、日志里的”刷新失败”其实是正常的

部署完我盯着日志看了半天,有一行很刺眼:

cctv14 地址疑似过期, 已重取
cctv14 刷新失败: HTTPError: HTTP 403

但同一时间电视上播得好好的。

原因是:日志报的是”后台取新地址失败”,播放用的是”上一次成功取到的清单”。清单只在成功时覆盖,失败不会清空。而签名大约只能用 2 次,后台每 10 秒刷一次,必然反复 403。

改了三处收尾:

  1. 撞 403 立即换新地址(原来是每个地址 sleep 2 白等)
  2. 地址 TTL 从 300 秒降到 20 秒,主动重取
  3. 日志节流:换地址 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(缓存生效后)
CPU0.02%
端口1 个(8767)
依赖纯 Python 标准库 + 一个现成后端镜像

硬件是本来就在跑的 NAS,增量成本接近零。


十、几个需要说清楚的风险

  1. 上游协议随时可能变。伪装机型、客户端版本号、加密算法全是写死的,官方一升级客户端就可能失效。这不是”一劳永逸”的方案,需要偶尔维护。
  2. 有风控。单设备取链太频繁会被拒,所以监控才要做得这么克制。
  3. 只适合小范围自用。公开分享等于把你的带宽和风控额度摊给陌生人,/ts 那 5 路上行很快会被占满——这也是要加 token 的真实原因,不是防盗链那么严肃。
  4. 请遵守相关法律法规与平台服务条款,本文仅作技术记录。

写在最后

这套东西的价值不在于”能看电视”,而在于把一件黑盒的事拆开看清楚了:一个直播地址由哪些参数决定、校验靠什么、什么情况下会失效。

搞清楚这些之后,那些”三天两头换源”的焦虑就消失了——因为你知道它在哪一步、为什么坏、怎么修。

暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇