101 lines
3.9 KiB
Markdown
101 lines
3.9 KiB
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://盒子IP:50000`
|
||
|
||
### 第二步：设置保存目录
|
||
默认下载路径为 `/home/ubuntu/files`。
|
||
1. 在“保存目录”输入框中填写您希望存放视频的绝对路径。
|
||
2. 点击 **“确认路径”**，系统会弹出确认框，显示该目录的磁盘剩余空间（建议预留 5GB 以上）。
|
||
3. 确认无误后点击“确认使用”。
|
||
4. 建议挂载外置磁盘，配合本地网盘使用。
|
||
|
||
### 第三步：开始下载
|
||
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：可以同时下载多个视频吗？**
|
||
A：为了保证服务器性能，当前 Web 界面仅支持单线程下载，请等待当前任务完成后再提交新任务。
|
||
|
||
**Q：下载的文件去哪了？**
|
||
A：文件名类似于 `20250510_153022.mp4`，保存在您在界面上设置的目录中。如果未设置，请检查默认目录 `/home/ubuntu/files`。
|
||
|
||
---
|
||
|
||
## 7. 安全说明
|
||
|
||
- **隐私**：本工具不记录您的下载历史，关闭浏览器后日志即消失。
|
||
- **公网风险**：服务默认监听 `0.0.0.0` 端口。如果您在公网服务器上使用，建议通过防火墙（如 `ufw`）限制访问 IP，以防带宽被他人滥用。
|
||
```
|