1.项目
LibreTV 是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目结合了前端技术和后端代理功能，可部署在支持服务端功能的各类网站托管服务上。
1.1项目介绍
主要特点
- 多源聚合搜索
- 整合多个影视资源站点，支持电影、电视剧等内容的一键搜索，自动提取最佳播放链接。
- 内置广告过滤功能，提供更干净的观影体验。
- 无需注册 & 跨平台支持
- 即开即用，无需登录或订阅会员。
- 响应式设计，适配 PC、手机、平板等设备。
- 自定义扩展
- 支持添加自定义 API 接口，可扩展更多视频源。
- 本地存储搜索历史，方便回溯观看记录。
- 多种部署方式
- 支持 Cloudflare Pages、Vercel、Netlify 等静态托管平台一键部署。
- 提供 Docker 镜像，可快速在 NAS（如绿联、威联通）或本地服务器运行。
1.2项目展示
2.相关地址
gitHub开源项目：https://github.com/LibreSpark/LibreTV
3.搭建环境
- 服务器：这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接：https://www.lcayun.com
- 资源配置：2核2G 30G硬盘
由于国内服务器访问海外源较慢，这边为了方便演示直接使用海外服务器搭建。(最好是使用国内服务器搭建) - 服务器系统：Debian-12
- 【必需】安装Docker：安装好 Docker、Docker-compose
- 【非必需】域名一枚，可用于解析到服务器上使用域名访问
4.搭建视频
哔哩哔哩：https://www.bilibili.com/video/BV18TuVztEnG/
5.搭建方式
5.1 安装docker和docker-compose
安装教程：服务器上安装docker和docker-compose教程
5.2 创建LibreTV的docker文件
#在opt目录下创建LibreTV文件夹
mkdir /opt/LibreTV#打开LibreTV文件
cd /opt/LibreTV#编辑docker-compose.yml文件
vi docker-compose.yml5.3 安装LibreTV镜像
services:
libretv:
image: bestzwei/libretv:latest
container_name: libretv
ports:
- "8899:8080" # 将内部 8080 端口映射到主机的 8899 端口
environment:
- PASSWORD=${PASSWORD:-your_password} # 可将 your_password 修改为你想要的密码，默认为 your_password
- ADMINPASSWORD=${PASSWORD:-your_adminpassword} # 可将 your_adminpassword 修改为你想要的密码，默认为 your_adminpassword
restart: unless-stopped填完按esc键 输入 :wq 保存退出
5.4 运行LibreTV的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d访问IP:8899端口就可以有界面出现了。
默认为 your_password
🔧 自定义配置
密码保护
要为您的 LibreTV 实例添加密码保护，可以在部署平台上设置环境变量：
环境变量名: PASSWORD 值: 您想设置的密码
环境变量名: ADMINPASSWORD 值: 您想设置的密码
各平台设置方法：
- Cloudflare Pages: Dashboard > 您的项目 > 设置 > 环境变量
- Vercel: Dashboard > 您的项目 > Settings > Environment Variables
- Netlify: Dashboard > 您的项目 > Site settings > Build & deploy > Environment
- Docker: 修改
docker run中your_password为你的密码 - Docker Compose: 修改
docker-compose.yml中的your_password为你的密码 - 本地开发: SET PASSWORD=your_password
API兼容性
LibreTV 支持标准的苹果 CMS V10 API 格式。添加自定义 API 时需遵循以下格式：
- 搜索接口:
https://example.com/api.php/provide/vod/?ac=videolist&wd=关键词 - 详情接口:
https://example.com/api.php/provide/vod/?ac=detail&ids=视频ID
添加 CMS 源:
- 在设置面板中选择”自定义接口”
- 接口地址:
https://example.com/api.php/provide/vod
⌨️ 键盘快捷键
播放器支持以下键盘快捷键：
- 空格键: 播放/暂停
- 左右箭头: 快退/快进
- 上下箭头: 音量增加/减小
- M 键: 静音/取消静音
- F 键: 全屏/退出全屏
- Esc 键: 退出全屏
🛠️ 技术栈
- HTML5 + CSS3 + JavaScript (ES6+)
- Tailwind CSS
- HLS.js 用于 HLS 流处理
- DPlayer 视频播放器核心
- Cloudflare/Vercel/Netlify Serverless Functions
- 服务端 HLS 代理和处理技术
- localStorage 本地存储
6.结尾
至此我们的项目搭建就结束了，具体更多使用方法可以访问LibreTV的官方平台，真正实现无广告看视频。
