原文链接
LibreTV - 免费在线视频搜索与观看平台
📺 项目简介
LibreTV是一个轻量级、免费的在线视频搜索与观看平台,提供来自多个视频源的内容搜索与播放服务。无需注册,即开即用,支持多种设备访问。项目采用纯前端技术构建,可轻松部署在各类静态网站托管服务上。
本项目基于 https://github.com/bestK/tv
演示站:https://libretv.is-an.org/
感谢 NodeSupport 友情赞助
✨ 主要特性
🔍 多源视频搜索功能,覆盖电影、电视剧等内容
📱 响应式设计,完美支持电脑、平板和手机
🌐 聚合多个视频源,自动提取播放链接
🔄 支持自定义API接口,灵活扩展
💾 本地存储搜索历史,提升使用体验
🚀 纯静态部署,无需后端服务器
🛡️ 内置广告过滤功能,提供更干净的观影体验
🎬 自定义视频播放器,支持HLS流媒体格式
📹 视频源支持说明
LibreTV 默认支持以下几种视频源接口:
黑木耳影视 (heimuer)
非凡影视 (ffzy)
天涯资源 (tyyszy)
…
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: 调整播放器参数,如自动播放、广告过滤等
注意:若使用docker部署,可进入容器,在/usr/share/nginx/html/js内修改相关配置
🌟 项目结构
LibreTV/
├── css/
│ └── styles.css // 自定义样式
├── js/
│ ├── app.js // 主应用逻辑
│ ├── api.js // API请求处理
│ ├── config.js // 全局配置
│ └── ui.js // UI交互处理
├── player.html // 自定义视频播放器
├── index.html // 主页面
├── robots.txt // 搜索引擎爬虫配置
└── sitemap.xml // 站点地图
Star History
⚠️ 免责声明
LibreTV 仅作为视频搜索工具,不存储、上传或分发任何视频内容。所有视频均来自第三方API接口提供的搜索结果。如有侵权内容,请联系相应的内容提供方。
🔄 更新日志
1.0.0 (2025-04-06): 初始版本发布
1.0.1 (2025-04-07): 添加广告过滤功能,优化播放器性能
1.0.2 (2025-04-08): 分离了播放页面,优化视频源API兼容性