项目简介
LibreTV是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目采用纯前端技术构建，可轻松部署在各类静态网站托管服务上。
本项目基于 https://github.com/bestK/tv
演示站：(请自行部署，不再提供演示站)
感谢 NodeSupport 友情赞助
✨ 主要特性
- 🔍 多源视频搜索功能，覆盖电影、电视剧等内容
- 📱 响应式设计，完美支持电脑、平板和手机
- 🌐 聚合多个视频源，自动提取播放链接
- 🔄 支持自定义API接口，灵活扩展
- 💾 本地存储搜索历史，提升使用体验
- 🚀 纯静态部署，无需后端服务器
- 🛡️ 内置广告过滤功能，提供更干净的观影体验
- 🎬 自定义视频播放器，支持HLS流媒体格式
- ⌨️ 键盘快捷键支持，提高观影体验
⌨️ 键盘快捷键
LibreTV播放器支持以下键盘快捷键：
- Alt + 左箭头：播放上一集
- Alt + 右箭头：播放下一集
- 空格键：暂停/播放
- 左/右箭头：快退/快进5秒
- 上/下箭头：调整音量
- F：全屏/退出全屏
CMS采集站源兼容性
本项目支持标准的苹果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
重要提示: 像 https://360zy.com/api.php/provide/vod 这样的CMS源需要按照以下格式添加：
- 在设置面板中选择"自定义接口"
- 接口地址只填写到域名部分:
https://360zy.com（不要包含 /api.php/provide/vod部分）
- 项目会自动补全正确的路径格式
如果CMS接口非标准格式，可能需要修改项目中的 config.js文件中的 API_CONFIG.search.path和 API_CONFIG.detail.path配置。
🛠️ 技术栈
- HTML5 + CSS3 + JavaScript (ES6+)
- Tailwind CSS (通过CDN引入)
- HLS.js 用于HLS流处理和广告过滤
- DPlayer 视频播放器核心
- 前端API请求拦截技术
- localStorage本地存储
🚀 部署指南
Cloudflare Pages部署
- Fork或克隆本仓库到你的GitHub账户
- 登录Cloudflare Dashboard，进入Pages服务
- 点击"创建项目"，连接GitHub仓库
- 使用以下设置：
- 构建命令：留空（无需构建）
- 输出目录：留空（默认为根目录）
- 部署命令：留空
- 点击"保存并部署"
Vercel/Netlify部署
类似Cloudflare Pages，只需连接仓库并部署即可，无需特殊配置。
本地测试
如果你想在本地测试，可以使用任何静态文件服务器：
# 使用Python
python -m http.server 8080
# 或使用Node.js的http-server
npx http-server -p 8080
Docker 部署
docker pull bestzwei/libretv:latest
docker run -d --name libretv -p 8899:80 bestzwei/libretv:latest
访问 http://localhost:8899 查看效果。
Docker Compose 部署
你也可以通过 Docker Compose 部署本项目。新建一个名为 docker-compose.yaml 的文件，内容如下：
version: '3'
services:
libretv:
image: bestzwei/libretv:latest
container_name: libretv
ports:
- "8899:80"
restart: unless-stopped
🔧 自定义配置
项目主要配置在 js/config.js文件中，你可以修改以下内容：
PROXY_URL: 修改为你自己的代理服务地址API_SITES: 添加或修改视频源API接口SITE_CONFIG: 更改站点名称、描述等基本信息PLAYER_CONFIG: 调整播放器参数，如自动播放、广告过滤等HIDE_BUILTIN_**_APIS: 用于控制是否隐藏内置的**采集站API，默认值为 true。设置为 true时，内置的某些敏感API将不会在设置面板中显示，可根据实际需要修改配置。
注意：若使用docker部署，可进入容器，在 /usr/share/nginx/html/js内修改相关配置
⚠️ 免责声明
LibreTV 仅作为视频搜索工具，不存储、上传或分发任何视频内容。所有视频均来自第三方API接口提供的搜索结果。如有侵权内容，请联系相应的内容提供方。
🔄 更新日志
- 1.0.0 (2025-04-06): 初始版本发布
- 1.0.1 (2025-04-07): 添加广告过滤功能，优化播放器性能
- 1.0.2 (2025-04-08): 分离了播放页面，优化视频源API兼容性
- 1.0.3 (2025-04-13): 性能优化、ui优化、更新设置功能
2025-4-16 16:50:49
2025-4-17 20:51:36 楼主
