一分钟搭建影视站,支持Docker等部署方式
docs: 修正文档链接并精简 README
bestZwei00a16b0e0710
diff --git a/README.md b/README.mdindex 833be4f..55903a6 100644--- a/README.md+++ b/README.md@@ -2,21 +2,7 @@LibreTV-Next 是原 LibreTV 的 Next.js 迁移版:免费在线视频聚合搜索与观看平台。基于 Next.js 15(App Router)+ TypeScript + Tailwind CSS,播放内核为 ArtPlayer + hls.js,支持亮暗双主题。-> 📖 **完整文档(Wiki)**:[docs/](docs/Home) — [架构](docs/Architecture) · [部署](docs/Deployment) · [配置](docs/Configuration) · [数据源](docs/Data-Sources) · [播放器](docs/Player) · [代理与安全](docs/Proxy-Security) · [FAQ](docs/FAQ)--## 与旧版的主要差异--| 方面 | 旧版 | 本版 |-| --- | --- | --- |-| 架构 | 静态 HTML + 全局脚本 + Express | Next.js App Router + React 组件 + Route Handlers |-| 聚合搜索 | 浏览器内并行请求采集站(暴露用户 IP) | 服务端并行聚合 + 失败隔离 + 关键词过滤 |-| 鉴权 | 页面下发 sha256(password),哈希即凭证 | httpOnly Cookie 会话(HMAC 签名),登录走 POST + 速率限制 |-| m3u8 代理 | 分片重写后丢失鉴权参数导致 401 | Cookie 同源自动携带,分片天然通过鉴权 |-| 播放入口 | watch.html → player.html 跳转链 | 单一 `/watch` 路由,URL 即状态,可分享/后退 |-| 播放失败 | 只能换源 | 直连失败自动回退内置代理重试 |-| 历史与进度 | localStorage 存全集 URL(易撑爆配额) | IndexedDB 只存定位信息,进入播放页按需拉详情 |-| 播放器加载 | Tailwind 运行时编译 | Tailwind 构建期编译 |-| 主题 | 仅深色 | 亮 / 暗 / 跟随系统三态切换,无首屏闪烁 |+> 📖 **完整文档**:[docs/Home.md](docs/Home.md) · [架构](docs/Architecture.md) · [部署](docs/Deployment.md) · [配置](docs/Configuration.md) · [数据源](docs/Data-Sources.md) · [播放器](docs/Player.md) · [代理与安全](docs/Proxy-Security.md) · [FAQ](docs/FAQ.md)## 部署@@ -37,7 +23,7 @@ docker compose up -d --build`linux/amd64` 与 `linux/arm64` 双架构)。需要固定版本时在 `.env` 中设置`LIBRETV_NEXT_IMAGE=ghcr.io/bestzwei/libretv-next:2.0.1`。-> 版本号以 `package.json` 为单一来源,部署后可用 `/api/status` 返回的 `version` 字段核对。详见[部署文档](docs/Deployment)。+> 版本号以 `package.json` 为单一来源,部署后可用 `/api/status` 返回的 `version` 字段核对。详见[部署文档](docs/Deployment.md)。### 手动运行@@ -53,7 +39,7 @@ PASSWORD=your-password npm start # 监听 8080| --- | --- | --- || `PASSWORD` | 是 | 访问密码;未设置时站点会提示管理员配置 || `PROXY_SECRET` | 否 | 会话/代理签名密钥;不设置时从 PASSWORD 派生(多实例部署建议显式设置) |-| `DEFAULT_SOURCES` | 否 | 预置采集站(JSON 数组),用户端自动出现且默认勾选,详见[配置文档](docs/Configuration) |+| `DEFAULT_SOURCES` | 否 | 预置采集站(JSON 数组),用户端自动出现且默认勾选,详见[配置文档](docs/Configuration.md) || `REQUEST_TIMEOUT` | 否 | 代理上游请求超时(毫秒),默认 8000 || `MAX_RETRIES` | 否 | 代理请求重试次数,默认 1 || `DEBUG` | 否 | 调试日志 |@@ -84,7 +70,7 @@ npm version patch # 或 minor / major;会更新 package.json 并打 gitgit push && git push --tags```-CI 校验通过后自动构建并推送 `ghcr.io/bestzwei/libretv-next:<版本>`(详见[部署文档](docs/Deployment))。+CI 校验通过后自动构建并推送 `ghcr.io/bestzwei/libretv-next:<版本>`(详见[部署文档](docs/Deployment.md))。## 安全说明diff --git a/docs/Data-Sources.md b/docs/Data-Sources.mdindex 7ac2323..18963e5 100644--- a/docs/Data-Sources.md+++ b/docs/Data-Sources.md@@ -2,7 +2,7 @@LibreTV-Next 采用**空壳设计**:不内置任何采集站,由部署者/用户自行添加,避免内置源失效与合规风险。-- **部署者预置**:通过 `DEFAULT_SOURCES` 环境变量下发(JSON 数组),所有用户开箱即搜,详见[配置文档](Configuration);+- **部署者预置**:通过 `DEFAULT_SOURCES` 环境变量下发(JSON 数组),所有用户开箱即搜,详见[配置文档](Configuration.md);- **用户自建**:设置抽屉「+ 添加 API」手动添加,保存在浏览器 localStorage。## 支持的数据源类型@@ -48,7 +48,7 @@ Apple CMS(苹果CMS)标准采集接口,即提供以下接口的资源站数据源配置**只保存在用户浏览器**(localStorage),服务端不存储。每次搜索/详情请求会把用到的源配置随请求上传,因此:- 同一部署的不同用户可以有不同的数据源集合;-- 分享播放链接时 URL 会携带 `sourceUrl` 参数,接收者即使未配置同名的源也能播放(见 [Player](Player))。+- 分享播放链接时 URL 会携带 `sourceUrl` 参数,接收者即使未配置同名的源也能播放(见 [Player](Player.md))。## 常见问题diff --git a/docs/Deployment.md b/docs/Deployment.mdindex 56167ea..e32e94f 100644--- a/docs/Deployment.md+++ b/docs/Deployment.md@@ -111,7 +111,7 @@ PASSWORD=your-password npm start # 默认 8080 端口## 环境变量-完整列表见 [Configuration](Configuration)。最小可运行配置只有一个 `PASSWORD`。+完整列表见 [Configuration](Configuration.md)。最小可运行配置只有一个 `PASSWORD`。## 健康检查与验证diff --git a/docs/Home.md b/docs/Home.mdindex 91ba268..bc72a05 100644--- a/docs/Home.md+++ b/docs/Home.md@@ -6,13 +6,13 @@| 文档 | 内容 || --- | --- |-| [Architecture](Architecture) | 系统架构、目录结构、数据流、技术选型说明 |-| [Deployment](Deployment) | Docker / 手动部署、环境变量、升级指南 |-| [Configuration](Configuration) | 环境变量详解、主题系统、数据源管理、配置导入导出 |-| [Data-Sources](Data-Sources) | 采集站(Apple CMS)接入说明、自定义 API 格式、常见问题源 |-| [Player](Player) | 播放器功能、快捷键、广告过滤、代理回退、进度与历史 |-| [Proxy-Security](Proxy-Security) | 代理鉴权设计、SSRF 防护、安全模型与旧版对比 |-| [FAQ](FAQ) | 常见问题排查 |+| [Architecture](Architecture.md) | 系统架构、目录结构、数据流、技术选型说明 |+| [Deployment](Deployment.md) | Docker / 手动部署、环境变量、升级指南 |+| [Configuration](Configuration.md) | 环境变量详解、主题系统、数据源管理、配置导入导出 |+| [Data-Sources](Data-Sources.md) | 采集站(Apple CMS)接入说明、自定义 API 格式、常见问题源 |+| [Player](Player.md) | 播放器功能、快捷键、广告过滤、代理回退、进度与历史 |+| [Proxy-Security](Proxy-Security.md) | 代理鉴权设计、SSRF 防护、安全模型与旧版对比 |+| [FAQ](FAQ.md) | 常见问题排查 |## 快速开始@@ -39,4 +39,4 @@ PASSWORD=dev-password npm run dev # http://localhost:8080## 与旧版(静态 HTML + Express)的关系-本项目是 [LibreTV 旧版](https://github.com/LibreSpark/LibreTV)的完整重构。功能对齐的同时修复了旧版的多项问题(历史记录 XSS、m3u8 分片鉴权丢失、密码哈希暴露等),架构差异详见 [Architecture](Architecture)。+本项目是 [LibreTV 旧版](https://github.com/LibreSpark/LibreTV)的完整重构。功能对齐的同时修复了旧版的多项问题(历史记录 XSS、m3u8 分片鉴权丢失、密码哈希暴露等),架构差异详见 [Architecture](Architecture.md)。