把散落在多个采集站里的影片资源聚合成一个能搜、能播、能续看的统一入口,是很多自建影视站用户反复遇到的现实需求。LibreTV 正是围绕这件事做文章的一个开源项目:它把聚合搜索、跨源比对、播放器能力、直播订阅和进度同步收拢在一个基于现代前端框架搭建的界面里,让搭建者不必从零拼装各个组件。对于手里有采集站接口、想快速拥有一个能看能搜的影视门户,又希望数据留在自己服务器上的人来说,这类工具的价值不在于替你找片源,而在于把已有的源组织好、播放好、维护好。它面向的既是愿意动手部署的技术爱好者,也是想给家人朋友搭一个干净观看环境的普通用户——只要你提供可用的数据源,剩下的聚合、播放、订阅与同步工作,它都尽量替你承担下来。
LibreTV是什么?
LibreTV 是一个基于 Next.js 15(App Router)+ TypeScript + Tailwind CSS 构建的开源在线视频聚合搜索与观看平台,主要用来把多个采集站的资源汇入同一个界面,提供检索、比对与播放的一体化体验,服务于希望自建影视站、又不愿从零开发播放与管理功能的个人与团队。它采用 Next.js 迁移版架构,播放内核由 ArtPlayer 与 hls 内核承担,支持亮暗双主题。项目按 AGPL-3.0 协议开源,自 2025 年 4 月创建以来持续维护,社区关注度不低——星标数超过两万五千,派生数也在三万上下,说明它在自建影音这一类工具里已经有相当的使用基础。它本身不提供片源,核心价值在于把外部数据源代码化、可配置化,让搭建者用较低成本获得一个结构完整的观看入口。

核心功能
- 聚合搜索——多个采集站的服务端并行检索,一次输入就能把各源结果汇总回来,省去逐个站点翻找的麻烦。
- 跨源同名聚合——同名影片合并为一张卡片,展开即可比较和选择不同来源,画质与可用性能直观对比。
- HLS 智能播放——播放内核由 ArtPlayer 与 hls 承担,支持广告分片过滤、片头片尾跳过标记与自动跳过、自动连播、倍速、快捷键,移动端还能长按三倍速。
- 直播与 IPTV——解析 M3U 订阅,在独立页面按分组浏览、搜索频道并站内播放,兼容 HLS 与 HTTP-FLV,支持 XMLTV 节目单与频道收藏,直播流走专用长连接代理转发。
- 进度同步——播放进度与观看历史保存在本机浏览器数据库里,精确到秒,下次打开可以无缝续播。
- 换源测速——跨源搜索同名资源并测速排序,一键切换还能保留当前集数位置,遇到卡顿时不必从头找起。
- 首页推荐与 PWA——可切换豆瓣分类、新番放送表或影视榜单作为首页内容,服务端直连并缓存;同时支持安装到桌面或主屏幕,亮暗双主题切换没有首屏闪烁。

