在当今流媒体服务盛行的时代,拥有一个完全自主控制的影视平台变得越来越有价值。Libre TV 正是一款满足这一需求的优秀开源项目,它让用户能够轻松搭建属于自己的影视平台。
项目概览
Libre TV 是一个基于苹果 CMS V10 API 标准的开源影视平台解决方案,项目托管在 GitHub 上,采用 MIT 许可证,完全免费且开放源代码。这个项目的最大特点是提供了极高的部署灵活性,让用户可以根据自己的需求选择最适合的部署方式。
核心特性
Libre TV 最引人注目的特性是其出色的兼容性和部署灵活性。它不仅支持传统的 Docker 容器化部署,还能够无缝运行在 Vercel、Netlify 和 Cloudflare 等现代云平台上。这种多平台支持意味着无论你是个人开发者还是企业用户,都能找到适合自己技术栈的部署方案。
作为基于苹果 CMS V10 API 标准的实现,Libre TV 天然兼容市面上大多数主流资源站。这意味着你可以轻松接入丰富的影视资源,而无需担心兼容性问题。项目开发者特别注重 API 标准的遵循,确保了与其他系统的良好互操作性。
部署选项详解
对于技术爱好者来说,Libre TV 提供了多种部署途径。Docker 部署是最为推荐的方式,它简单快捷且隔离性好,适合大多数用户。只需几条命令就能完成整个系统的搭建,大大降低了技术门槛。
如果你更倾向于 Serverless 架构,Vercel 和 Netlify 的部署选项将是不错的选择。这些方案特别适合希望快速上线且不想管理服务器的用户。而 Cloudflare 部署则提供了额外的安全性和全球加速能力,适合对性能有更高要求的场景。
技术优势
Libre TV 的设计哲学强调简洁和高效。项目采用现代化的技术栈开发,确保了良好的性能和可维护性。开源特性意味着你可以完全掌控自己的数据,不必担心隐私问题或服务突然中断的风险。
对于开发者而言,项目的开源特性也提供了极大的定制空间。你可以根据自己的需求修改前端界面,添加新功能,或者优化现有逻辑。这种自由度是商业流媒体平台无法提供的。
适用场景
Libre TV 特别适合以下场景:个人媒体中心搭建、小型企业内部分享平台、教育机构资源分发等。它的轻量级特性使得即使在资源有限的设备上也能流畅运行,而丰富的部署选项则确保了各种环境下的可用性。
无论你是想搭建一个私人影视库,还是需要为企业构建内部视频平台,Libre TV 都提供了一个可靠且灵活的解决方案。它的开源本质和多样化的部署方式,让影视平台搭建变得前所未有的简单。
- 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
评论 ( 0 )