whitesharks/videodl-webui repository overview

⁠VideoDL WebUI（Docker 一键部署版）

这是一个基于 CharlesPikachu/videodl⁠ 的轻量 Web 管理界面版本：你可以在浏览器里创建下载任务、查看实时日志、管理下载文件，并在 NAS（群晖 x86_64 / ARM 设备等）上通过 Docker 开箱即用地运行。

镜像地址（Docker Hub）：whitesharks/videodl-webui

⁠1) 项目介绍

VideoDL 是一个用于下载在线视频的工具，支持多种站点与解析方式。 VideoDL WebUI 在 VideoDL 的基础上提供了一个简洁的 Web 界面，适合部署在 NAS/服务器上，通过网页进行任务管理与文件管理。

本镜像的目标是：

• 开箱即用：启动容器即可访问 WebUI
• 持久化：下载内容、任务记录、配置持久化到挂载目录
• 易维护：支持定时构建（上游更新后自动构建最新 VideoDL）

⁠2) 主要功能

⁠✅ 下载任务管理

• 新建下载任务（输入 URL）
• 支持额外参数（追加到 videodl -i URL ... 后）
• 支持 按任务启用代理（结合全局代理配置）
• 任务状态：queued / running / success / failed / stopped
• 任务详情页实时查看日志（自动刷新）
• 支持手动停止任务（停止后自动清理临时分片目录）

⁠✅ 并发下载（多任务并行）

• 可在页面设置 并发上限
• 超过并发上限的任务自动排队（queued）

⁠✅ 已下载文件管理

• 自动扫描并展示下载完成的文件（过滤临时分片/过程文件）
• 文件大小与时间以友好格式显示（MiB/GiB、可读时间）
• 支持下载文件 / 删除文件
• 文件列表后台定时刷新（避免删除后页面不更新）

⁠✅ 运行设置

• 并发上限
• 代理配置（http/https/socks5）
• 单任务超时
• 日志保留天数（定期清理任务日志）

⁠3) 功能使用说明

⁠3.1 打开 WebUI

启动容器后，在浏览器访问：

http://<你的机器IP>:61771

首页右上角会显示：

• VideoDL 版本号
• VideoDL WebUI 版本号

⁠3.2 新建下载任务

在首页「新建下载任务」中：

1. 输入 视频 URL

2. （可选）填写 额外参数

3. （可选）勾选 启用代理

   • 需要你在「运行设置」里先配置好全局代理地址

4. 点击「加入队列 / 开始下载」

任务会进入队列并由调度器自动启动。

⁠3.3 查看日志 / 停止任务

点击任务 ID 进入任务详情页：

• 页面会自动刷新任务状态与日志

• 手动点击「停止任务」：

  • 会终止下载进程
  • 自动清理任务目录中的临时分片目录（例如 videodl_outputs/**/segment_*.mp4）

⁠3.4 删除任务（可选同时删除文件）

在首页任务列表点击「删除」：

• 弹窗确认

• 可勾选 同时删除文件

  • 勾选后会彻底删除任务目录（如 /data/downloads/<task_id>/），包括目录本身

⁠3.5 已下载文件

首页「已下载文件」区：

• 默认只显示“最终成品文件”（例如 .../videodl_outputs/CCTVVideoClient/xxx.mp4）
• 自动过滤临时分片、.txt、.m3u8、.ts 等过程文件
• 支持直接点击路径下载
• 支持删除文件

⁠4) docker-compose 示例（群晖 NAS 持久化）

创建目录结构：

• /volume1/docker/videodl-webui/downloads
• /volume1/docker/videodl-webui/tasks

然后使用以下 docker-compose.yml：

version: "3.8"

services:
  videodl-webui:
    image: whitesharks/videodl-webui:latest
    container_name: videodl-webui
    restart: unless-stopped

    ports:
      - "61771:61771"

    environment:
      HOST: "0.0.0.0"
      PORT: "61771"

      # 与镜像默认一致（建议保留）
      DOWNLOAD_DIR: "/data/downloads"
      TASKS_DIR: "/data/tasks"

      # 可选：时区
      TZ: "Asia/Shanghai"

    volumes:
      # 持久化数据（下载/任务/设置/日志）
      - /volume1/docker/videodl-webui:/data

启动：

docker compose up -d

访问：

http://群晖IP:61771

⁠额外补充

⁠✅ 目录说明（容器内）

• /data/downloads：每个任务一个目录（建议挂载持久化）
• /data/tasks：任务元数据、日志、运行设置（建议挂载持久化）

⁠✅ 代理使用建议

• 在「运行设置」里配置 proxy_url（例如 http://192.168.1.2:7890 或 socks5://...）
• 新建任务时勾选“启用代理”，该任务才会使用代理

⁠✅ 常见问题

• 下载失败：请先用容器内测试是否可访问目标站点；必要时启用代理。
• 下载目录权限：群晖挂载目录请确保容器有读写权限。
• 并发太大导致资源不足：建议从 1～2 开始逐步增大。

⁠免责声明

本项目仅用于学习与个人用途，请遵守相关法律法规及网站服务条款。下载与使用内容的合法性由使用者自行承担。