AGC Dracin

Appearance

Panduan Lengkap Instalasi & Operasional Dracin ​

Panduan ini adalah dokumentasi resmi standar untuk seluruh pembeli platform Dracin. Anda dipandu langkah demi langkah memasang dan mengoperasikan website streaming video drama di server VPS sendiri secara mandiri, aman, dan tanpa hambatan teknis.

🌟 Mengapa Menggunakan VPS Mandiri (Self-Hosted)? ​

Dengan arsitektur mandiri Dracin:

  • Biaya Sangat Terjangkau: Cukup menyewa VPS mulai seharga $3 – $5 per bulan (sekitar Rp 50.000 – Rp 80.000/bulan) dari penyedia manapun tanpa biaya langganan cloud internasional yang mahal.
  • Zero Runtime di Laptop: Anda tidak perlu memasang PHP, Composer, Node.js, Go, Python, Docker, atau Git di komputer Anda.
  • Tanpa Perintah Terminal Rumit: Seluruh proses instalasi dijalankan melalui antarmuka web peramban (web browser wizard) lokal yang intuitif.
  • Database Terintegrasi: Menggunakan SQLite modern yang cepat, hemat memori (~52 MB), dan tidak memerlukan instalasi server database terpisah.
  • Otomatisasi SSL/TLS: Sertifikat keamanan HTTPS dari Let's Encrypt dipasang secara gratis dan diperbarui secara otomatis.
  • Aman & Terlindungi: Kredensial server Anda diproses langsung dari laptop ke VPS tanpa perantara pihak ketiga, dengan penyensoran otomatis kata sandi pada jendela log.

📋 Checklist Prasyarat Sebelum Memulai ​

Sebelum menjalankan instalasi, pastikan Anda telah menyiapkan 4 hal berikut:

  1. Komputer atau Laptop Pribadi:
    • Sistem operasi Windows 10/11, macOS (Apple Silicon M1/M2/M3/M4 atau Intel), atau Linux.
    • Peramban web modern (Google Chrome, Mozilla Firefox, Microsoft Edge, atau Safari).
  2. Satu Unit Server VPS Bersih (Fresh):
    • Sistem Operasi: Ubuntu 24.04 LTS (64-bit) (Wajib & Sangat Disarankan).
    • Spesifikasi Minimal: 1 Core CPU, 1 GB RAM, 10 GB Penyimpanan SSD.
    • Penyedia Rekomendasi: Hetzner, Contabo, DigitalOcean, Linode, Vultr, Niagahoster, atau DomaiNesia.
  3. Data Akses SSH Server VPS Anda:
    • Alamat IP Server (contoh: 167.86.108.118).
    • Port SSH (standar 22, atau port khusus seperti 20700).
    • Username (root atau username dengan hak sudo).
    • Password Root (kata sandi yang diberikan penyedia VPS).
  4. Nama Domain yang Sudah Aktif:
    • Contoh: nontondrama.com atau subdomain seperti drama.domainanda.com.

🌐 Tahap 1: Pengaturan DNS Domain (Mengarahkan Domain ke VPS) ​

Sebelum instalasi web dijalankan, domain Anda perlu diarahkan ke alamat IP VPS Anda agar pengunjung dapat membuka website Anda.

A. Pengaturan di Cloudflare: ​

  1. Masuk ke dashboard Cloudflare dan pilih domain Anda.
  2. Buka menu DNS > Records.
  3. Klik tombol Add record dan isi:
    • Type: A
    • Name: @ (untuk domain utama) atau nama subdomain (misal drama).
    • IPv4 address: Masukkan alamat IP VPS Anda (contoh: 167.86.108.118).
    • Proxy status:
      • Pilih DNS Only (awan abu-abu) jika ingin menggunakan sertifikat SSL Let's Encrypt otomatis dari VPS.
      • Atau pilih Proxied (awan oranye) jika ingin memanfaatkan CDN dan proteksi SSL Cloudflare (Flexible/Full).
    • TTL: Auto.
  4. Klik Save.

