本文最后更新于 2025-10-17,文章内容可能已经过时。

📺 项目简介

LibreTV 是一个轻量级、免费的在线视频搜索与观看平台,提供来自多个视频源的内容搜索与播放服务。无需注册,即开即用,支持多种设备访问。项目结合了前端技术和后端代理功能,可部署在支持服务端功能的各类网站托管服务上。项目门户libretv.is-an.org

功能特点

  • 无注册即用:无须登录,用户可以快速开始。

  • 设备兼容:支持多种设备和浏览器访问。

  • 开源与自托管:平台源代码完全开源,用户可以根据需要自行部署。

  • 多源聚合:结合前端和后端技术实现多个内容源的统一访问。

准备工作

  1. 设备与环境

  • 飞牛 NAS(支持 Docker 容器功能)

  • Docker Compose 基础知识(飞牛 NAS 支持容器部署)

  1. 获取部署文件 从 GitHub 项目主页下载 docker-compose.yml 文件,或直接使用以下内容:

services:
  libretv:
    image: bestzwei/libretv:latest
    container_name: libretv
    ports:
      - "8899:8080"
    environment:
      - PASSWORD=your_password
      - ADMINPASSWORD=your_adminpassword
    restart: unless-stopped
  • 内部 8080 端口映射到主机的 8899 端口。8899 可以根据自己需求修改为未占用的端口。

  • your_password 修改为你想要的密码,默认为 your_password

  • your_adminpassword 修改为你想要的密码,默认为 your_adminpassword

部署步骤

  1. 打开 Docker 应用,选择 Compose新增项目

  2. 按照下面截图填入内容,密码按需修改。检查内容没问题,点击 确定 按钮进行部署。

在容器中查看状态,等待部署完成,。

使用

  1. 浏览器输入NAS_IP:8899即可访问使用。密码上文设置的 artisan1234,输入进去提交即可。

  2. 弹出来一个声明,可以阅读了解下,然后点击 我已了解并接受 按钮后正式进入主界面。

  3. 点击页面右上角的设置,可以设置数据源、自定义API、过滤不健康内容、广告过滤、开启豆瓣热门推荐等!

  4. 如果开启了豆瓣热门推荐,会得到的首页如下图所示。

  5. 左侧可以查看历史观看记录,当然也有清空历史记录功能。

  6. 随便搜索一部动漫看看。

非常流畅播放,而且流量是不经过 NAS 端。

注意事项

API兼容性

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 源

  1. 在设置面板中选择"自定义接口"

  2. 接口地址: https://example.com/api.php/provide/vod

⌨️ 键盘快捷键

播放器支持以下键盘快捷键:

  • 空格键: 播放/暂停

  • 左右箭头: 快退/快进

  • 上下箭头: 音量增加/减小

  • M 键: 静音/取消静音

  • F 键: 全屏/退出全屏

  • Esc 键: 退出全屏