一分钟搭建影视站,支持Docker等部署方式
docs: 补全 README 订阅格式字段表与环境变量;修正 60S_API_BASE 默认值,移除未使用的 DEBUG
bestZweid0e6fadaee58
diff --git a/README.md b/README.mdindex 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.ymlindex 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