Skip to content

一分钟搭建影视站,支持Docker等部署方式

docs: 补全 README 订阅格式字段表与环境变量;修正 60S_API_BASE 默认值,移除未使用的 DEBUG

bestZweid0e6fadaee58
diff --git a/README.md b/README.md
index 4ea9d96..645bc31 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ LibreTV Next.js 迁移版:免费在线视频聚合搜索与观看平台。基
- **直播 / IPTV**:M3U 订阅解析,`/live` 页面按分组浏览、搜索频道并站内播放(HLS + HTTP-FLV),支持 XMLTV 节目单(EPG)与频道收藏;直播流经专用长连接代理(`/api/live/stream`)转发
- **进度同步**:播放进度与观看历史存于本机 IndexedDB,精确到秒的续播
- **换源测速**:跨源搜索同名资源并测速排序,一键切换保留集数位置
-- **源测试与订阅**:一键探活点播源与直播源;订阅远程源列表(一份 LibreTV-SourceList JSON 可同时下发点播源与直播源,也可直接填 TVBOX 配置地址,自动导入其中可直接使用的接口),可导出分享
+- **源测试与订阅**:一键探活点播源与直播源(支持批量测活);搜索时自动记录各源健康度,连续失败的源按阶梯时长自动停用(30 分钟 → 24 小时 → 长期),可一键恢复;订阅远程源列表(一份 LibreTV-SourceList JSON 可同时下发点播源与直播源,也可直接填 TVBOX 配置地址,自动导入其中可直接使用的接口),可导出分享
- **首页推荐**:豆瓣(电影/剧集分类浏览)、Bangumi 新番放送表或影视榜单(豆瓣周榜 + 百度热播,经 60s API),设置中切换;均服务端直连 + 缓存,Bangumi/榜单免 key 免配置(`60S_API_BASE` 可指向自部署 60s 实例)
- **PWA**:可安装到桌面 / 主屏幕,亮暗双主题无首屏闪烁
@@ -90,11 +90,14 @@ PASSWORD=your-password npm start # 监听 8080
| `REQUEST_TIMEOUT` | 否 | 代理上游请求超时(毫秒),默认 8000 |
| `MAX_RETRIES` | 否 | 代理请求重试次数,默认 1 |
| `SEARCH_MAX_PAGES` | 否 | 每个搜索源最多抓取的页数(1-50,默认 5)。第一页会读取源站 `pagecount`,实际页数 = min(源站总页数,该值);页间并行请求,单页失败只丢该页 |
-| `60S_API_BASE` | 否 | 影视榜单推荐源(60s API)实例地址,默认官方公共实例 `https://60s.viki.moe`;有限流,高频使用可[自部署](https://github.com/vikiboss/60s) |
+| `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` 导致 HTTPS 下登录失效时,设为 `true` 可解 |
+| `60S_API_BASE` | 否 | 影视榜单推荐源(60s API)实例地址,默认 `https://60s.crystelf.top`;有限流,高频使用可[自部署](https://github.com/vikiboss/60s) |
| `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":"名称"}]`。首次访问自动导入点播源与直播源,之后每 24h 静默刷新;用户删除后不再自动加回 |
| `LIVE_ALLOW_PRIVATE` | 否 | 设为 `1` 时允许直播流代理访问内网/保留地址(自建 IPTV 场景),默认关闭以维持 SSRF 防护 |
-| `DEBUG` | 否 | 调试日志 |
## 使用说明
@@ -126,18 +129,44 @@ PASSWORD=your-password npm start # 监听 8080
"name": "我的源列表",
"version": 2,
"sources": [
- { "name": "示例点播源", "url": "https://example.com/api.php/provide/vod" }
+ {
+ "name": "示例点播源",
+ "url": "https://example.com/api.php/provide/vod",
+ "detail": "https://example.com",
+ "isAdult": false
+ }
],
"liveSources": [
- { "name": "示例直播源", "url": "https://example.com/list.m3u", "epg": "https://example.com/epg.xml.gz" }
+ {
+ "name": "示例直播源",
+ "url": "https://example.com/list.m3u",
+ "epg": "https://example.com/epg.xml.gz"
+ }
]
}
```
-- `sources` 为点播源(Apple CMS 采集站),必填字段只有 `url`;`detail` 为详情页根地址,`isAdult` 为成人内容标记;
-- `liveSources` 为直播源(M3U 播放列表),必填字段只有 `url`;`epg` 为可选的 XMLTV 节目单地址;
-- 只写 `sources` 的老订阅照常可用(纯点播),只写 `liveSources` 则是纯直播订阅;裸数组 `[{ "name": "...", "url": "..." }]` 视为点播源;
-- 按 `url` 去重,点播源最多 100 个、直播源最多 50 个;非 http(s) 地址会被过滤,点播源另需为公网地址(直播源可用 `LIVE_ALLOW_PRIVATE=1` 放行内网自建源)。
+**字段说明**:
+
+| 字段 | 位置 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `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` 页展示节目单;地址非法时只丢弃该字段、保留整条源 |
+
+**兼容与限制**:
+
+- 只写 `sources` 的老订阅照常可用(纯点播),只写 `liveSources` 则是纯直播订阅;两者都缺时提示「订阅内容格式不正确」;裸数组 `[{ "name": "...", "url": "..." }]` 视为点播源;
+- 按 `url` 去重(先到先得);非 http(s) 地址会被过滤;**点播源**另需为公网地址(内网/回环/保留地址会被静默过滤),**直播源**在部署者设置 `LIVE_ALLOW_PRIVATE=1` 时可使用内网自建源地址;
+- 订阅由**服务端**拉取(拉取前经过 SSRF 校验),因此订阅地址**无需配置 CORS**,Gist、对象存储、任意静态托管均可。
### 兼容 TVBOX 配置
@@ -155,7 +184,7 @@ PASSWORD=your-password npm start # 监听 8080
- **订阅**:设置 → 源管理 → 数据源订阅 → 填入订阅地址 → 「订阅」,导入的点播源自动勾选、直播源自动启用,均带「订阅」标识,条目上显示「点播 N · 直播 M」;
- **同步**:订阅条目上的 **⟳** 手动强制同步,整体替换该订阅名下的点播源与直播源;
- **管理边界**:订阅源以远端列表为准,单独编辑会在下次同步时被覆盖,单独移除会在重新同步时恢复;如需调整请改远端列表,或直接删除整个订阅。删除订阅时点播源全部移除;直播源为**多归属共享**——同一 M3U 可被多个订阅引用(名称/EPG 以首次导入为准),删除只移除自己的引用,仅当不再被任何订阅引用时才移除该源,**收藏的频道始终保留**;
-- **导出分享**:设置 → 源管理 → 数据源订阅 → 「导出数据源」,把当前全部点播源与直播源(预置 + 手动 + 订阅,按 URL 去重)导出为上述 JSON。
+- **导出分享**:设置 → 源管理 → 数据源订阅 → 「导出数据源」,把当前全部点播源与直播源(预置 + 手动 + 订阅,按 URL 去重)导出为上述 JSON;也可用「发布为链接」,把当前**已勾选启用**的源一键上传到公开粘贴板(paste.rs,失败自动降级 0x0.st),直接返回可填入订阅框的 URL,无需自备托管。注意:发布的内容**公开可读**,且每次发布生成新链接、不支持覆盖更新,需长期稳定请用导出 + 自行托管。
> 订阅由服务端拉取(经过 SSRF 校验),因此订阅地址无需配置 CORS。完整说明见 [数据源文档](https://github.com/bestZwei/LibreTV-Next/wiki/Data-Sources)。
diff --git a/docker-compose.yml b/docker-compose.yml
index 884b13d..339ec76 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -31,8 +31,9 @@ services:
# - MAX_RETRIES=1
# 可选:每个搜索源最多抓取的页数(1-50,默认 5),调大会显著增加上游请求量
# - SEARCH_MAX_PAGES=5
+ # 可选:单个搜索源的总死线(毫秒,3s-60s,默认 10000),到点中断该源并标记超时
+ # - SEARCH_SOURCE_TIMEOUT_MS=10000
# 可选:代理请求 UA(豆瓣防盗链等场景)
# - USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/122.0.0.0 Safari/537.36
# 可选:影视榜单推荐源(60s API)实例地址,官方公共实例有限流
- # - 60S_API_BASE=https://60s.viki.moe
- # - DEBUG=false
+ # - 60S_API_BASE=https://60s.crystelf.top