B. Pengaturan di cPanel / Niagahoster / Hostinger / Namecheap / DomaiNesia: ​

  1. Buka menu DNS Zone Editor atau Manage DNS di panel tempat Anda membeli domain.
  2. Tambahkan atau ubah A Record:
    • Host/Name: @ (atau drama)
    • Points to / Value: Masukkan alamat IP VPS Anda.
    • TTL: 14400 atau Auto.
  3. Klik simpan. (Tunggu sekitar 5 – 15 menit agar DNS tersebar. Anda dapat memeriksa statusnya di situs dnschecker.org).

📥 Tahap 2: Mengunduh Berkas & Verifikasi Integritas (Checksum) ​

Unduh paket instalasi Dracin dari portal rilis resmi Dojo (dojo.cc):

Sistem Operasi Laptop AndaBerkas LauncherBerkas Paket Aplikasi
Windows (10 / 11)dracin-launcher-windows-amd64.exedracin-v1.0.0.tar.gz
macOS Apple Silicon (M1/M2/M3/M4)dracin-launcher-darwin-arm64dracin-v1.0.0.tar.gz
macOS Intel Coredracin-launcher-darwin-amd64dracin-v1.0.0.tar.gz
Linux (Ubuntu/Debian/Fedora)dracin-launcher-linux-amd64dracin-v1.0.0.tar.gz

Simpan berkas-berkas tersebut dalam satu folder yang sama di komputer Anda (misalnya di folder Downloads/dracin atau Desktop/dracin).

(Opsional namun Disarankan) Memeriksa Hash SHA-256: ​

  • Di Windows (PowerShell):
    powershell
    Get-FileHash dracin-launcher-windows-amd64.exe -Algorithm SHA256
  • Di macOS / Linux (Terminal):
    bash
    shasum -a 256 dracin-launcher-darwin-arm64

Cocokkan nilai hash yang muncul dengan berkas SHA256SUMS. Jika cocok, berkas Anda 100% aman dan utuh.

🛡️ Tahap 3: Menjalankan Launcher & Melewati Peringatan Keamanan OS ​

Karena aplikasi launcher Dracin belum didaftarkan pada sertifikat komersial berbayar (status unsigned), sistem operasi Anda mungkin akan menampilkan dialog peringatan keamanan saat pertama kali dibuka:

Windows SmartScreenKlik 'More info' lalu 'Run anyway'macOS GatekeeperBuka System Settings > Privacy & Security > Open AnywayTindakanTindakan

Panduan Windows: ​

  1. Klik dua kali berkas dracin-launcher-windows-amd64.exe.
  2. Jika muncul jendela biru Windows protected your PC:
    • Klik teks "More info" (Informasi selengkapnya).
    • Klik tombol "Run anyway" (Tetap jalankan).
  3. Peramban web Anda (Chrome/Edge) akan otomatis membuka halaman wizard Dracin.

Panduan macOS: ​

  1. Buka System Settings > Privacy & Security > Gulir ke bagian Security.
  2. Di samping pemberitahuan pemblokiran launcher, klik tombol "Open Anyway" (Tetap Buka).
  3. Masukkan kata sandi Mac atau Touch ID Anda untuk mengonfirmasi.
  4. (Alternatif via Terminal):
    bash
    chmod +x dracin-launcher-darwin-arm64
xattr -d com.apple.quarantine dracin-launcher-darwin-arm64
./dracin-launcher-darwin-arm64

Panduan Linux: ​

Buka terminal di folder unduhan, berikan izin eksekusi, lalu jalankan:

bash
chmod +x dracin-launcher-linux-amd64
./dracin-launcher-linux-amd64

🧙 Tahap 4: Langkah demi Langkah di Web Wizard Browser ​

Launcher akan membuka peramban web pada alamat lokal tertutup: http://127.0.0.1:28410/?token=...

