LibreTV 是一个开源的在线视频搜索与聚合平台，旨在为用户提供简洁、高效的影视资源检索体验。该项目采用无服务器（Serverless）架构，完全托管于 Cloudflare Pages 之上，无需任何后端服务器支撑，真正实现了“即开即用、零运维成本”的轻量化部署。

核心技术特性

  • 完全无服务器化：依托 Cloudflare 全球边缘网络，无需购买 VPS 或配置复杂的环境，有效规避带宽与运维成本。
  • 多源数据集成：内置多接口 API 支持，可灵活聚合不同影视站点的资源库。
  • 跨平台兼容：基于现代 Web 技术栈构建，完美适配手机、平板、桌面端及智能电视浏览器。
  • 部署简易：通过 GitHub 与 Cloudflare Pages 深度集成，实现自动化构建与快速上线。
  • 隐私与安全：支持通过环境变量设置访问权限（密码保护），满足个性化的私人观影需求。

部署与初始化指南

第一步：创建项目存储库

  1. 前往 LibreTV GitHub 仓库（或对应的克隆版本）。
  2. 点击 Fork 将项目代码仓库保存至您的 GitHub 账户下。

第二步：部署至 Cloudflare Pages

  1. 登录 Cloudflare Dashboard，进入 Workers 和 Pages 选项卡。
  2. 选择 创建项目 -> 连接到 Git，并授权 Cloudflare 访问您的 GitHub 仓库。
  3. 在构建设置中保持默认配置：
    • 构建命令：留空
    • 输出目录：留空
  4. 点击 保存并部署，等待系统完成自动化构建。

第三步：配置环境变量

为了保障访问安全，建议您设置访问密码：

  1. 在项目部署完成后，进入 Cloudflare 项目的 设置 -> 环境变量。
  2. 添加以下变量：
    • PASSWORD：自定义登录密码（必填）。
    • ADMINPASSWORD：自定义管理员密码（可选，用于后台管理）。
  3. 保存更改并重新部署，使设置生效。

影视源配置

LibreTV 依赖于第三方影视采集接口。部署完成后，您需要在前端管理界面配置以下主流影视源以激活内容：

影视源名称接口地址 (参考)
饭团影视https://www.fantuan.tv/api.php/provide/vod/
影视工厂https://cj.lziapi.com/api.php/provide/vod/
七七资源https://www.qiqidys.com/api.php/provide/vod/

提示：接口地址可能随服务商变动，请确保填入的是标准的 api.php/provide/vod/ 格式链接，以确保解析正常。

实用建议

  • 稳定性考量：LibreTV 作为聚合平台，其内容的加载速度与稳定性很大程度上取决于所对接影视接口的响应质量，建议优先选择存活率高、响应速度快的采集源。
  • 个性化定制：由于该项目开源，您可以根据个人需求修改 index.html 或相关 CSS，调整页面 UI 以匹配您的个性化审美。

关于 LibreTV 的部署，如果在配置影视采集接口时遇到连接超时问题，通常是由于源站屏蔽了 Cloudflare 节点的 IP 或跨域限制（CORS）导致，建议检查您所选接口的访问权限设置。