update

2026-05-12 17:18:28 +08:00
parent a3e8267c15
commit cbb067e7fc
1 changed files with 104 additions and 0 deletions
--- a/docs/tutorial-extras/14-yt-dlp.md
+++ b/docs/tutorial-extras/14-yt-dlp.md
@@ -0,0 +1,104 @@
+```markdown
+---
+sidebar_position: 14
+---
+
+# YT-DLP 视频下载器使用教程
+
+YT-DLP 视频下载器是一个基于强大的开源项目 `yt-dlp` 构建的本地化网页下载工具。它为命令行程序提供了直观的 Web 交互界面，支持从全球数百个主流视频平台（如 YouTube、Bilibili、TikTok 等）下载高清视频。
+
+该工具所有数据均在您的本地服务器处理，不经过任何第三方服务器，安全且高效。
+
+## 1. 工具特性
+
+- **零门槛操作**：无需记忆复杂的命令行参数，通过浏览器粘贴 URL 即可下载。
+- **实时进度**：通过 WebSocket 技术实时推送下载速度、预计剩余时间（ETA）和合并进度。
+- **智能路径验证**：支持自定义保存目录，系统会自动检测磁盘空间和写入权限。
+- **自动命名**：采用 `YYYYMMDD_HHMMSS` 时间戳格式命名，彻底解决视频标题特殊字符导致的乱码或重名覆盖问题。
+- **高性能后端**：底层调用最新的 `yt-dlp` 核心，支持音视频自动合并。
+
+---
+
+## 2. 安装与卸载
+
+### 安装
+在终端执行以下命令进行一键安装：
+
+```bash
+apt update && apt install dlp-histb -y
+```
+
+### 卸载
+如果需要移除该工具，请执行：
+
+```bash
+apt remove dlp-histb -y
+```
+
+---
+
+## 3. 快速上手
+
+### 第一步：访问界面
+安装完成后，程序默认在后台运行。在浏览器中输入以下地址进入管理界面：
+- **本地访问**：`http://127.0.0.1:50000`
+- **远程访问**：`http://服务器IP:50000`
+
+### 第二步：设置保存目录
+默认下载路径为 `/home/ubuntu/files`。
+1. 在“保存目录”输入框中填写您希望存放视频的绝对路径。
+2. 点击 **“确认路径”**，系统会弹出确认框，显示该目录的磁盘剩余空间（建议预留 5GB 以上）。
+3. 确认无误后点击“确认使用”。
+
+### 第三步：开始下载
+1. 复制目标视频的网页链接（URL）。
+2. 粘贴至“视频地址”输入框。
+3. 点击 **“▶ 下载”** 或直接按回车键。
+
+---
+
+## 4. 读懂输出信息
+
+在下载过程中，下方的终端窗口会输出实时日志。不同颜色的含义如下：
+
+| 颜色 | 含义 | 说明 |
+| :--- | :--- | :--- |
+| <font color="#a78bfa">紫色</font> | **执行命令** | 显示实际调用的命令行参数，方便排查问题。 |
+| <font color="#38bdf8">蓝色</font> | **进度信息** | 显示百分比、实时网速（MiB/s）和剩余时间。 |
+| <font color="#34d399">绿色</font> | **完成状态** | 表示下载并合并成功，提示文件最终存放路径。 |
+| <font color="#fbbf24">黄色</font> | **警告** | 非致命错误，如“回退到兼容格式”等。 |
+| <font color="#f87171">红色</font> | **错误** | 任务失败，通常为地址无效或服务器被封禁。 |
+
+---
+
+## 5. 支持的平台
+
+得益于 `yt-dlp` 核心，本工具支持超过 1000 个站点的解析，包括但不限于：
+- **综合类**：YouTube, Bilibili (哔哩哔哩), Vimeo, Dailymotion
+- **社媒类**：Twitter(X), TikTok, Instagram, Weibo, Reddit
+- **其他**：各类在线视频网站及成人内容平台。
+
+:::info 提示
+部分受加密保护（DRM）的内容（如 Netflix、Disney+）无法通过本工具下载。
+:::
+
+---
+
+## 6. 常见问题 (FAQ)
+
+**Q：为什么 1080P 视频下载后没有声音？**
+A：高清视频通常音画分离。请确保服务器已安装 `ffmpeg`，本工具会自动调用它进行合并。
+
+**Q：可以同时下载多个视频吗？**
+A：为了保证服务器性能，当前 Web 界面仅支持单线程下载，请等待当前任务完成后再提交新任务。
+
+**Q：下载的文件去哪了？**
+A：文件名类似于 `20250510_153022.mp4`，保存在您在界面上设置的目录中。如果未设置，请检查默认目录 `/home/ubuntu/files`。
+
+---
+
+## 7. 安全说明
+
+- **隐私**：本工具不记录您的下载历史，关闭浏览器后日志即消失。
+- **公网风险**：服务默认监听 `0.0.0.0` 端口。如果您在公网服务器上使用，建议通过防火墙（如 `ufw`）限制访问 IP，以防带宽被他人滥用。
+```