Langkah 1: Kredensial Server VPS- Masukkan IP, Port SSH, User, Password- Klik tombol 'Uji Koneksi SSH Live'Langkah 2: Domain, Aplikasi & SSL- Isi domain (misal drama.domainanda.com)- Masukkan email untuk SSL Let's Encrypt- Atau centang opsi Cloudflare Proxy- Centang 'Simpan ke .env.deploy'Langkah 3: Eksekusi Otomatis & Monitor- Pilih 'Instalasi Baru (Fresh Install)'- Klik 'Mulai Instalasi Baru'- Pantau 6 progress bar & log tersamarkanLangkah 4: Sukses & Live!- Buka website via tautan HTTPS- Website live 24 jam nonstopIndikator Hijau Lolos UjiKonfigurasi ValidSelesai 100%

Langkah 1: Memasukkan Kredensial VPS ​

  • IP VPS / Hostname: Masukkan IP server Anda (contoh: 167.86.108.118).
  • Port SSH: Isi 22 (atau port khusus seperti 20700).
  • SSH User: Gunakan root (atau username dengan hak sudo).
  • Password SSH: Masukkan password VPS Anda.
  • Tombol "Uji Koneksi SSH Live":
    • Klik tombol ini! Launcher akan langsung menyapa server VPS Anda tanpa mengubah apapun.
    • Jika berhasil, muncul lampu hijau beserta spesifikasi OS (Ubuntu 24.04), arsitektur CPU, dan latensi jaringan server.

