一分钟搭建影视站,支持Vercel/Docker等部署方式
LibreTV 是一个轻量级、免费的在线视频搜索与观看平台,提供来自多个视频源的内容搜索与播放服务。无需注册,即开即用,支持多种设备访问。项目结合了前端技术和后端代理功能,可部署在支持服务端功能的各类网站托管服务上。项目门户: libretv.is-an.org
本项目基于 bestK/tv 进行重构与增强。
选择以下任一平台,点击一键部署按钮,即可快速创建自己的 LibreTV 实例:
- 本项目仅供学习和个人使用,为避免版权纠纷,必须设置PASSWORD环境变量
- 请勿将部署的实例用于商业用途或公开服务
- 如因公开分享导致的任何法律问题,用户需自行承担责任
- 项目开发者不对用户的使用行为承担任何法律责任
Pull Bot 会反复触发无效的 PR 和垃圾邮件,严重干扰项目维护。作者可能会直接拉黑所有 Pull Bot 自动发起的同步请求的仓库所有者。
推荐做法:
建议在 fork 的仓库中启用本仓库自带的 GitHub Actions 自动同步功能(见 .github/workflows/sync.yml)。
如需手动同步主仓库更新,也可以使用 GitHub 官方的 Sync fork 功能。
对于更新后可能会出现的错误和异常,在设置中备份配置后,首先清除页面Cookie,然后 Ctrl + F5 刷新页面。再次访问网页检查是否解决问题。
- Fork 或克隆本仓库到您的 GitHub 账户
- 登录 Cloudflare Dashboard,进入 Pages 服务
- 点击"创建项目",连接您的 GitHub 仓库
- 使用以下设置:
- 构建命令:留空(无需构建)
- 输出目录:留空(默认为根目录)
- ⚠️ 重要:在"设置" > "环境变量"中添加
PASSWORD变量(必须设置) - 点击"保存并部署"
- Fork 或克隆本仓库到您的 GitHub/GitLab 账户
- 登录 Vercel,点击"New Project"
- 导入您的仓库,使用默认设置
- ⚠️ 重要:在"Settings" > "Environment Variables"中添加
PASSWORD变量(必须设置) - 点击"Deploy"
docker run -d \
--name libretv \
--restart unless-stopped \
-p 8899:8080 \
-e PASSWORD=your_password \
bestzwei/libretv:latest
docker-compose.yml 文件:
services:
libretv:
image: bestzwei/libretv:latest
container_name: libretv
ports:
- "8899:8080" # 将内部 8080 端口映射到主机的 8899 端口
environment:
- PASSWORD=${PASSWORD:-111111} # 可将 111111 修改为你想要的密码,默认为 your_password
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 开发服务器。
重要提示: 为确保安全,所有部署都必须设置 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 接口提供的搜索结果。如有侵权内容,请联系相应的内容提供方。
本项目开发者不对使用本项目产生的任何后果负责。使用本项目时,您必须遵守当地的法律法规。
它们提供了更多丰富的自定义功能,欢迎体验~
🥇 感谢支持
- Sharon
- ZMTO
- YXVM
- from https://github.com/LibreSpark/LibreTV
- -------------------------------------------------------
- 轻量级视频聚合平台-LibreTV
LibreTV 是一款轻量级、开源免费的在线视频搜索与观看平台,提供来自多个视频源的内容搜索与播放服务。通过智能整合多源视频接口,为用户提供即点即播的流畅体验。作为 bestK/tv 项目的重构增强版,其创新性地将前端交互与后端代理技术深度融合,打造出跨平台适配的轻量化解决方案。项目遵守Apache2.0开源协议。
【核心架构】
平台采用模块化设计,前端基于 HTML5+ES6 构建响应式界面,Tailwind CSS 框架确保多终端完美适配。播放核心集成 DPlayer播放器 与 HLS.js 实现流媒体解码,配合 Serverless 架构的云端代理服务,有效突破传统视频聚合平台的跨域限制。
【功能特性】
智能视频源发现:兼容第三方CMS接口,支持自定义API扩展
增强播放控制:空格键启停/方向键微调/F键全屏等快捷键体系
安全防护机制:可选全局密码验证,防范未授权访问
数据合规声明:纯索引技术架构,不存储任何影音内容
项目提供全场景部署方案,支持主流云平台一键发布:
Serverless 部署:通过 Cloudflare Pages/Vercel 实现分钟级上线,构建命令智能优化,支持环境变量加密
容器化方案:Docker 镜像封装完整运行环境,端口映射与密码保护开箱即用
本地开发模式:Node.js 热加载调试,支持端口自定义与实时代理调试
选择以下任一平台,点击一键部署按钮,即可快速创建自己的 LibreTV 实例:
Deploy with Vercel :https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FLibreSpark%2FLibreTV
Deploy to Netlify:https://app.netlify.com/start/deploy?repository=https://github.com/LibreSpark/LibreTV
Deploy to Render:https://render.com/deploy?repo=https://github.com/LibreSpark/LibreTV
源代码:https://github.com/LibreSpark/LibreTV
Demo:libretv.is-an.org

No comments:
Post a Comment