1分钟搭个影视站 —— LibreTV

MoonTV 因 DMCA 投诉下架后，这个赛道的分支就没停过，但大部分都只是改改皮。最近把 LibreTV 拉出来跑了一圈，发现它是这批项目里最省心的一个：GitHub 上 21.8k star，fork 数比 star 还多，前几天还在更新。本文就以飞牛 NAS + Docker 的方式写一篇部署教程。

1. 详细介绍

🤔 LibreTV 是什么？

🎬 LibreTV 是一个免费开源的视频聚合搜索与播放平台，基于 Next.js 15 构建，播放内核为 ArtPlayer + hls.js。不下载、不入库、不占硬盘，部署好就是一个搜索即播的影视站，浏览器打开就能用。

✨ 特点

• 🔍 多源聚合搜索：多个资源站点并行搜索，同名影片合并为一张卡片，展开即可比较各来源

• 🎬 播放体验：广告分片过滤、跳过片头片尾、自动连播、倍速、移动端长按 3 倍速

• 🔁 换源测速：卡了就跨源搜同名资源、测速排序，一键切换还保留集数位置

• 📺 直播 / IPTV：填 M3U 地址就能在网页里看直播频道，支持节目单（EPG）

• 📱 PWA：可以像 App 一样装到手机桌面，亮暗双主题

• 🚀 多平台部署：支持 Docker、Node 直接运行，x86 / ARM 双架构镜像通吃

2. 安装指南

下面介绍飞牛 NAS 通过 Docker 进行部署，其它部署方式请参考官方说明文档。

docker-compose.yml 文件：

services: libretv: image: ghcr.io/librespark/libretv:latest container_name: libretv restart: unless-stopped ports: - "8080:8080" # 端口映射（左为访问端口，可自行修改） environment: - PASSWORD=改成你自己的密码 # 必填：访问密码，务必修改

1. 在飞牛主页面找到 Docker 打开后，切换菜单 Compose -> 新增项目。

2. 创建项目页面根据实际情况定义 项目名称、选择 路径，并把上面 docker-compose.yml 文件内容复制填入 来源 文本框。检查无误后点击 确定 按钮进行部署。

3. 返回 Docker 管理页面，在 容器 菜单，就可以看到 libretv 的运行情况，点击右侧 🔗 可以直接打开。

3. 使用

首次配置

浏览器地址输入：http://:8080，输入部署时设置的 PASSWORD 登录。

1. 添加点播源：设置 → 源管理 → 点播源 → 添加 API，填入采集站接口地址（形如 https://example.com/api.php/provide/vod，源自行准备），可选填详情页地址

2. 搜索：勾选源后输入片名，搜索由服务端聚合，个别源失败不影响整体结果

3. 播放：结果里点开影片 → 选集 → 直接播

日常使用

• 追剧：播放页快捷键 Shift+I 标片头结束、Shift+O 标片尾开始，之后同剧各集自动跳过。播放记录存在本机浏览器里，精确到秒续播

• 看直播：设置 → 源管理 → 直播源 填入 M3U 地址，频道自动探活分组，进入 直播 页点开即看

• 首页推荐：设置 里可切换豆瓣分类、Bangumi 新番、影视热榜三种数据源

• 配置备份：设置 → 数据 支持配置导入导出，换设备不用重新配

【截图位：播放页 / 直播频道列表】

如果需要更多使用说明和部署优化请参考 LibreTV Github：https://github.com/LibreSpark/LibreTV

4. 注意事项

• PASSWORD 务必修改：不设置站点会一直提示；公网部署时这是唯一的门

• 公网使用建议套 HTTPS：登录密码在 HTTP 下是明文传输，可用 Lucky 反向代理终结 TLS；局域网自用无需在意

• 登录有限速：10 次 / 10 分钟，密码输错别狂点，等十分钟再试

• 源挂了不用慌：搜索时自动记录各源健康度，连续失败的源会按 30 分钟 → 24 小时 → 长期阶梯自动停用，面板里可一键恢复

重要声明

• 本项目仅供学习和个人使用

• LibreTV 本身不存储、不制作任何内容，仅提供第三方公开接口的聚合与播放能力，内容的合法性由数据源负责

• 请勿将部署的实例用于商业用途或公开服务

• 如因公开分享导致的任何法律问题，用户需自行承担责任

以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧，如果想第一时间收到推送，也可以给我个星标⭐～ 谢谢你看我的文章，我们，下次再见。

作者提示含AI生成内容。作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～