☁️
ZippBiz Cloud Manager
Buku Panduan Setup • Penyimpanan Cloud Native Studio
🔍
🚀 Buka Studio
Buku Panduan Visual & Setup Cepat • 100% Zero-D1

Panduan Setup & Penggunaan ZippBiz Cloud Manager

Selamat datang di panduan resmi ZippBiz Cloud Manager. Software penyimpanan aset multimedia bisnis pribadi berkecepatan tinggi bertenaga Penyimpanan Cloud dengan 0 biaya bandwidth keluar selamanya (bebas kuota egress).

⚡ 100% Zero-D1 (Murni R2-Native)
💸 Biaya Server Rp 0 / Bulan
🖼️ Auto-Kompresi WebP Client-Side
🛡️ Proteksi Password Master
🌐 CDN Global Kecepatan Tinggi
1

Arsitektur Zero-D1 & Persiapan Awal

Mengenal keunggulan Cloud Manager dan apa saja yang perlu disiapkan sebelum memasang.

Berbeda dengan sistem penyimpanan tradisional yang memerlukan database terpisah untuk mencatat nama dan direktori berkas, ZippBiz Cloud Manager mengadopsi arsitektur 100% Zero-D1. Seluruh metadata direktori, struktur folder virtual, dan atribut media dibaca langsung secara native dari bucket Penyimpanan Cloud.

🎁
Kuota Gratis Penyimpanan Cloud
Setiap akun Cloudflare gratis mendapatkan 10 GB kapasitas penyimpanan per bulan, 10 juta permintaan baca, dan 1 juta permintaan tulis tanpa biaya sepeser pun.
🚀
Nol Biaya Egress (Free Bandwidth)
Di AWS S3 atau Google Cloud, Anda dikenakan biaya setiap kali pengunjung melihat gambar/video. Di Penyimpanan Cloud, kuota transfer bandwidth keluar 100% gratis selamanya.
💻
Dukungan Dua Layar (Split Screen)
Buka halaman panduan ini di satu sisi layar dan dashboard Cloudflare di sisi layar lainnya untuk proses pemasangan yang cepat dan praktis.
💡
Persiapan: Anda hanya memerlukan 1 akun gratis di Cloudflare Dashboard dan akses ke project Cloudflare Pages Anda.
🧭

Pilih Jalur Pemasangan Anda:

Tentukan panduan yang sesuai dengan kondisi website Anda saat ini.

JALUR 1 (UTAMA) Sudah Punya Website ZippBiz?

Jika Anda sudah memiliki toko aktif di [namatoko].pages.dev, Anda TIDAK PERLU membuat project Pages baru (lewati Langkah 2).

✓ Cukup buat R2 Bucket (Langkah 1)
✓ Sambungkan R2 ke Pages Toko yang ada (Langkah 3)
✓ Buka Admin ➔ Pengaturan ➔ Update ZippBiz ➔ klik Update Otomatis untuk aktivasi instan!
JALUR 2 (MANDIRI) Belum Punya Website Pages?

Jika belum punya atau ingin membuat Cloud Manager terpisah khusus tim media / agensi:

1. Buat R2 Bucket terlebih dahulu (Langkah 1)
2. Buat project Pages via Direct Upload ZIP (Langkah 2)
3. Sambungkan R2 Bucket (Langkah 3) & buat password master!
2

Langkah 1: Buat R2 Bucket di Cloudflare (Hanya 1 Kali)

Membuat wadah penyimpanan fisik di Penyimpanan Cloud.

  • 1
    Masuk ke akun Cloudflare Anda melalui https://dash.cloudflare.com.
  • 2
    Pada menu samping sebelah kiri, pilih dan klik menu Storage & Databases → R2 (atau R2 Object Storage).
    📸 Tangkapan Layar: Menu R2 Object Storage
    Langkah 1 - Buat R2 Object Storage
  • 3
    Klik tombol biru Create Bucket di pojok kanan atas.
    📸 Tangkapan Layar: Tombol Create Bucket
    Langkah 2 - Create Bucket
  • 4
    Beri nama bucket penyimpanan Anda (contoh: r2zippbiz atau media-tokosaya).
    ⚠️
    Gunakan huruf kecil tanpa spasi. Anda boleh menggunakan tanda strip (kebab-case) jika diperlukan.
  • 5
    Biarkan lokasi bucket default (Automatic), lalu klik Create Bucket di bagian bawah. Selesai!
    📸 Tangkapan Layar: Form Nama Bucket & Klik Create Bucket
    Langkah 3 - Ketik Nama Bucket & Klik Create Bucket
