Skip to content

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

docs: 修正文档链接并精简 README

bestZwei00a16b0e0710
diff --git a/README.md b/README.md
index 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 并打 git
git 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.md
index 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.md
index 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.md
index 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)。