Docker

適用於 Docker 的自托管影片下載器

在 NAS、家用伺服器或雲端 VM 上執行 VidBee。拉取一次,隨處下載,無需桌面端。

幾分鐘內快速上手

複製 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

開源免費,無需帳號,幾分鐘內即可完成自托管部署。