KV-Tube

A modern, fast, and fully-featured YouTube-like video streaming platform. Built with a robust Go backend and a highly responsive Next.js frontend, KV-Tube is designed for seamless deployment on systems like Synology NAS via Docker.

Features

Modern Video Player: High-resolution video playback with HLS support and quality selection.
Fast Navigation: Instant click feedback with skeleton loaders for related videos.
Infinite Scrolling: Scroll seamlessly through a dynamic video grid on the homepage.
Watch History & Suggestions: Keep track of what you've watched, with smart video suggestions.
Region Selection: Tailor your content to specific regions (e.g., Vietnam).
Responsive Design: Beautiful, mobile-friendly interface with light and dark theme support.
Containerized: Fully Dockerized for easy setup using docker-compose.

Architecture

Backend: Go (Gin framework), SQLite for watch history, optimized for linux/amd64.
Frontend: Next.js utilizing React Server Components and standalone output for minimal container footprint.

Deployment on Synology NAS

We recommend using Docker Compose for simple and robust deployment.

1. Prerequisites

Docker and Container Manager installed on your Synology NAS.
Make sure ports 5011 are free, or adjust docker-compose.yml to fit your needs.

2. Setup

Create a docker-compose.yml file matching the one provided in the repository:

version: '3.8'

services:
  kv-tube-backend:
    image: git.khoavo.myds.me/vndangkhoa/kv-tube-backend:v4.0.0
    container_name: kv-tube-backend
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    environment:
      - KVTUBE_DATA_DIR=/app/data
      - GIN_MODE=release
    healthcheck:
      test: [ "CMD", "curl", "-f", "http://localhost:8080/api/health" ]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

  kv-tube-frontend:
    image: git.khoavo.myds.me/vndangkhoa/kv-tube-frontend:v4.0.0
    container_name: kv-tube-frontend
    restart: unless-stopped
    ports:
      - "5011:3000"
    depends_on:
      - kv-tube-backend

3. Run

In the directory containing your docker-compose.yml, run:

docker-compose up -d

The application will be accessible at http://<your-nas-ip>:5011.

Development

Frontend builds can be started in frontend/ via npm run dev.
Backend server starts in backend/ via go run main.go.

2.4 KiB Raw Blame History