3

Langkah 2: Pasang Cloud Manager di Cloudflare Pages

Mengunggah paket web mandiri menggunakan fitur Direct Upload Cloudflare Pages.

  • 1
    Di menu samping kiri Cloudflare Dashboard, klik Compute (Workers & Pages) → Pages.
  • 2
    Klik tombol Create application, lalu pilih tab Direct Upload.
  • 3
    Beri nama proyek aplikasi Anda (contoh: cloud-media-studio atau media-vault), lalu klik Create project.
  • 4
    Ekstrak berkas ZippBiz-CloudManager-Starter-Package.zip di komputer Anda. Anda akan melihat berkas:
    index.html, app.js, style.css, _worker.js, _headers, wrangler.toml
    Seret dan lepaskan seluruh berkas tersebut ke area upload Cloudflare Pages.
  • 5
    Klik tombol hijau Deploy site. Tunggu sekitar 5-10 detik hingga proses deployment selesai 100%.
4

Langkah 3: Sambungkan R2 Bucket ke Pages (Sangat Kritis)

Memberikan izin Cloudflare Pages Worker untuk membaca dan menulis berkas ke R2 Bucket Anda.

🚨
Perhatian Penting: Nama variabel binding wajib R2 (huruf besar semua). Jangan diberi nama lain karena script worker sistem mendeteksi env.R2 secara otomatis.
  • 1
    Masuk ke Project Pages: Di dashboard Cloudflare, buka menu Compute (Workers & Pages) → Pages, lalu klik nama project Pages toko Anda (misal: tokosaya).
    📸 Tangkapan Layar: Pilih Nama Project Pages
    Langkah 4 - Pilih Nama Pages
  • 2
    Pilih tab Settings di menu navigasi atas → pilih sub-menu Functions di kolom sebelah kiri.
    📸 Tangkapan Layar: Tab Settings -> Functions
    Langkah 5 - Pilih Setting Functions
  • 3
    Gulir halaman ke bawah hingga menemukan bagian R2 Bucket Bindings, lalu klik tombol + Add (atau Add binding).
    📸 Tangkapan Layar: Seksi Bindings -> Klik + Add
    Langkah 6 - Cari Bindings Klik Add
  • 4
    Pilih tipe R2 bucket binding, lalu isi kolom konfigurasi dengan teliti:
    Variable name: R2 (Wajib Huruf Besar Semua!)
    • R2 bucket: Pilih nama bucket yang Anda buat di Langkah 1 (contoh: media-tokosaya).
    📸 Tangkapan Layar: Scroll ke R2 Bucket -> Klik R2
    Langkah 7 - Scroll Sampai R2 Klik R2
  • 5
    Klik tombol biru Save. Cloudflare kini telah mengikat bucket R2 ke project Pages Anda.
  • ⚡
    AKTIVASI SAMBUNGAN INSTAN (UNTUK PEMILIK TOKO ZIPPBIZ):

    Pada Cloudflare Pages tipe Direct Upload, tombol Retry deployment tidak tersedia (yang ada hanya opsi Rollback yang membingungkan). Agar binding R2 langsung aktif 100%:

    ➔ Buka Admin Toko (/admin.html) → Masuk menu Pengaturan ➔ Update ZippBiz → Klik Update Otomatis (Stable).

    Cloudflare akan otomatis memicu deployment baru dan menyuntikkan sambungan R2 seketika. Buka menu Media atau akses /cloud-manager, status langsung: 🟢 CDN Penyimpanan Cloud Terhubung!

5

Langkah 4: Buka Website & Buat Password Master

