---
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，以防带宽被他人滥用。
```