Langkah 2: Mengatur Domain, Aplikasi & Keamanan SSL/TLS ​

  • Domain Aplikasi: Masukkan nama domain Anda (contoh: drama.domainanda.com).
  • Direktori Aplikasi: Biarkan default (/var/www/dracin).
  • Otomatisasi Sertifikat SSL / HTTPS (Let's Encrypt):
    • Email untuk Let's Encrypt: Masukkan email Anda (misal admin@domainanda.com). Digunakan oleh otoritas Let's Encrypt untuk registrasi dan pemberitahuan masa berlaku.
    • Checkbox "Gunakan Cloudflare Proxy / Lewati Let's Encrypt":
      • Centang jika domain Anda menggunakan CDN Cloudflare dengan mode SSL Proxy (awan oranye / Flexible / Full) atau jika Anda memasang sertifikat sendiri.
      • Biarkan tidak tercentang jika ingin sertifikat SSL Let's Encrypt dipasang langsung di server VPS. Pre-flight DNS check otomatis akan memvalidasi kecocokan IP domain dengan VPS sebelum memanggil Certbot untuk mencegah pemblokiran rate limit.
  • Simpan ke .env.deploy:
    • Pastikan opsi ini dicentang agar Anda tidak perlu mengetik ulang data server saat melakukan update di masa mendatang.

Langkah 3: Eksekusi Instalasi Otomatis ​

  • Pada pilihan jenis operasi, pilih "Instalasi Baru (Fresh Install)".
  • Klik tombol "Mulai Instalasi Baru".
  • Anda dapat memantau indikator visual 6 tahapan:
    1. Validasi Sistem: Memeriksa kelengkapan parameter server dan berkas rilis.
    2. Bootstrap Server: Memasang otomatis Nginx, PHP 8.4, pustaka SQLite, dan modul pendukung.
    3. Ekstraksi Rilis: Mengunggah dan mengekstrak berkas aplikasi Dracin.
    4. Migrasi Database: Menyiapkan struktur tabel database dan akun.
    5. Konfigurasi SSL/TLS: Validasi pre-flight DNS, penerbitan sertifikat SSL Let's Encrypt, dan pengaktifan HTTP/2.
    6. Health Check Live: Menguji endpoint /up dan memastikan web server melayani halaman depan Dracin dengan status 200 OK.
  • Keamanan Layar: Seluruh kata sandi, token, dan kunci enkripsi secara otomatis disamarkan dengan tulisan [SECRET MASKED].

Selesai: Buka Website Dracin Anda! ​

Begitu proses mencapai 100%, layar sukses akan muncul:

  • Klik tombol hijau bertuliskan "Buka Dracin Sekarang". Website baru Anda akan langsung terbuka di tab peramban baru dengan koneksi aman HTTPS!
  • Anda dapat menutup jendela launcher di laptop Anda kapan saja; website Anda di VPS akan tetap menyala 24 jam nonstop.

🔄 Tahap 5: Cara Melakukan Pembaruan Rilis di Masa Depan (Update) ​

Ketika Dracin merilis versi baru (misalnya versi v2.0.0):

  1. Unduh berkas paket rilis terbaru (dracin-v2.0.0.tar.gz).
  2. Jalankan aplikasi Dracin Launcher di komputer Anda seperti biasa.
  3. Karena konfigurasi sebelumnya tersimpan di .env.deploy, formulir IP, port, dan domain akan otomatis terisi.
  4. Pada pilihan operasi, pilih "Update Rilis Baru".
  5. Klik tombol "Mulai Update Rilis".

Keamanan Otomatis Saat Update: ​

  • Pencadangan Database Otomatis (Pre-Migration Backup): Sebelum migrasi skema baru dijalankan, launcher secara otomatis membuat salinan cadangan (backup snapshot) dari database SQLite Anda.
  • Zero-Downtime Atomic Switch: Versi baru disiapkan di direktori terpisah. Begitu siap, Nginx dialihkan ke versi baru secara instan tanpa membuat website error.
  • Proteksi Rollback Instan: Jika versi baru gagal booting, sistem dapat dikembalikan ke rilis sebelumnya dalam 1 klik.

💾 Tahap 6: Panduan Pencadangan (Backup) & Pemulihan (Restore) SQLite ​

Seluruh data website Anda (pengguna, riwayat tontonan, katalog drama, episode) tersimpan dalam satu berkas tunggal yang sangat mudah dipindahkan.

1. Lokasi Data di VPS ​

  • Berkas database aktif: /var/www/dracin/shared/database/database.sqlite
  • Folder backup otomatis: /var/www/dracin/shared/database/backups/(Setiap backup otomatis diberi nama dengan nomor rilis dan tanggal, contoh: database_2_20261015_164204.sqlite).

2. Cara Mengunduh Backup ke Laptop Pribadi (FileZilla / SFTP): ​

  1. Buka aplikasi FileZilla di laptop Anda.
  2. Masukkan kredensial:
    • Host: sftp://IP_VPS_ANDA
    • Username: root
    • Password: Password VPS Anda
    • Port: Port SSH Anda (misal 22 atau 20700)
  3. Buka folder /var/www/dracin/shared/database/.
  4. Tarik (drag-and-drop) berkas database.sqlite atau folder backups/ ke komputer Anda.

3. Cara Melakukan Pemulihan (Restore) Database: ​

Jika ingin mengembalikan database dari berkas backup:

Cara A (Menggunakan Skrip Deployer di VPS):

bash
/var/www/dracin/current/scripts/deploy-release.sh --restore-db /var/www/dracin/shared/database/backups/database_NAMA_BACKUP.sqlite

Cara B (Menimpa File via FileZilla / SFTP):

  1. Salin berkas cadangan dan beri nama database.sqlite.
  2. Unggah ke folder /var/www/dracin/shared/database/ di VPS Anda (timpa berkas yang ada).
  3. Berikan izin akses yang sesuai di terminal VPS:
    bash
    chown dracin:www-data /var/www/dracin/shared/database/database.sqlite
chmod 0664 /var/www/dracin/shared/database/database.sqlite

💰 Tahap 7: Konfigurasi Monetisasi & Pengukuran Trafik (Iklan & Analitik) ​

Setelah website Anda berhasil live dan dapat diakses publik, Anda dapat memasang jaringan periklanan (seperti Google AdSense, Adsterra, PropellerAds) dan skrip pelacak statistik pengunjung (seperti Histats atau Google Analytics 4).

Dracin menyediakan arsitektur monetisasi mandiri berbasis 5 slot template parsial di direktori:

text
/var/www/dracin/current/resources/views/partials/monetization/
Slot PartialLokasi Render di WebsiteContoh Penggunaan
head-scripts.blade.phpDi dalam tag <head>Google AdSense Auto-Ads, Google Tag Manager, Search Console
body-top.blade.phpDi atas navigasi headerBanner Leaderboard (728x90) / Banner Promo Atas
video-top.blade.phpTepat di atas pemutar videoBanner Persegi (300x250) / Leaderboard (728x90)
video-bottom.blade.phpDi bawah pemutar / daftar episodeNative Banner Ads Widget / Banner Afiliasi
footer-scripts.blade.phpSebelum penutup </body>Histats Counter, Google Analytics 4, Adsterra Popunder / Social Bar

📖 Panduan Lengkap: Pelajari tata cara edit berkas via SFTP/FileZilla, panduan ukuran banner responsif, contoh kode siap pakai, dan tips anti-rusak tata letak pada dokumen resmi: 👉 Panduan Komprehensif Monetisasi & Pengukuran Trafik (docs/monetization.md).

❓ Tahap 8: Panduan Pemecahan Masalah (Troubleshooting) ​

Gejala MasalahPenyebab UmumSolusi Langkah demi Langkah
Uji SSH Gagal: "Connection Refused"Port SSH salah atau firewall server memblokir koneksi.1. Periksa port SSH pada dashboard hosting Anda (misal Contabo/panel tertentu menggunakan port non-22).
2. Pastikan port tersebut diisi dengan benar di wizard.
Uji SSH Gagal: "Permission Denied"Salah mengetik password atau VPS hanya mengizinkan SSH Key.1. Ketik ulang password root dengan teliti tanpa spasi tambahan.
2. Jika VPS diatur hanya menerima SSH Key, pilih opsi "SSH Private Key" pada wizard dan pilih file kunci .pem / id_rsa Anda.
Peringatan Pre-flight DNS SSL MismatchA-Record domain belum tersebar atau menggunakan Cloudflare Proxy.1. Jika baru membuat DNS, tunggu 5-15 menit agar DNS tersebar lalu coba lagi.
2. Jika menggunakan Cloudflare dengan awan oranye aktif, centang opsi "Gunakan Cloudflare Proxy / Lewati Let's Encrypt" di wizard.
3. Buka dnschecker.org untuk memastikan domain mengarah ke IP VPS Anda.
Website Tidak Bisa Dibuka (ERR_CONNECTION_TIMED_OUT)Port web HTTP (80) dan HTTPS (443) diblokir oleh firewall VPS.Buka terminal/konsol VPS dan izinkan port web:
ufw allow 80/tcp
ufw allow 443/tcp
ufw reload
Jika menggunakan Cloud Security Group (AWS/GCP/Alibaba), buka port 80 dan 443 di panel cloud.
Muncul Tampilan "502 Bad Gateway"Layanan PHP-FPM di VPS sedang berhenti atau sedang memuat ulang.Buka terminal VPS dan restart layanan:
systemctl restart php8.4-fpm
systemctl restart nginx
Ingin Membatalkan Pembaruan (Rollback ke Versi Lama)Versi baru yang dipasang ingin dikembalikan ke versi sebelumnya.Buka kembali Dracin Launcher di laptop, pilih operasi "Rollback Rilis", lalu klik "Mulai Rollback". Sistem akan mengalihkan symlink kembali ke rilis sebelumnya secara instan.

📞 Bantuan & Dokumentasi Teknis Lanjutan ​

Untuk spesifikasi sistem tingkat lanjut:

Selamat mengoperasikan platform streaming Dracin di server mandiri Anda!

AGC Dracin — Platform streaming drama mandiri berkinerja tinggi untuk komunitas Dojo.