LibreSpark/LibreTV

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/LibreSpark/LibreTV.svg?style=card)](https://bestofgithub.dev/repo/LibreSpark/LibreTV)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/LibreSpark/LibreTV.svg)](https://bestofgithub.dev/repo/LibreSpark/LibreTV)

Loading README…

变量	必填	说明
`PASSWORD`	是	访问密码；未设置时站点会提示管理员配置
`PROXY_SECRET`	否	会话/代理签名密钥；不设置时从 PASSWORD 派生（多实例部署建议显式设置）
`DEFAULT_SOURCES`	否	预置采集站（JSON 数组），用户端自动出现且默认勾选，详见配置文档
`REQUEST_TIMEOUT`	否	代理上游请求超时（毫秒），默认 8000
`MAX_RETRIES`	否	代理请求重试次数，默认 1
`SEARCH_MAX_PAGES`	否	每个搜索源最多抓取的页数（1-50，默认 5）。第一页会读取源站 `pagecount`，实际页数 = min(源站总页数，该值)；页间并行请求，单页失败只丢该页
`SEARCH_SOURCE_TIMEOUT_MS`	否	单个搜索源的总死线（毫秒，3s-60s，默认 10000）：该源所有分页请求须在时限内完成，到点中断并将其标记为「超时」；健康度自动停用也以此为超时判定依据
`USER_AGENT`	否	代理请求使用的 UA（豆瓣封面防盗链等场景），默认 Chrome UA
`FALLBACK_CORS_PROXY`	否	豆瓣推荐数据直连被拒时降级使用的 CORS 代理地址
`COOKIE_SECURE`	否	显式覆盖会话 cookie 的 `Secure` 标记（`true` / `false`）；默认按 `x-forwarded-proto` 自动推导。反向代理终结了 TLS 但没传这个头时，cookie 不会带 `Secure`（不影响登录，但少了这层保护），设 `true` 可强制
`60S_API_BASE`	否	影视榜单推荐源（60s API）实例地址，默认 `https://60s.crystelf.top`；有限流，高频使用可自部署
`DEFAULT_LIVE_SOURCES`	否	预置直播源（M3U 订阅），JSON 数组：`[{"name":"源名","url":"https://.../list.m3u","epg":"https://.../epg.xml.gz"}]`，`epg` 为可选的 XMLTV 节目单地址
`DEFAULT_SUBSCRIPTIONS`	否	预置数据源订阅（LibreTV-SourceList JSON 链接，也接受 TVBOX 配置与接口目录地址），JSON 数组：`["https://.../sources.json", {"url":"https://.../list.json","name":"名称","refreshDays":10}]`。首次访问自动导入点播源与直播源，之后按 `refreshDays`（1-365，缺省 1 天）静默刷新；用户删除后不再自动加回。`refreshDays` 只是初始值，用户在源管理面板改过之后以面板设置为准
`DEFAULT_RECOMMEND_SOURCE`	否	首页推荐数据源的默认值（`douban` / `bangumi` / `hot-list`，出厂默认 `hot-list`）；仅对未在设置中主动选择过的用户生效，用户的选择始终优先
`LIVE_ALLOW_PRIVATE`	否	设为 `1` 时允许直播流代理访问内网/保留地址（自建 IPTV 场景），默认关闭以维持 SSRF 防护

字段	位置	类型	必填	说明
`name`	顶层	string	否	列表名称，订阅后显示在订阅条目上；缺省时显示订阅地址主机名
`version`	顶层	number	否	格式版本，当前为 `2`（新增 `liveSources`）；导入端目前忽略该字段
`sources`	顶层	array	否	点播源数组（Apple CMS 采集站），最多 100 个，超出部分截断
`sources[].name`	项	string	否	源显示名；缺省时使用 URL 主机名
`sources[].url`	项	string	是	Apple CMS 采集接口地址（公网 http/https），结尾 `/` 自动去除
`sources[].detail`	项	string	否	详情页根地址，用于列表接口拿不到播放地址、需要爬详情页提取 m3u8 的源
`sources[].isAdult`	项	boolean	否	成人内容标记，默认 `false`。标记为 `true` 的源名称旁显示 (18+) 徽章；设置中的「成人内容过滤」开启（默认开启）时该源不可勾选、不参与搜索，需先关闭过滤才能启用
`liveSources`	顶层	array	否	直播源数组（M3U 播放列表），最多 50 个，超出部分截断
`liveSources[].name`	项	string	否	源显示名；缺省时使用 URL 主机名
`liveSources[].url`	项	string	是	M3U 播放列表地址（http/https）
`liveSources[].epg`	项	string	否	XMLTV 节目单地址（`xml` / `xml.gz`），用于 `/live` 页展示节目单；地址非法时只丢弃该字段、保留整条源

项目	说明
OrionTV	Apple TV / Android TV 客户端（React Native TVOS + Expo），配合 MoonTV 使用
LunaTV	影视聚合站（Next.js），支持 Redis / Upstash 等多存储后端
Selene-TV	Android TV（Leanback）客户端，Kotlin + Compose，对接 MoonTV / Helios
EchoTV	Flutter 全平台客户端（已归档）
WarHutTV	Go + React 的自托管影视聚合站
DecoTV	聚合播放站（原 KatelyaTV）
Joyflix	macOS 原生影视聚合客户端（Objective-C）
MoonCakeTV	影视聚合搜索站（Next.js），文件存储、一键脚本部署
OrangeTV	跨平台影视聚合播放器（Next.js），Kvrocks/Redis/Upstash 多存储与多端同步
MQTV	重构与优化 LibreTV
NextTV	影视聚合站（Next.js + Zustand），支持弹幕
DpadTV	Android TV 原生客户端（Kotlin + Media3/ExoPlayer），对接自建服务端，不依赖 WebView
LibreTV-for-HarmonyOS	HarmonyOS NEXT 原生客户端（ArkTS + ArkUI + AVPlayer）

LibreSpark/LibreTV

LibreTV

核心特性

部署

Docker（推荐）

Docker Compose

免 Docker 运行（预构建包）

手动运行

环境变量

使用说明

直播 / IPTV

数据源订阅 / 分享

订阅格式（LibreTV-SourceList JSON）

兼容 TVBOX 配置

兼容接口目录（source-catalog）

订阅行为

开发

发布新版本

安全说明

衍生作品

免责声明