Mengunci akses studio pribadi Anda dengan proteksi kata sandi.

  • 1
    Buka alamat URL Pages yang diberikan Cloudflare (contoh: https://cloud-media-studio.pages.dev).
  • 2
    Saat pertama kali dibuka, sistem otomatis mendeteksi bahwa studio belum memiliki master key dan menampilkan layar:
    "Setup ZippBiz Cloud Manager — Buat Password Master"
  • 3
    Masukkan password master yang Anda kehendaki (minimal 6 karakter, kombinasi huruf dan angka disarankan).
  • 4
    Klik tombol Aktifkan & Masuk Studio.
  • 5
    Selamat! Studio Cloud Manager pribadi Anda kini aktif, aman, dan siap digunakan untuk mengelola ribuan aset digital bisnis Anda.
6

Manajemen Folder & Pohon Direktori (Explorer Style)

Menata ribuan gambar dan video seperti menggunakan Windows Explorer.

Cloud Manager dilengkapi panel pohon direktori di sebelah kiri yang memungkinkan Anda mengorganisasi file berdasarkan kategori toko, kampanye promo, modul produk, atau arsip klien.

📁
Buat Folder & Sub-Folder
Klik ikon + di header Pohon Folder untuk membuat folder baru. Anda dapat membuat sub-folder bertingkat tanpa batas kedalaman.
🎯
Drag & Drop ke Folder
Tarik file dari komputer langsung dan jatuhkan ke atas nama folder di pohon kiri untuk mengunggah otomatis ke folder target.
🔄
Pindahkan Berkas Instan
Gunakan fitur Pindahkan (Move) untuk memindahkan file dari satu folder ke folder lain tanpa perlu mengunduh dan mengunggah ulang.
7

Unggah Cepat & Kompresi Otomatis WebP

Menghemat hingga 85% kapasitas penyimpanan dan mempercepat loading website pelanggan.

Setiap gambar JPEG atau PNG berukuran besar yang Anda unggah dapat otomatis dikonversi menjadi format generasi terbaru WebP secara langsung di browser Anda sebelum dikirim ke R2:

  • •
    Drag & Drop Multi-Berkas: Seret puluhan file sekaligus dari file explorer komputer langsung ke bidang tengah Cloud Manager.
  • •
    Client-Side Engine: Kompresi terjadi di browser pengguna dengan memanfaatkan HTML5 Canvas & WebAssembly sehingga tidak membebani server dan tidak memakan kuota CPU worker.
  • •
    Filter Kategori Cepat: Gunakan tombol pill di bagian atas (Semua, Gambar, Video, PDF) untuk menyaring aset media dengan 1 klik.
8

Salin Direct CDN URL & Kode Embed

Menggunakan aset media di website, toko online, WhatsApp, atau landing page.

Setiap kali Anda mengklik salah satu berkas di daftar media, panel inspektor di sisi kanan akan menampilkan rincian teknis berkas serta tombol salin instan:

🔗
Direct Public CDN Link
URL langsung yang dapat Anda pasang di browser, katalog e-commerce, atau pesan siaran WhatsApp broadcast.
🏷️
HTML Image & Video Tag
Salin kode <img src="..."> atau <video> yang siap ditempelkan ke Page Builder, WordPress, atau kode HTML kustom.
📥
Unduh Asli (Download)
Mengunduh kembali berkas asli beresolusi penuh ke perangkat Anda kapan saja tanpa kompresi tambahan.
9

Troubleshooting & Pertanyaan Umum (FAQ)

Solusi cepat untuk kendala yang mungkin Anda temui saat setup.

?
Galat: "R2 Binding Not Found" atau "Bucket R2 Belum Terhubung"
Penyebab utama: Nama variabel binding di Cloudflare Pages Settings → Functions bukan huruf besar R2. Pastikan namanya tepat R2 (tanpa spasi dan bukan huruf kecil).
?
Apakah saya bisa menggunakan Domain Sendiri (Custom Domain)?
Tentu saja! Di menu proyek Cloudflare Pages Anda, buka tab Custom domains → klik Set up a custom domain → masukkan subdomain yang diinginkan (misal: media.tokobisnis.com).
?
Bagaimana jika saya lupa Password Master?
Karena arsitektur Zero-D1 menyimpan kredensial di header konfigurasi R2 bucket, Anda dapat menghapus objek konfigurasi .sys/auth_master.json langsung dari dashboard Penyimpanan Cloud untuk memicu form setup password baru.