LibreTV 是一个基于 Next.js 的在线视频聚合搜索与观看平台,支持多源搜索、HLS 播放、观看进度、直播/IPTV、PWA 和亮暗主题。它只负责聚合和播放用户配置的第三方公开数据源,不自带影视内容。
本文以 LibreSpark/LibreTV 官方仓库当前版本为例,介绍使用 Docker Compose 部署的方法。
项目地址:LibreSpark/LibreTV
一、准备服务器
建议使用 Debian 11/12、Ubuntu 22.04/24.04 等 Linux 系统,并准备 Docker、Docker Compose Plugin、一个域名、至少一个合法稳定的 Apple CMS 点播接口和一个自定义访问密码。
检查 Docker:
1 | docker --version |
二、使用 Docker Compose 部署
1 | mkdir -p /opt/libretv |
创建 docker-compose.yml:
1 | services: |
替换密码后启动:
1 | docker compose pull |
如果服务器防火墙允许 8080 端口,访问 http://服务器IP:8080 即可。登录密码就是 PASSWORD 的值。
三、添加视频数据源
登录后进入“设置 → 源管理 → 点播源”,点击“添加 API”,填入第三方 Apple CMS 接口,例如:
1 | https://example.com/api.php/provide/vod |
部分接口还需要填写详情页根地址。保存后执行源测试,再回到首页搜索影片。LibreTV 会并行请求已启用的数据源,并将同名内容合并显示。
四、预置数据源(可选)
可以在 Compose 中增加 DEFAULT_SOURCES,让首次访问时自动加载数据源:
1 | environment: |
也可以使用 DEFAULT_SUBSCRIPTIONS 预置远程订阅,或使用 DEFAULT_LIVE_SOURCES 预置 M3U 直播源。具体格式见官方配置文档和数据源文档。
修改配置后执行:
1 | docker compose up -d |
五、配置域名和 HTTPS
公网使用时建议通过 Nginx、Caddy 或 Cloudflare 反向代理提供 HTTPS,不要长期直接暴露 8080 端口。Caddy 示例:
1 | tv.example.com { |
将域名解析到服务器。HTTPS 很重要,因为登录密码会通过请求提交,公网 HTTP 可能被中间人窃取。
六、更新和备份
1 | cd /opt/libretv |
观看记录和配置主要保存在浏览器本地。升级前进入“设置 → 数据 → 配置导入导出”,保存导出的 JSON 文件。
七、常见检查命令
1 | docker compose logs --tail=100 libretv |
如果页面打不开,依次检查容器状态、8080 端口、防火墙、域名解析和反向代理配置。数据源搜索失败时,先在“源管理”中测试接口是否仍可访问。
本项目不存储、不制作视频内容,仅提供第三方公开接口的聚合和播放能力。请自行确认数据源及播放内容符合当地法律法规,并尊重版权。