Docker

Docker용 셀프 호스팅 동영상 다운로더

NAS, 홈 서버 또는 클라우드 VM에서 VidBee를 실행하세요. 한 번 풀(pull)하면 데스크톱 없이 어디서든 다운로드할 수 있습니다.

Docker Hub에서 풀(Pull) 데스크톱 앱 다운로드

몇 분 안에 시작하기

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는 Docker가 실행되는 어디서든 안정적인 웹 기반 인터페이스를 제공합니다.

  • NAS로 동영상을 수동 다운로드하는 것은 느리고 반복적
  • 헤드리스 서버에서 사용할 yt-dlp GUI가 없음
  • 웹 전용 도구는 셀프 호스팅 미디어 워크플로에 맞지 않음
  • ARM NAS 기기용 멀티 아키텍처 Docker 이미지를 찾기 어려움

3단계로 시작하기

스크립트나 설정 파일 없이 Docker Compose와 브라우저만 있으면 됩니다.

  1. 1

    이미지 풀(Pull)

    docker compose up -d를 실행하여 ghcr.io/nexmoe/vidbee-api와 vidbee-web을 가져오고 두 서비스를 시작합니다.

  2. 2

    미디어 폴더 마운트

    compose 파일에서 로컬 다운로드 디렉터리를 /data/downloads에 매핑하여 파일이 원하는 위치에 저장되도록 합니다.

  3. 3

    Web UI 열기

    네트워크의 모든 브라우저에서 http://your-host:3000으로 접속하여 다운로드를 시작합니다.

Docker 배포 FAQ

아키텍처 지원, 데이터 지속성, Portainer 또는 Unraid 관리에 관한 자주 묻는 질문입니다.

VidBee Docker 이미지는 amd64와 arm64를 지원하며 표준 서버, Raspberry Pi, Synology NAS(DSM 7+), 대부분의 ARM 기반 홈 서버에서 실행됩니다.

compose 파일에서 호스트 디렉터리 또는 명명된 볼륨을 /data/downloads와 /data/vidbee에 마운트하세요. 위의 compose 예제에는 이미 이 마운트 설정이 포함되어 있습니다.

네. compose 스니펫을 Portainer의 스택 편집기에 직접 붙여넣거나 Unraid의 표준 Docker 템플릿 형식을 사용하세요. 별도 설정이 필요하지 않습니다.

있습니다. 이 페이지의 compose 스니펫을 확인하세요. API 서비스(포트 3100)와 Web UI(포트 3000)를 시작하며 다운로드와 히스토리 DB를 위한 영구 볼륨이 포함되어 있습니다.

아니요. 기본적으로 서비스는 호스트의 모든 인터페이스에 바인딩되지만, compose 파일의 포트 바인딩을 변경(예: 127.0.0.1:3000:3000)하여 LAN 전용으로 제한할 수 있습니다.

나만의 인프라에서 VidBee 실행

오픈소스, 계정 불필요, 몇 분 안에 셀프 호스팅 시작.

Docker Hub에서 풀(Pull) 데스크톱 앱 보기