LibreTV
自由观影，畅享精彩
免费、开源的在线视频聚合搜索与观看平台：服务端聚合搜索、广告过滤、秒级续播、换源测速，Docker 一键部署。
核心特性
为什么选择LibreTV？
聚合搜索
多采集站服务端并行搜索，单源失败不影响整体，用户 IP 不暴露给第三方。
跨源同名聚合
同名影片合并为一张卡片，展开即可比较和选择各来源。
HLS 播放
ArtPlayer + hls.js 内核，广告分片过滤、自动连播、倍速与快捷键。
秒级续播
播放进度与观看历史存于本机 IndexedDB，精确到秒的续播。
换源测速
跨源搜索同名资源并测速排序，一键切换保留集数位置。
源测试与订阅
一键探活数据源，订阅远程源列表（LibreTV-SourceList JSON），可导出分享。
快速部署
Docker 一键部署，支持 amd64 / arm64 双架构
Docker 部署
拉取 GHCR 发布镜像，零构建启动。PASSWORD 为访问密码，必填。
docker run -d \
--name libretv \
--restart unless-stopped \
-p 8899:8080 \
-e PASSWORD=your_password \
ghcr.io/librespark/libretv:latestDocker Compose 部署
设置 .env 中的 PASSWORD 后一键启动。
services:
libretv:
image: ghcr.io/librespark/libretv:latest
container_name: libretv
ports:
- "8899:8080"
environment:
- PASSWORD=${PASSWORD:-your_password}
restart: unless-stopped
也支持源码运行（npm install && npm run build && npm start），更多配置与部署方式参阅完整部署文档。
技术栈 & API格式
现代化的技术架构与标准化API支持
🛠️ 技术栈
📡 API格式支持
LibreTV 支持标准的 苹果 CMS V10 API 格式，兼容大部分CMS资源站点：
https://example.com/api.php/provide/vod/?ac=videolist&wd=关键词
https://example.com/api.php/provide/vod/?ac=detail&ids=视频ID
添加数据源
空壳设计，不内置任何采集站。部署者通过 DEFAULT_SOURCES 环境变量预置；用户在设置面板手动添加，或订阅远程 LibreTV-SourceList JSON 源列表。
⌨️ 键盘快捷键
重要声明
⚠️请在使用前仔细阅读以下重要信息，完整说明见文档 FAQ
服务性质
本项目不存储、不制作任何视频内容，仅聚合第三方公开接口，内容合法性由数据源负责。
用户责任
使用本项目须遵守当地法律法规，不得用于下载、传播未经授权的作品。
广告风险
视频均来自第三方采集站，其中出现的广告与本站无关，请勿相信或点击。
安全建议
部署时务必设置 PASSWORD 密码，勿将实例链接公开分享或传播。
法律责任
项目开发者不对使用本项目产生的任何后果负责。
使用范围
仅供学习与个人使用，请勿用于商业用途或公开服务。
关于 LibreTV
LibreTV 是一个免费、开源的在线视频聚合搜索与观看平台。服务端聚合搜索保护用户隐私，播放进度只保存在你自己的设备上——让技术服务于人，让观影回归纯粹。
LibreTV Project
开源视频聚合搜索与观看平台
"让每个人都能享受自由观影的乐趣"