Sign inSign up

alfigusman0/backend-dbbackup

By alfigusman0

•Updated 17 days ago

DB Backup Manager — Backend API. MySQL/PostgreSQL → Google Drive/S3/MinIO/OwnCloud. Self-hosted.

Buildkit cache
Image
Integration & delivery
Developer tools
Databases & storage
0

5.3K

alfigusman0/backend-dbbackup repository overview

⁠DB Backup Manager — Backend

REST API server untuk aplikasi DB Backup Manager — solusi backup database self-hosted yang mem-backup MySQL, MariaDB, dan PostgreSQL langsung ke cloud storage tanpa menyimpan file sementara di server.

🌐 Live Demo: bm.alfi-gusman.web.id⁠
🔗 Frontend image: alfigusman0/frontend-dbbackup⁠


⁠Fitur

  • 🗄️ Multi-Database — MySQL 5.7+, MariaDB 10.3+, PostgreSQL 12+
  • ☁️ Multi-Cloud — Google Drive, Amazon S3, MinIO, OwnCloud/Nextcloud
  • ⚡ Zero Local Storage — stream dump → gzip → cloud, tidak ada file sementara di server
  • 📅 Cron Scheduler — backup otomatis dengan cron expression & timezone support penuh
  • 📊 Progress Tracking — persentase progress real-time per fase backup
  • 🔒 Enkripsi Credential — AES-256-GCM untuk semua password & secret
  • 📱 Notifikasi WhatsApp — notif sukses/gagal/expiry via waduh.fun API
  • 🪪 Lisensi Terpusat — validasi RS256 JWT dengan machine fingerprint
  • 👥 Multi-User RBAC — role admin / operator / viewer
  • 🔄 BullMQ Queue — background job queue dengan Redis (retry 3x, concurrency 2)

⁠Quick Start

Gunakan bersama docker compose — jangan jalankan image ini secara standalone.

