Docker

适用于 Docker 的自托管视频下载器

在 NAS、家用服务器或云主机上运行 VidBee。一次拉取，随处下载，无需桌面端。

在 Docker Hub 拉取 下载桌面版

几分钟内快速上手

复制 compose 文件，执行一条命令，即可从局域网内任意浏览器访问 VidBee。

快速启动 
docker run -d \
  -e VIDBEE_API_HOST=0.0.0.0 \
  -e VIDBEE_API_PORT=3100 \
  -e VIDBEE_DOWNLOAD_DIR=/data/downloads \
  -v vidbee-downloads:/data/downloads \
  -p 3100:3100 \
  ghcr.io/nexmoe/vidbee-api:latest
docker-compose.yml 
services:
  api:
    image: ghcr.io/nexmoe/vidbee-api:latest
    environment:
      VIDBEE_API_HOST: 0.0.0.0
      VIDBEE_API_PORT: 3100
      VIDBEE_DOWNLOAD_DIR: /data/downloads
      VIDBEE_HISTORY_STORE_PATH: /data/vidbee/vidbee.db
    ports:
      - "3100:3100"
    volumes:
      - vidbee-downloads:/data/downloads
      - vidbee-data:/data/vidbee
    restart: unless-stopped

  web:
    image: ghcr.io/nexmoe/vidbee-web:latest
    depends_on:
      - api
    ports:
      - "3000:3000"
    restart: unless-stopped

volumes:
  vidbee-downloads:
  vidbee-data:

自托管视频工具的常见痛点

无论是 NAS 还是家用服务器，手动下载和脆弱的脚本都会带来麻烦。VidBee 提供稳定的 Web 界面，Docker 运行在哪里，它就运行在哪里。

  • 手动向 NAS 下载视频既慢又重复
  • 无头服务器上缺少好用的 yt-dlp 图形界面
  • 纯网页工具不适合自托管媒体工作流
  • ARM NAS 设备难以找到多架构 Docker 镜像

3 步完成部署

无需脚本，无需配置文件，只需 Docker Compose 和浏览器。

  1. 1

    拉取镜像

    执行 docker compose up -d 拉取 ghcr.io/nexmoe/vidbee-api 和 vidbee-web 并启动两个服务。

  2. 2

    挂载媒体目录

    在 compose 文件中将本地下载目录映射到 /data/downloads，让文件保存到指定位置。

  3. 3

    打开 Web 界面

    在局域网内任意浏览器访问 http://your-host:3000，即可开始下载。

Docker 部署常见问题

关于架构支持、数据持久化以及 Portainer 或 Unraid 管理的常见问题解答。

VidBee Docker 镜像支持 amd64 和 arm64，可在标准服务器、Raspberry Pi、群晖 NAS（DSM 7+）及大多数 ARM 家用服务器上运行。

在 compose 文件中将宿主目录或命名卷挂载到 /data/downloads 和 /data/vidbee。上方示例中已包含这些挂载配置。

可以。将 compose 片段直接粘贴到 Portainer 的 Stack 编辑器，或使用 Unraid 的标准 Docker 模板格式，无需额外配置。

有——请查看本页的 compose 片段。它同时启动 API 服务（3100 端口）和 Web 界面（3000 端口），并配置了持久化卷。

不需要。默认服务绑定到主机所有网卡，可在 compose 文件中修改端口绑定（如 127.0.0.1:3000:3000）限制为仅局域网访问。

在自有基础设施上运行 VidBee

开源免费，无需账号，几分钟内即可完成自托管部署。

在 Docker Hub 拉取 查看桌面版