使用场景
| 人群/角色 | 场景描述 | 推荐指数 |
|---|---|---|
| 自建影音爱好者 | 手里有采集站接口,想快速搭一个能搜能看的影视门户,省去前端开发 | ★★★★★ |
| 家庭用户 | 给家人部署一个干净的观看入口,配置一次即可长期续播使用 | ★★★★☆ |
| 直播观看者 | 用 M3U 订阅整理频道,按分组浏览并站内播放,配合节目单追节目 | ★★★★☆ |
| 多源折腾玩家 | 需要比对同名影片、测速换源,追求更稳的播放体验 | ★★★★☆ |
| 轻量设备用户 | 在 ARM 路由器等设备上用免容器预构建包运行,避开容器限制 | ★★★☆☆ |
| 开发者 | 想基于现成的聚合与播放层做二次开发或定制界面 | ★★★★☆ |
操作指南
- 准备运行环境。推荐用容器方式部署:准备好一台能联网的机器,安装好容器引擎与编排工具,再从项目发布渠道拉取镜像。镜像同时发布在两个公共仓库,标签覆盖最新版、主次版本与完整版本号,且两个仓库的镜像摘要一致,可按需固定版本。
- 配置基础参数。新建一个环境变量文件或直接在编排文件里填写,最关键的是访问密码——它只保存在服务端环境变量中,前端不会持有任何可重放凭证;端口按需要指定,镜像内默认监听 8080,若用预构建包则默认 3000,注意区分两者。
- 决定是否启用加密访问。对外提供服务建议套上安全传输层,因为登录密码在请求体里以明文传输,公网普通连接可能被中间人看到,可用反向代理或内容分发网络终结加密;但登录本身并不依赖它,会话的安全标记会按请求协议自动推导,内网直连也能正常登录,需要强制时再手动指定。
- 启动并核对版本。执行启动命令后,用状态接口返回的 version 字段确认版本是否与预期一致;版本号以项目配置文件为单一来源,避免因镜像缓存导致版本错位。
- 导入数据源。进入管理界面后找到源管理入口,填入采集站接口地址或远程订阅地址。订阅由服务端拉取并经过安全校验,因此订阅地址无需配置跨域,常见的代码托管、对象存储与静态托管都可用;导入时点播源会自动勾选、直播源会自动启用,条目上会显示对应的数量标识。
- 完成首次设置并立即使用。切换到观看界面,按需设置首页推荐内容(豆瓣分类、新番放送表或影视榜单),检查播放器的跳过片段与倍速是否符合习惯,然后就能开始检索和观看。更多进阶配置项可查阅随项目提供的完整文档,也可前往 LibreTV 官网 了解演示与说明。
支持平台
从现有资料看,项目主要面向 Web 端:它本身是一个基于 Next.js 的网站应用,通过浏览器访问使用,并支持以 PWA 形式安装到桌面或主屏幕,具备亮暗双主题。服务端方面提供容器镜像(覆盖 amd64 与 arm64 双架构)以及免容器的预构建包,后者与 CPU 架构无关,x86_64、arm64 乃至 armv7 都能运行,适合路由器等轻量设备。资料中没有提到独立的桌面客户端、移动 App、小程序或浏览器插件,这部分可视为站方没有明确列出。
产品定价
站方未公开价格信息,以站内为准。可以确认的是,这是一个按 AGPL-3.0 协议开源、定位为免费在线视频聚合搜索与观看平台的项目,搭建者自备服务器与数据源即可自行部署;实际产生的成本主要是自己的机器、带宽等基础设施开销,而非向项目方支付的费用。
常见问题
Q:搭建 LibreTV 需要自己准备片源吗?
需要。它本质上是一个聚合与播放的框架,本身不提供任何影视内容,真正能搜到什么取决于你导入的采集站接口或订阅列表。项目支持点播源与直播源的批量导入、测活与健康度记录,但源的质量与可用性需要搭建者自己甄别和维护。
Q:登录一定要配置加密传输吗?
不一定。登录接口本身不依赖加密传输,会话的安全标记会按请求协议自动推导,在内网通过普通地址也能正常登录;不过密码在请求体里以明文传输,若要把服务暴露到公网,仍建议用反向代理或内容分发网络终结加密,避免被中间人窥探。
Q:订阅地址提示格式不正确怎么办?
先确认订阅内容里至少包含点播源或直播源其中之一——两者都缺才会报这个错;其次订阅地址需要直接返回可被解析的内容,经过编码或压缩包装的分享链接无法识别。多仓配置也不被支持,应改用单仓配置;导入时非公网地址会被过滤,直播源若要用内网地址需单独开启相应开关。
开发者小结
综合来看,LibreTV 的长处在于把聚合搜索、跨源比对、播放内核、直播订阅与进度同步这些能力打包成一个结构清晰、可自托管的 Web 应用,部署方式灵活,既有容器镜像也有跨架构的免容器包,适合愿意动手配置数据源的个人与小型团队。它的取舍也很明显:项目只负责组织与播放,不提供内容,源的质量完全取决于搭建者;部分高级订阅格式与多仓配置不被支持,加密登录若暴露公网还需自行补齐传输层保护。因此它更适合作为自建影音的底座,而不是开箱即用、内容内置的一站式方案——评估时先确认自己有稳定可用的数据源,再决定投入多少精力做订阅与测速维护。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...









