一、项目简介

LibreTV是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目采用纯前端技术构建，可轻松部署在各类静态网站托管服务上。

本项目基于 https://github.com/bestK/tv

演示站：https://libretv.is-an.org/

二、主要特性

🔍 多源视频搜索功能，覆盖电影、电视剧等内容 📱 响应式设计，完美支持电脑、平板和手机 🌐 聚合多个视频源，自动提取播放链接 🔄 支持自定义API接口，灵活扩展 💾 本地存储搜索历史，提升使用体验 🚀 纯静态部署，无需后端服务器 🛡️ 内置广告过滤功能，提供更干净的观影体验 🎬 自定义视频播放器，支持HLS流媒体格式 ⌨️ 键盘快捷键支持，提高观影体验

三、⌨️ 键盘快捷键

LibreTV播放器支持以下键盘快捷键：

Alt + 左箭头：播放上一集 Alt + 右箭头：播放下一集 空格键：暂停/播放 左/右箭头：快退/快进5秒 上/下箭头：调整音量 F：全屏/退出全屏

四、📹 视频源支持说明

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本地存储

七、部署指南

1、Cloudflare Pages部署

Fork或克隆本仓库到你的GitHub账户 登录Cloudflare Dashboard，进入Pages服务 点击"创建项目"，连接GitHub仓库 使用以下设置： 构建命令：留空（无需构建） 输出目录：留空（默认为根目录） 部署命令：留空 点击"保存并部署"

2、Vercel/Netlify部署

类似Cloudflare Pages，只需连接仓库并部署即可，无需特殊配置。

3、 本地测试

如果你想在本地测试，可以使用任何静态文件服务器：

# 使用Python
python -m http.server 8080

# 或使用Node.js的http-server
npx http-server -p 8080

4、Docker 部署

docker pull bestzwei/libretv:latest
docker run -d --name libretv -p 8899:80 bestzwei/libretv:latest

访问 http://localhost:8899 查看效果。

5、Docker Compose 部署

你也可以通过 Docker Compose 部署本项目。新建一个名为 docker-compose.yaml 的文件，内容如下：

version: '3'
services:
  libretv:
    image: bestzwei/libretv:latest
    container_name: libretv
    ports:
      - "8899:80"
    restart: unless-stopped

6、🔧 自定义配置

项目主要配置在js/config.js文件中，你可以修改以下内容：

PROXY_URL: 修改为你自己的代理服务地址 API_SITES: 添加或修改视频源API接口 SITE_CONFIG: 更改站点名称、描述等基本信息 PLAYER_CONFIG: 调整播放器参数，如自动播放、广告过滤等 注意：若使用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优化、更新设置功能

十、🌟 项目结构

LibreTV/
├── css/
│   └── styles.css       // 自定义样式
├── js/
│   ├── app.js           // 主应用逻辑
│   ├── api.js           // API请求处理
│   ├── config.js        // 全局配置
│   └── ui.js            // UI交互处理
├── player.html          // 自定义视频播放器
├── index.html           // 主页面
├── robots.txt           // 搜索引擎爬虫配置
└── sitemap.xml          // 站点地图