LibreSpark/LibreTV
把多个第三方采集站和 IPTV 播放列表聚合成一个可自托管的私人影视站,负责搜索与播放。
解决什么问题
自建影视观看环境的人,手上往往攒了若干个 Apple CMS 采集接口和一串 M3U 直播列表,每个源各有各的搜索框,失效、卡顿、换源都要手动折腾。LibreTV 用一个 Next.js 前端把这些源收拢到一起:一次搜索并行查所有源,同名结果合并展示,点开就在浏览器里用 HLS/FLV 播放。它是聚合器和播放器,本身不提供任何片源。
有什么不同
这个领域常见的替代是 TVBOX 这类安卓客户端,或者 VLC、PotPlayer 这种纯播放器。LibreTV 的不同在于形态是一个带访问密码的服务端 Web 应用,一次部署就能让手机、电视、桌面浏览器同时用,不依赖安装客户端。真正有区分度的设计偏运维而非外观:同名影片跨源合并成一张卡片,换源时保留集数位置;源会自动探活,连续失败按 30 分钟、24 小时、长期三档阶梯停用;订阅同时兼容自家的 JSON 格式和 TVBOX 配置,已有列表能直接复用。直播、EPG 节目单和专门的长连接流代理也做在同一个应用里,而不是外挂模块。
适合谁
已经跑着 Docker、有反向代理、愿意自己维护源列表的自托管用户。家庭或小圈子共用一个密码的场景刚好合适。如果你想要开箱即用、自带内容的服务,请绕开——项目明确不内置任何频道和片源,合法来源得自己准备。需要多用户账号、家长控制或转码的也请绕开,README 只描述了单一共享密码,看不到按用户管理的能力。
上手成本
需要 Node 18+ 或 Docker。部署是 compose pull 加一个必填的 PASSWORD 环境变量;README 另外提供 standalone 压缩包,给跑不了 Docker 的 ARM 路由器用。主要风险不在技术而在法律和运维:内容合规性完全取决于你配置的第三方源;README 自己也提醒,不在前面套 TLS 的话登录密码会以明文走 HTTP。观看记录存在浏览器本地 IndexedDB,换设备不跟随。许可证是 AGPL-3.0,如果你打算改完公开托管,这一点要留意。
点评
这是一个年轻项目——2025 年 4 月创建,按追踪数据算大约 18 个月——但关注度不小:单周新增约 2,679 star,TypeScript 周榜排到第 12。fork 数与 star 数之比异常高,叠加近期这波涨势,通常说明大家是真的在部署而不只是收藏,这比单纯的 star 数更有参考价值。以这个年龄的项目而言 README 相当完整,SSRF 防护、cookie 标记、源健康策略都写到了,维护者在按运维的思路做事。但它仍是快速迭代中的代码库,只有单一共享密码,且自身没有内容——请把它当作需要你持续喂源、自己把关合规性的基础设施,而不是开箱即用的流媒体服务。
本文由 AI 根据项目 README 生成,更新于 2026年10月24日,以项目官方文档为准。