LibreTV - 免费在线视频搜索与观看平台

📺 项目简介

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源需要按照以下格式添加：

1. 在设置面板中选择"自定义接口"
2. 接口地址只填写到域名部分: https://360zy.com（不要包含/api.php/provide/vod部分）
3. 项目会自动补全正确的路径格式

如果CMS接口非标准格式，可能需要修改项目中的config.js文件中的API_CONFIG.search.path和API_CONFIG.detail.path配置。

🛠️ 技术栈

• HTML5 + CSS3 + JavaScript (ES6+)
• Tailwind CSS (通过CDN引入)
• HLS.js 用于HLS流处理和广告过滤
• DPlayer 视频播放器核心
• Cloudflare/Vercel/Netlify Serverless Functions
• 服务端HLS代理和处理技术
• 前端API请求拦截技术
• localStorage本地存储

🚀 一键部署

🚀 部署指南

Cloudflare Pages部署

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

Vercel/Netlify部署

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

本地测试

项目现在包含后端代理功能，需要支持服务器端功能的环境：

# 使用 Node.js 启动（推荐）
# 先安装依赖
npm install
# 启动开发服务器
npm run dev

# 如果仍想使用简单的静态服务器测试前端部分
# 注意：视频代理功能将不可用，会导致视频无法播放
python -m http.server 8080
# 或
npx http-server -p 8080

⚠️ 注意：使用简单静态服务器时，视频代理功能将不可用，视频播放功能会受到影响。完整功能测试请使用 Vercel CLI 或正确配置的开发服务器。

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

🔧 自定义配置

密码保护功能

LibreTV 现在支持密码保护功能，可以通过环境变量设置访问密码。当设置了 PASSWORD 环境变量后，用户首次访问网站时需要输入密码才能继续使用。

• 如果 PASSWORD 环境变量为空或未设置，将不启用密码保护。
• 密码验证状态会保存在浏览器本地存储中，有效期默认为三个月。

不同部署平台设置密码的方法：

Cloudflare Pages

1. 进入 Cloudflare Dashboard > Pages > 你的项目
2. 点击"设置" > "环境变量"
3. 添加新的变量:
   • 变量名: PASSWORD
   • 值: 你想设置的密码
4. 选择应用于"生产环境"或同时包括"预览环境"
5. 保存并重新部署项目

Vercel

1. 进入 Vercel Dashboard > 你的项目
2. 点击"设置" > "环境变量"
3. 添加新的环境变量:
   • 名称: PASSWORD
   • 值: 你想设置的密码
4. 选择作用范围(生产/预览/开发环境)
5. 点击"保存"并重新部署项目

Docker/Docker Compose

使用 Docker 运行时，可以通过环境变量传递密码:

# 使用 Docker 命令
docker run -d --name libretv -p 8899:80 -e PASSWORD=your_password_here bestzwei/libretv:latest

使用 Docker Compose，在 docker-compose.yml 文件中设置:

version: '3'
services:
  libretv:
    image: bestzwei/libretv:latest
    container_name: libretv
    ports:
      - "8899:80"
    environment:
      - PASSWORD=your_password_here  # 留空则不启用密码保护
    restart: unless-stopped

本地测试环境

对于本地测试，你可以在启动服务器之前设置环境变量:

# Linux/MacOS
export PASSWORD=your_password_here
python -m http.server 8080

# Windows
set PASSWORD=your_password_here
python -m http.server 8080

Star History

⚠️ 免责声明

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优化、更新设置功能
• 1.1.0 (2025-04-17): 添加服务端代理功能，支持HLS流处理和解析，支持环境变量设置访问密码