项目介绍
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,不要把删除卷或清空数据目录当作更新步骤。