LibreTV - 免费在线视频搜索与观看平台 搭建教程

LibreTV 是一个基于 Next.js 的在线视频聚合搜索与观看平台,支持多源搜索、HLS 播放、观看进度、直播/IPTV、PWA 和亮暗主题。它只负责聚合和播放用户配置的第三方公开数据源,不自带影视内容。

本文以 LibreSpark/LibreTV 官方仓库当前版本为例,介绍使用 Docker Compose 部署的方法。

项目地址:LibreSpark/LibreTV

官方文档:libretv.is-an.org/wiki

一、准备服务器

建议使用 Debian 11/12、Ubuntu 22.04/24.04 等 Linux 系统,并准备 Docker、Docker Compose Plugin、一个域名、至少一个合法稳定的 Apple CMS 点播接口和一个自定义访问密码。

检查 Docker:

1
2
docker --version
docker compose version

二、使用 Docker Compose 部署

1
2
mkdir -p /opt/libretv
cd /opt/libretv

创建 docker-compose.yml:

1
2
3
4
5
6
7
8
9
services:
libretv:
image: ghcr.io/librespark/libretv:latest
container_name: libretv
restart: unless-stopped
ports:
- "8080:8080"
environment:
PASSWORD: "请替换为一个强密码"

替换密码后启动:

1
2
3
docker compose pull
docker compose up -d
docker compose ps

如果服务器防火墙允许 8080 端口,访问 http://服务器IP:8080 即可。登录密码就是 PASSWORD 的值。

三、添加视频数据源

登录后进入“设置 → 源管理 → 点播源”,点击“添加 API”,填入第三方 Apple CMS 接口,例如:

1
https://example.com/api.php/provide/vod

部分接口还需要填写详情页根地址。保存后执行源测试,再回到首页搜索影片。LibreTV 会并行请求已启用的数据源,并将同名内容合并显示。

四、预置数据源(可选)

可以在 Compose 中增加 DEFAULT_SOURCES,让首次访问时自动加载数据源:

1
2
3
4
environment:
PASSWORD: "请替换为一个强密码"
DEFAULT_SOURCES: >-
[{"name":"示例源","url":"https://example.com/api.php/provide/vod"}]

也可以使用 DEFAULT_SUBSCRIPTIONS 预置远程订阅,或使用 DEFAULT_LIVE_SOURCES 预置 M3U 直播源。具体格式见官方配置文档和数据源文档。

修改配置后执行:

1
docker compose up -d

五、配置域名和 HTTPS

公网使用时建议通过 Nginx、Caddy 或 Cloudflare 反向代理提供 HTTPS,不要长期直接暴露 8080 端口。Caddy 示例:

1
2
3
tv.example.com {
reverse_proxy 127.0.0.1:8080
}

将域名解析到服务器。HTTPS 很重要,因为登录密码会通过请求提交,公网 HTTP 可能被中间人窃取。

六、更新和备份

1
2
3
4
cd /opt/libretv
docker compose pull
docker compose up -d
docker image prune

观看记录和配置主要保存在浏览器本地。升级前进入“设置 → 数据 → 配置导入导出”,保存导出的 JSON 文件。

七、常见检查命令

1
2
docker compose logs --tail=100 libretv
curl http://127.0.0.1:8080/api/status

如果页面打不开,依次检查容器状态、8080 端口、防火墙、域名解析和反向代理配置。数据源搜索失败时,先在“源管理”中测试接口是否仍可访问。

本项目不存储、不制作视频内容,仅提供第三方公开接口的聚合和播放能力。请自行确认数据源及播放内容符合当地法律法规,并尊重版权。

  • 版权声明: 本博客所有文章除特别声明外,著作权归作者所有。转载请注明出处!
  • Copyrights © 2015-2026 Kekeguai
  • 运行时间: 计算中