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