概要
LibreTV はセルフホスト型の映像作品集約検索・視聴プラットフォームで、Next.js 15 と TypeScript を基盤に構築され、再生コアには ArtPlayer + hls.js を採用しています。マルチソース並列検索、同名作品のクロスソース集約、ソース切り替え時の速度測定、再生進捗のローカル同期に対応しています。ライブ配信 / IPTV 機能を内蔵し、M3U サブスクリプションと EPG 番組表の解析が可能で、Docker デプロイとライト・ダークのデュアルテーマに対応しています。
README プレビュー
# LibreTV\n\nLibreTV Next.js 迁移版：免费在线视频聚合搜索与观看平台。基于 Next.js 15（App Router）+ TypeScript + Tailwind CSS，播放内核为 ArtPlayer + hls.js，支持亮暗双主题。\n\n> 🏠 **官网**：[LibreTV 官网](https://libretv.is-an.org/)\n>\n> 🌐 **演示站**：[tv.bagiinlink.eu.org](https://tv.bagiinlink.eu.org)（访问密码：`libretv`）\n>\n> 📖 **完整文档**：[文档首页](https://libretv.is-an.org/wiki/) · [架构](https://libretv.is-an.org/wiki/Architecture.html) · [部署](https://libretv.is-an.org/wiki/Deployment.html) · [配置](https://libretv.is-an.org/wiki/Configuration.html) · [数据源](https://libretv.is-an.org/wiki/Data-Sources.html) · [直播 / IPTV](https://libretv.is-an.org/wiki/Live-IPTV.html) · [首页推荐](https://libretv.is-an.org/wiki/Recommendations.html) · [播放器](https://libretv.is-an.org/wiki/Player.html) · [代理与安全](https://libretv.is-an.org/wiki/Proxy-Security.html) · [FAQ](https://libretv.is-an.org/wiki/FAQ.html)\n>\n\n\n \n\n\n## 核心特性\n\n- **聚合搜索**：多采集站服务端并行搜索\n- **跨源同名聚合**：同名影片合并为一张卡片，展开即可比较和选择各来源\n- **HLS 播放**：ArtPlayer + hls.js，广告分片过滤、自动连播、倍速、快捷键、移动端长按 3 倍速\n- **直播 / IPTV**：M3U 订阅解析，`/live` 页面按分组浏览、搜索频道并站内播放（HLS + HTTP-FLV），支持 XMLTV 节目单（EPG）与频道收藏；直播流经专用长连接代理（`/api/live/stream`）转发\n- **进度同步**：播放进度与观看历史存于本机 IndexedDB，精确到秒的续播\n- **换源测速**：跨源搜索同名资源并测速排序，一键切换保留集数位置\n- **源测试与订阅**：一键探活点播源与直播源（支持批量测活）；搜索时自动记录各源健康度，连续失败的源按阶梯时长自动停用（30 分钟 → 24 小时 → 长期），可一键恢复；订阅远程源列表（一份 LibreTV-SourceList JSON 可同时下发点播源与直播源，也可直接填 TVBOX 配置地址，自动导入其中可直接使用的接口），可导出分享\n- **首页推荐**：豆瓣（电影/剧集分类浏览）、Bangumi 新番放送表或影视榜单（豆瓣周榜 + 百度热播，经 60s API），设置中切换；均服务端直连 + 缓存，Bangumi/榜单免 key 免配置（`60S_API_BASE` 可指向自部署 60s 实例）\n- **PWA**：可安装到桌面 / 主屏幕，亮暗双主题无首屏闪烁\n\n## 部署\n\n### Docker（推荐）\n\n```bash\n# 在 .env 中设置 PASSWORD\necho "PASSWORD=your-password" > .env\n\n# 方式一：拉取发布镜像（零构建）\ndocker compose pull && docker compose up -d\n\n# 方式二：源码构建\ndocker compose up -d --build\n```\n\n### Docker Compose\n\n```yaml\nservices:\n libretv:\n image: ghcr.io/librespark/libretv:latest\n container_name: libretv\n restart: unless-stopped\n ports:\n - "8080:8080"\n environment:\n - PASSWORD=ch
FAQ (1)
トラブル対応http://server-ip:port 経由でアクセスした場合、正しいパスワードでもログインが失敗するのはなぜですか？
トラブル対応
http://server-ip:port 経由でアクセスした場合、正しいパスワードでもログインが失敗するのはなぜですか？本番モードでは、セッション Cookie に Secure フラグが設定されるため、ブラウザは HTTPS または localhost 経由でのみそれを保存します。http://server-ip:port 経由でアプリにアクセスすると、ログイン自体は実際には成功していますが、ブラウザが Cookie を通知なく破棄するため、パスワードが間違っているかのように見えてしまいます。対処法: TLS を有効にしたリバースプロキシ(例: Nginx、Caddy(ドメインでの自動 HTTPS)、Traefik)の背後に配置してサイトを HTTPS で提供するか、Cloudflare(無料の Tunnel/Proxy)を使って TLS を終端させてください。ローカルのみでアクセスする場合は、LAN IP の代わりに http://localhost:port を使用してください。localhost は Secure Cookie の制限の対象外となっています。