⁠1. Buat docker-compose.yml
version: '3.9'
services:
  backend:
    image: alfigusman0/backend-dbbackup:latest
    container_name: dbbackup-api
    restart: unless-stopped
    pull_policy: always
    ports:
      - "${PORT:-4000}:4000"
    env_file: .env
    environment:
      NODE_ENV: production
      TZ: ${TZ:-Asia/Jakarta}
      DB_HOST: mysql
      DB_PORT: "3306"
      DB_USER: ${DB_USER:-backupuser}
      DB_PASS: ${DB_PASS}
      DB_NAME: ${DB_NAME:-backup_manager}
      REDIS_HOST: redis
      REDIS_PORT: "6379"
      REDIS_PASS: ${REDIS_PASS:-}
      JWT_SECRET: ${JWT_SECRET}
      JWT_EXPIRED_IN: ${JWT_EXPIRED_IN:-7d}
      ENCRYPTION_KEY: ${ENCRYPTION_KEY}
      CORS_ORIGINS: ${CORS_ORIGINS}
      FRONTEND_URL: ${FRONTEND_URL}
      GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID:-}
      GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET:-}
      GOOGLE_REDIRECT_URI: ${GOOGLE_REDIRECT_URI:-}
      LICENSE_SERVER_URL: ${LICENSE_SERVER_URL:-}
      LICENSE_PUBLIC_KEY: ${LICENSE_PUBLIC_KEY:-}
      LOG_LEVEL: ${LOG_LEVEL:-info}
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
    networks: [dbbackup-network]
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:4000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s

  frontend:
    image: alfigusman0/frontend-dbbackup:latest
    container_name: dbbackup-frontend
    restart: unless-stopped
    pull_policy: always
    ports:
      - "${FRONTEND_PORT:-3001}:3000"
    environment:
      NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL:-http://localhost:4000}
    depends_on:
      backend:
        condition: service_healthy
    networks: [dbbackup-network]
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:3000"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  mysql:
    image: mysql:8.0
    container_name: dbbackup-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASS}
      MYSQL_DATABASE: ${DB_NAME:-backup_manager}
      MYSQL_USER: ${DB_USER:-backupuser}
      MYSQL_PASSWORD: ${DB_PASS}
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "127.0.0.1:3307:3306"
    networks: [dbbackup-network]
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${DB_ROOT_PASS}"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 30s

  redis:
    image: redis:7-alpine
    container_name: dbbackup-redis
    restart: unless-stopped
    command: >
      redis-server --appendonly yes --requirepass ${REDIS_PASS:-}
      --maxmemory 256mb --maxmemory-policy allkeys-lru
    volumes:
      - redis_data:/data
    networks: [dbbackup-network]
    healthcheck:
      test: ["CMD", "sh", "-c", "redis-cli ${REDIS_PASS:+-a $REDIS_PASS} ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mysql_data:
  redis_data:

networks:
  dbbackup-network:
    driver: bridge
⁠2. Buat .env
# Timezone
TZ=Asia/Jakarta

# Database MySQL
DB_ROOT_PASS=ganti_password_root_kuat
DB_USER=backupuser
DB_PASS=ganti_password_user_kuat
DB_NAME=backup_manager

# Redis
REDIS_PASS=ganti_redis_password

# Security — WAJIB DIISI
# Generate: openssl rand -hex 32
JWT_SECRET=
# TEPAT 32 karakter: openssl rand -hex 16
ENCRYPTION_KEY=

# URL — sesuaikan dengan IP/domain server
PORT=4000
FRONTEND_PORT=3001
FRONTEND_URL=http://IP_ATAU_DOMAIN:3001
CORS_ORIGINS=http://IP_ATAU_DOMAIN:3001
NEXT_PUBLIC_API_URL=http://IP_ATAU_DOMAIN:4000

# Google OAuth (opsional — untuk Cloud Storage Google Drive)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=http://IP_ATAU_DOMAIN:4000/api/storages/google/callback

# Lisensi (kosongkan = mode development tanpa validasi)
LICENSE_SERVER_URL=https://license.alfi-gusman.web.id
LICENSE_PUBLIC_KEY=

LOG_LEVEL=info
⁠3. Jalankan
docker compose pull
docker compose up -d
docker compose ps

Buka http://IP_ATAU_DOMAIN:3001 dan login dengan akun default.


⁠Environment Variables

VariableWajibDefaultKeterangan
DB_HOST✅—Host MySQL (nama service docker: mysql)
DB_USER✅backupuserUsername MySQL
DB_PASS✅—Password MySQL
DB_NAME✅backup_managerNama database aplikasi
REDIS_HOST✅—Host Redis (nama service docker: redis)
REDIS_PASS——Password Redis
JWT_SECRET✅—Secret JWT (openssl rand -hex 32)
ENCRYPTION_KEY✅—Kunci enkripsi AES, tepat 32 karakter (openssl rand -hex 16)
CORS_ORIGINS✅—Origin frontend (contoh: http://localhost:3001)
FRONTEND_URL✅—URL frontend (untuk redirect OAuth)
TZ—Asia/JakartaTimezone server (IANA format)
LOG_LEVEL—infoLevel log: debug / info / warn / error
JWT_EXPIRED_IN—7dMasa berlaku token JWT
LICENSE_SERVER_URL——URL server lisensi (kosong = dev mode)
LICENSE_PUBLIC_KEY——Public key RS256 untuk verifikasi lisensi
GOOGLE_CLIENT_ID——Google OAuth Client ID (untuk Google Drive)
GOOGLE_CLIENT_SECRET——Google OAuth Client Secret
GOOGLE_REDIRECT_URI——Google OAuth redirect URI

⁠API Endpoints

MethodEndpointKeterangan
GET/healthHealth check — no auth
GET/docsSwagger UI — dokumentasi API interaktif
POST/api/auth/loginLogin, mendapatkan JWT
GET/POST/api/connectionsKelola koneksi database
POST/api/connections/:id/testTest koneksi & list database
GET/POST/api/storagesKelola cloud storage
POST/api/storages/:id/testTest koneksi storage
GET/POST/api/jobsKelola backup jobs
POST/api/jobs/:id/runTrigger backup manual
GET/POST/api/schedulesKelola jadwal cron
GET/api/logsRiwayat eksekusi backup
GET/api/license/statusStatus lisensi
POST/api/license/activateAktivasi lisensi

⁠Akun Default

RoleEmailPassword
Admin[email protected]Admin2026!
Operator[email protected]Operator2026!
Viewer[email protected]Viewer2026!

⚠️ Segera ganti semua password setelah install pertama kali!


⁠Tags

TagKeterangan
latestBuild terbaru dari branch production
sha-<7char>Build spesifik berdasarkan commit SHA
v1.2.3Release versi tertentu
v1.2Minor version terbaru

⁠Arsitektur Backup

POST /api/jobs/:id/run
  → BullMQ Queue (Redis)
      → backupService
          1. Verify connection + storage      (progress 10%)
          2. mysqldump / pg_dump → stream     (progress 20%)
          3. createGzip → compress in-memory  (progress 50%)
          4. upload stream → cloud storage    (progress 100%)
          → simpan cloud_path + download_url
          → kirim notifikasi WhatsApp

⁠Panduan Instalasi Lengkap

Tersedia di: bm.alfi-gusman.web.id/docs⁠


⁠Lisensi

Aplikasi ini memerlukan lisensi untuk penggunaan production. Informasi langganan: hubungi tim kami.

Tag summary

Content type

Image

Digest

sha256:7b44558d0…

Size

96.8 MB

Last updated

17 days ago

docker pull alfigusman0/backend-dbbackup