影音与下载

LibreTV:来源配置与网页播放

  • 0 次阅读
  • 0 条评论
文章摘要

LibreTV 当前维护版采用 Next.js,将多源检索、同名条目聚合、网页播放与来源管理放在一个界面中。它支持观看进度、本地历史、换源测试以及按文档配置的直播/IPTV 等功能,适合在自己的服务入口组织合法可访问的来源。

项目介绍

LibreTV 提供网页检索和播放入口。下文分别列出不同版本的配置,以及 Next.js 版本的部署方式。不同发行版的镜像、端口和环境变量可能不同,安装时要选用同一方案,不能交叉替换参数。

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

补充:部署与使用

配置与操作示例

当前 Next.js 版 Compose

维护仓库当前使用 Next.js 版发行,默认容器端口为 8080。下方准备命令会生成独立的 LIBRETV_PASSWORD,然后保存配置:

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/libretv/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/libretv
cd /volume1/docker/libretv
umask 077
touch .env
if ! grep -q "^LIBRETV_PASSWORD=." .env; then
  generated_secret=$(openssl rand -hex 32)
  printf 'LIBRETV_PASSWORD=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/libretv

所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/libretv/.env;该文件只保留在本机。

services:
  libretv:
    image: ghcr.io/librespark/libretv:latest
    environment:
      PASSWORD: "${LIBRETV_PASSWORD}"
    ports:
      - "8899:8080"
    restart: unless-stopped

启动后访问 http://NAS_IP:8899。公网入口使用 HTTPS;反代应正确传递协议,保证会话 Cookie 与外部访问方式一致。上游还提供 PROXY_SECRET、默认点播源、直播源和订阅变量,先在界面确认需要的功能,再按配置文档逐项加入。

来源与播放

当前版支持多源查询、同名结果聚合、来源测试、播放进度、本地历史以及直播/IPTV 等功能。点播源、M3U 与来源订阅不是同一种配置,不要把三个地址互换。只接入自己有权访问的来源;用一项合法内容检查检索、播放、拖动与字幕,再增加其他来源。

观看历史与进度使用浏览器 IndexedDB。更换浏览器、清除站点数据或改域名,可能看不到原记录;只备份容器定义不能保存这些本地数据。

启动与状态检查

在保存 compose.yaml 和所需 .env 的项目目录执行:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。

常见问题

  • 有检索结果但不能播放:检查媒体地址状态、浏览器支持、跨域限制和混合内容提示。
  • 不同浏览器对音视频编码的支持不同,不能把某一客户端能播放当作所有设备都兼容。

更新与备份

保存部署配置、来源列表和必要的访问控制设置,浏览器本地历史按实际存储位置备份。

更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。

官方资料