diff --git a/docs/tutorial-extras/14-yt-dlp.md b/docs/tutorial-extras/14-yt-dlp.md new file mode 100644 index 0000000..4a8d03b --- /dev/null +++ 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. 读懂输出信息 + +在下载过程中,下方的终端窗口会输出实时日志。不同颜色的含义如下: + +| 颜色 | 含义 | 说明 | +| :--- | :--- | :--- | +| 紫色 | **执行命令** | 显示实际调用的命令行参数,方便排查问题。 | +| 蓝色 | **进度信息** | 显示百分比、实时网速(MiB/s)和剩余时间。 | +| 绿色 | **完成状态** | 表示下载并合并成功,提示文件最终存放路径。 | +| 黄色 | **警告** | 非致命错误,如“回退到兼容格式”等。 | +| 红色 | **错误** | 任务失败,通常为地址无效或服务器被封禁。 | + +--- + +## 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,以防带宽被他人滥用。 +```