不下载不入库不占硬盘:10分钟搭个影视站
- 2026-11-22 03:35:38
LibreTV,GitHub 上 25,489 star、31,550 fork,最近一次提交是 3 天前。它有个不常见的数字特征:fork 比 star 还多。多数项目是「点个 star 收藏」,它这个是真的被拿去改过、部署过。
这篇写三件事:先判断你该不该装,再把它跑起来,最后说清楚它的边界。不写资源从哪来——项目不内置任何源,那部分你自己准备。
先别急着装:4 个问题
- 你有一台常年开着的 NAS 或服务器吗? 没有,就别装。它不是一个装在电脑上的软件,是一个需要 7×24 跑着的服务。
- 你愿意自己找采集站接口吗? 这是最关键的一条。LibreTV 不内置任何源,也不帮你找。你得自己弄到一个形如 https://example.com/api.php/provide/vod 的地址。找不到,这个站就是个空壳。
- 你主要在手机上看吗? 它支持 PWA,能装到桌面。但如果你只在手机上看,一个现成的 App 比自建省事得多。
- 你要多设备同步观看进度吗? 要,就别装。进度和观看历史只存在当前设备的 IndexedDB 里,不跨设备、不云端同步。
四条里有两条答「否」,关掉这篇,能省你一小时。
01 它是什么
LibreTV 是一个免费开源的视频聚合搜索与播放平台。Next.js 15 + TypeScript + Tailwind CSS 构建,播放内核 ArtPlayer + hls.js。它自己不存任何视频,做的是把多个第三方公开接口收进一个界面里:搜一次,各源并行返回,同名影片合并成一张卡片。
- 多源聚合搜索 · 多个采集站服务端并行搜索,同名影片合并一张卡片,展开即可比较各来源。不用为了找一部剧开五个网站。
- 播放体验 · 广告分片过滤、片头/中段/片尾标记与自动跳过、自动连播、倍速、移动端长按 3 倍速。
- 换源测速 · 卡了就跨源搜同名资源,测速排序,一键切换还保留集数位置。
- 直播 / IPTV · 填 M3U 地址看直播,支持分组、频道搜索、EPG 节目单与收藏。
- 配置迁移 · 设置里导入导出配置,换设备不用重配;源列表可导出为订阅链接分享。
- 多平台部署 · Docker / Node 双方式,amd64 / arm64 镜像,另有不依赖 Docker 的 standalone 包,ARMv7 路由器也能跑。
和同类方案比,它强在哪
原文提了 MoonTV 下架后「一堆改皮的」,但不给对比。这里补上:
| 维度 | LibreTV | 多数 MoonTV 分支 | 现成在线影视站 |
|---|---|---|---|
| 维护状态 | 3 天前更新,25,489 star | 多数停更或只换皮 | 不稳定,随时关站 |
| 进度与隐私 | 存本机 IndexedDB | 各异 | 平台全掌握 |
| 广告 | 分片过滤 + 跳过标记 | 多数支持 | 看站 |
| 折腾成本 | 10 分钟 + 自己找源 | 相当 | 0 |
| 适合谁 | 长期用、有 NAS | 尝鲜 | 偶尔看一部 |
结论很直接:偶尔看,别部署;长期用且家里有常开设备,它值得这 10 分钟。
02 怎么部署
飞牛 NAS + Docker Compose。其它方式看官方文档。
动手前 90 秒检查
- Docker 服务已启动(飞牛 Docker 管理页能打开)
- 8080 端口没被占用(被占就改 ports 左边那个数)
- 采集站接口地址已经准备好
- 如果要公网访问,反代和证书先备好
services:
libretv:
image: ghcr.io/librespark/libretv:latest # 官方镜像,amd64/arm64 双架构
container_name: libretv
restart: unless-stopped
ports:
- "8080:8080" # 左边是访问端口,改完记得放行防火墙
environment:
- PASSWORD=改成你自己的密码 # 必填:别用 admin、123456 这类
# - PROXY_SECRET=your-secret # 多实例部署时建议显式设置
# - DEFAULT_SOURCES=[{"name":"示例源","url":"https://example.com/api.php/provide/vod"}]
- 打开 Compose 新增项目:飞牛主页面 → Docker → Compose → 新增项目。
- 填入配置并部署:定义项目名称、选择路径,把上面的内容复制进「来源」文本框,检查后点确定。
- 确认容器运行:回到 Docker → 容器,看到 libretv 状态为 RUNNING,点右侧链接图标直接打开。
两个容易踩的细节:
· 改了 ports 左边的端口,飞牛防火墙和路由器都要放行,否则「容器正常但打不开」
· 设备是 ARMv7(部分老路由器),别用 Docker 镜像,去 Releases 下 standalone.tar.gz,Node 18+ 直接跑
版本核对:部署后访问 /api/status,返回的 version 字段就是当前版本。
03 怎么用
浏览器打开 http://IP:8080,输入 PASSWORD 登录。
- 添加点播源:设置 → 源管理 → 点播源 → 添加 API,填入采集站接口地址。只有一个源列表接口拿不到播放地址时,才需要在「详情页地址」里再填一个详情页根地址——多数源不用填。
- 搜索:勾选源后输入片名。搜索在服务端聚合,个别源失败不影响结果。
- 播放:结果里点开影片 → 选集 → 直接播。
追剧 · Shift+I 标片头结束、Shift+O 标片尾开始,之后同剧各集和同名资源自动跳过。播放进度存本机,精确到秒续播。
看直播 · 设置 → 源管理 → 直播源填 M3U 地址,频道自动探活分组,直播页点开即看。
找片 · 首页推荐可切换豆瓣分类、Bangumi 新番、影视榜单三种数据源,不用 key。
换设备 · 设置 → 数据 → 配置导入导出。注意导出的只有配置和源,观看历史不会跨设备。
更多用法:https://libretv.is-an.org/wiki/
04 边界与注意事项
先说清楚它不做什么。这几条比功能列表更值得看:
- 不内置任何资源源,也不帮你找源
- 不存储、不制作任何视频内容
- 观看进度只在本机,不跨设备、不云端同步
- 不保证任何一个源长期可用
- 不是离线下载器(播放页能下载单集,但它不是干这个的)
PASSWORD 务必修改 → 不设置站点会一直提示;公网部署时这是唯一的门。对策:改 compose 时就用强密码。
公网使用建议套 HTTPS → 登录密码在 POST body 中明文传输,HTTP 下会被中间人看到。对策:Nginx / Caddy / Traefik 或 Cloudflare 终结 TLS;局域网自用无需在意。
登录有限速 → 10 次 / 10 分钟。对策:输错别狂点,等十分钟。
源挂了不用慌 → 搜索时记录各源健康度,连续失败的源按 30 分钟 → 24 小时 → 长期阶梯自动停用。对策:面板里一键恢复。
排障 FAQ
容器正常但打不开 → 端口没放行,或 ports 左边改过没同步防火墙。
加了源搜不到 → 先确认接口是 Apple CMS 格式(api.php/provide/vod),再用源管理的「测试」探活。
搜到了但播不了 → 源失效或防盗链。用换源测速跨源搜同名资源;列表接口拿不到地址时补填详情页地址。
播放 403 / 画面空白 → 同上,多数是源本身的问题,不是部署问题。
密码正确却登不进 → 反代没传 x-forwarded-proto,设 COOKIE_SECURE=true。
手机长按 3 倍速没反应 → 换系统默认浏览器或 Chrome,部分内置浏览器不触发长按事件。
05 重要声明
- 本项目仅供学习和个人使用
- LibreTV 本身不存储、不制作任何内容,仅提供第三方公开接口的聚合与播放能力,内容的合法性由数据源负责
- 请勿将部署的实例用于商业用途或公开服务
- 如因公开分享导致的任何法律问题,用户需自行承担责任
它不会替你找片,也不会替你担责。它只负责一件事:把散落在各处的公开接口,收进一个你能控制的界面里。
值不值得这 10 分钟,回到开头那 4 个问题就够了。