自由观影，畅享精彩
LibreTV 是一个轻量级、免费的在线视频搜索与观看平台，提供来自多个视频源的内容搜索与播放服务。无需注册，即开即用，支持多种设备访问。项目结合了前端技术和后端代理功能，可部署在支持服务端功能的各类网站托管服务上。项目门户： libretv.is-an.org
本项目基于 bestK/tv 进行重构与增强。
点击查看项目截图
选择以下任一平台，点击一键部署按钮，即可快速创建自己的 LibreTV 实例：
为了您的安全和避免潜在的法律风险，我们强烈建议在部署时设置密码保护：
- 避免公开访问：不设置密码的实例任何人都可以访问，可能被恶意利用
- 防范版权风险：公开的视频搜索服务可能面临版权方的投诉举报
- 保护个人隐私：设置密码可以限制访问范围，保护您的使用记录
- 设置环境变量
PASSWORD：为您的实例设置一个强密码 - 仅供个人使用：请勿将您的实例链接公开分享或传播
- 遵守当地法律：请确保您的使用行为符合当地法律法规
- 本项目仅供学习和个人使用
- 请勿将部署的实例用于商业用途或公开服务
- 如因公开分享导致的任何法律问题，用户需自行承担责任
- 项目开发者不对用户的使用行为承担任何法律责任
Pull Bot 会反复触发无效的 PR 和垃圾邮件，严重干扰项目维护。作者可能会直接拉黑所有 Pull Bot 自动发起的同步请求的仓库所有者。
推荐做法：
建议在 fork 的仓库中启用本仓库自带的 GitHub Actions 自动同步功能（见 .github/workflows/sync.yml）。
如需手动同步主仓库更新，也可以使用 GitHub 官方的 Sync fork 功能。
- Fork 或克隆本仓库到您的 GitHub 账户
- 登录 Cloudflare Dashboard，进入 Pages 服务
- 点击"创建项目"，连接您的 GitHub 仓库
- 使用以下设置：
- 构建命令：留空（无需构建）
- 输出目录：留空（默认为根目录）
⚠️ 重要：在"设置" > "环境变量"中添加PASSWORD变量- 可选：在"Settings" > "Environment Variables"中添加
ADMINPASSWORD变量 - 点击"保存并部署"
- Fork 或克隆本仓库到您的 GitHub/GitLab 账户
- 登录 Vercel，点击"New Project"
- 导入您的仓库，使用默认设置
⚠️ 重要：在"Settings" > "Environment Variables"中添加PASSWORD变量- 可选：在"Settings" > "Environment Variables"中添加
ADMINPASSWORD变量 - 点击"Deploy"
- 可选：在"Settings" > "Environment Variables"中配置密码保护和设置按钮密码保护
- Fork 或克隆本仓库到您的 GitHub 账户
- 登录 Render，点击 "New Web Service"
- 选择您的仓库，Render 会自动检测到
render.yaml配置文件 - 保持默认设置（无需设置环境变量，默认不启用密码保护）
- 点击 "Create Web Service"，等待部署完成
- 部署成功后即可访问您的 LibreTV 实例
如需启用密码保护，可在 Render 控制台的环境变量中手动添加
PASSWORD和/或ADMINPASSWORD。
docker run -d \
--name libretv \
--restart unless-stopped \
-p 8899:8080 \
-e PASSWORD=your_password \
-e ADMINPASSWORD=your_adminpassword \
bestzwei/libretv:latest
docker-compose.yml 文件：
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启动 LibreTV：
docker compose up -d访问 http://localhost:8899 即可使用。
项目包含后端代理功能，需要支持服务器端功能的环境：
# 首先，通过复制示例来设置 .env 文件（可选）
cp .env.example .env
# 安装依赖
npm install
# 启动开发服务器
npm run dev访问 http://localhost:8080 即可使用（端口可在.env文件中通过PORT变量修改）。
⚠️ 注意：使用简单静态服务器（如python -m http.server或npx http-server）时，视频代理功能将不可用，视频无法正常播放。完整功能测试请使用 Node.js 开发服务器。
要为您的 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
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 本地存储
LibreTV 仅作为视频搜索工具，不存储、上传或分发任何视频内容。所有视频均来自第三方 API 接口提供的搜索结果。如有侵权内容，请联系相应的内容提供方。
本项目开发者不对使用本项目产生的任何后果负责。使用本项目时，您必须遵守当地的法律法规。
活跃贡献者可以在 Issue #268 中留言，申请免费上车 1Password Team，享受团队协作工具的便利！
如果您想支持本项目，可以考虑进行捐款：
