Panduan penyiapan Studio Bisnis saya sudah memakai Cloudflare

Tambahkan Studio ke akun Cloudflare bisnis Anda

Jika domain perusahaan Anda sudah dikelola di Cloudflare, Studio dapat dipasang di akun yang sama, berdampingan dengan situs web Anda. Studio mendapat alamat workers.dev gratis tersendiri dan, jika Anda mau, subdomain baru dari domain Anda. Situs web Anda dan record DNS-nya tetap persis seperti semula.

Terbaik untuk: Bisnis yang domainnya sudah dikelola di Cloudflare.
Yang Anda butuhkan: Maxisnap untuk Windows atau Mac, yang sudah masuk dengan akun yang memiliki Studio; login ke akun Cloudflare perusahaan Anda yang dapat menambahkan Workers, atau orang yang mengurusnya; serta asisten coding AI di komputer Anda, atau terminal dengan Node.js 20 atau yang lebih baru.
Waktu: Sekitar 20 menit untuk pertama kali.
Yang Anda dapatkan: Studio di alamat workers.dev miliknya sendiri, ditambah subdomain baru seperti snaps.yourcompany.com jika Anda menginginkannya. Situs web Anda tetap persis seperti semula.
Biaya: Studio dibuat untuk berjalan di paket gratis Cloudflare. Cloudflare menerbitkan kuota gratis dan harga R2 yang berlaku saat ini.

Apa yang ditambahkan Studio, dan apa yang dibiarkannya

Studio menambahkan

Aplikasi Studio itu sendiri (Cloudflare menyebutnya “Worker”)
Ruang penyimpanan untuk tangkapan Anda (sebuah “R2 bucket”)
Database kecil untuk pustaka dan tim Anda (“D1”)
Alamatnya di workers.dev, ditambah satu subdomain baru jika Anda memilihnya
Nama workers.dev akun Anda, jika belum punya (satu nama untuk seluruh akun)

Studio tidak menyentuh

Situs web Anda beserta filenya
Record DNS yang sudah ada pada domain Anda
Worker, penyimpanan, atau database lain apa pun
Penagihan dan pengaturan akun Anda yang lain

Jika suatu nama sudah dipakai, Studio memilih nama lain atau meminta Anda memilihnya; Studio tidak menggantikan sesuatu yang sudah ada.

Jika orang lain yang mengurus Cloudflare atau situs web Anda, tanyakan dulu kepada mereka. Sebagian perusahaan memiliki aturan tentang siapa yang boleh menambahkan layanan ke akun perusahaan, atau memasang halaman masuk di depan setiap subdomain, yang akan memblokir unggahan Maxisnap.

Bagikan ringkasan teknis kepada orang yang mengurus Cloudflare Anda.

Pastikan penyimpanan sudah aktif

Studio menyimpan tangkapan Anda di Cloudflare R2. Masuk ke akun Cloudflare perusahaan Anda dan periksa satu kali:

Di dasbor Cloudflare, buka Storage & databases → R2 → Overview.
Jika Cloudflare menawarkan untuk menambahkan R2, selesaikan checkout-nya. Jika Anda bukan penanggung jawab penagihan akun tersebut, minta mereka melakukan langkah ini.

Dasbor Studio Anda menunjukkan seberapa banyak penyimpanan yang Anda pakai. Dokumentasi R2 dari Cloudflare, yang dibaca pada Oktober 2026, menyatakan bahwa R2 gratis untuk memulai dengan penggunaan bulanan gratis yang sudah termasuk, dan bahwa Anda ditagih untuk penggunaan Anda setiap bulan.

Yang akan Anda lihat Halaman ikhtisar R2 Cloudflare, dengan tombol untuk menambahkan R2 ke akun Anda dan, jika Cloudflare memintanya, formulir untuk kartu atau PayPal.

Dapatkan Studio di komputer Anda

Di Windows: di Maxisnap, buka Pengaturan → Akun → Wizard penyiapan Maxisnap Studio, klik “Mulai”, lalu “Unduh dasbor”. Maxisnap menyimpan ZIP Studio ke folder Unduhan Anda dan membuka folder tersebut.
Di Mac: di Maxisnap, buka Settings → Welcome & Help → Studio Setup Guide, klik “Get Started”, lalu “Download Dashboard”. Maxisnap menyimpan ZIP Studio ke folder Unduhan Anda.

Ekstrak file ZIP. Di Windows, klik kanan file tersebut dan pilih “Ekstrak Semua”. Di Mac, klik dua kali file tersebut.

Ingin logo dan warna Anda dipakai sejak awal? Klik dua kali “Maxisnap Studio - Start Here.html”, rancang branding Anda, lalu klik “Lock in my branding”. Asisten Anda akan memakainya. Atau lewati langkah ini dan ubah branding nanti di dasbor Anda, di bagian Branding.

Yang akan Anda lihat Folder Studio yang sudah diekstrak: tiga folder (cloudflare, docs, dan snaps), halaman Start Here, dan petunjuk untuk asisten AI.

Tentukan alamatnya

Studio selalu mendapat alamat workers.dev yang berfungsi sejak awal. Anda juga dapat menambahkan subdomain baru dari domain Anda, seperti snaps.yourcompany.com, jika domain tersebut aktif di akun Cloudflare ini.

Alamat Anda akan terlihat seperti ini: snaps.yourcompany.workers.dev

Anda dapat menambahkan domain Anda sendiri nanti tanpa kehilangan apa pun.

Serahkan ke asisten AI Anda

Buka asisten coding AI Anda: Claude Code, Codex, Cursor, atau asisten lain yang dapat menjalankan perintah di komputer Anda.
Salin petunjuk siap pakai dari panduan asisten AI di Pusat Bantuan ini, ganti baris dalam tanda kurung sudut dengan folder Studio Anda, lalu tempelkan.
Katakan kepada asisten bahwa bisnis Anda sudah memakai Cloudflare, dan apakah Anda menginginkan subdomain. Asisten membaca file petunjuk di folder Studio Anda dan menjelaskan setiap langkah sebelum melakukannya.

Dapatkan petunjuk siap pakai.

Buat kunci Cloudflare saat asisten Anda memintanya

Proses deploy memerlukan izin untuk bekerja di akun Anda. Anda memberikannya dengan token API Cloudflare, yang berfungsi seperti kata sandi untuk satu tugas ini.

Di Cloudflare, buka My Profile → API Tokens, klik “Create Token”, lalu pilih untuk membuat token kustom.
Tambahkan keempat izin ini: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit, dan D1 Edit.
Untuk subdomain, tambahkan tiga lagi: Zone Read, DNS Read, dan Workers Routes Read.
Di bawah Account Resources, pilih akun perusahaan Anda. Untuk subdomain, di bawah Zone Resources, sertakan domain Anda.
Klik “Continue to summary”, lalu “Create Token”. Cloudflare hanya menampilkan token satu kali, jadi salin segera.
Saat asisten Anda memintanya, tempelkan sendiri token itu ke terminal, bukan ke chat.

Buka halaman API Tokens Cloudflare.

Ringkasan teknis menjelaskan untuk apa setiap izin digunakan. Setelah Studio Anda berjalan, Anda dapat menghapus token; memperbarui atau menghapus Studio Anda nanti memerlukan token yang baru.

Yang akan Anda lihat Halaman token Cloudflare: satu baris untuk setiap izin, dan tombol “Continue to summary” di bagian bawah.

Periksa rencananya, lalu buat Studio Anda

Tidak ada yang dibuat sebelum Anda menjawab ya. Asisten Anda lebih dulu menyusun rencananya dan menampilkannya kepada Anda. “Will create” mencantumkan satu Worker, satu bucket R2, dan satu database D1, ditambah nama workers.dev Anda jika baru dan subdomain Anda jika Anda memilihnya. “Will not touch” mencantumkan domain dan DNS Anda, serta Worker, bucket, dan database lain milik Anda.

Jika rencana menunjukkan masalah, seperti nama yang sudah dipakai, pilih nama lain lalu buat rencananya lagi.
Jika rencananya sudah benar, katakan kepada asisten Anda untuk melanjutkan. Jika proses deploy berhenti di tengah jalan, menjalankan perintah yang sama lagi akan melanjutkannya tanpa membuat apa pun dua kali.

Yang akan Anda lihat Asisten Anda menampilkan rencana: alamat Studio, lalu “Will create”, “Will not touch”, dan peringatan apa pun.

Simpan kunci Admin Anda

Setelah selesai, proses deploy menampilkan alamat Studio Anda dan kunci Admin-nya, hanya satu kali. Simpan kunci itu di tempat yang aman, seperti pengelola kata sandi Anda. Anda masuk ke dasbor dengan kunci itu, dan siapa pun yang memilikinya dapat menggunakan Studio Anda.
Proses deploy itu juga menulis file bernama deployment.json di folder cloudflare. Simpan file tersebut, karena pembaruan atau penghapusan Studio Anda nanti menggunakannya.

Hubungkan Maxisnap lalu coba

Maxisnap untuk Windows: buka Pengaturan → Akun → Wizard penyiapan Maxisnap Studio, klik “Mulai”, lalu “Berikutnya” sampai langkah 4, “Hubungkan Maxisnap”. Tempel alamat dan kunci Studio Anda, klik “Uji koneksi”, lalu “Berikutnya”, lalu “Selesai & Simpan” di halaman terakhir. Kunci Admin dari penyiapan dapat dipakai, begitu juga kode unggah dari People & access di dasbor Anda.
Maxisnap untuk Mac: buka Settings → Welcome & Help → Studio Setup Guide dan pilih “I already have a dashboard”. Tempel alamat dan kunci Studio Anda, klik “Test Connection”, lalu “Next”, lalu “Finish & Save”.

Ambil tangkapan apa saja dan klik “Unggah” di editor. Di Windows, Ctrl+Alt+7 menangkap sebuah area dan langsung mengunggahnya. Tautan berbagi akan masuk ke papan klip Anda.

Maxisnap untuk Windows dan Maxisnap untuk Mac mengirim setiap unggahan ke Studio di Cloudflare dalam satu permintaan, dan Studio menerimanya hingga 25 MB per file.

Langkah berikutnya: tambahkan tim Anda di dasbor, di bagian People & access (setiap orang mendapat kode dan perannya sendiri), dan ubah logo atau warna Anda kapan saja di bagian Branding.

Jika terjadi masalah

Subdomain sudah dipakai

snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.

Nama itu sudah mengarah ke suatu tempat, jadi Studio membiarkannya. Pilih subdomain yang belum dipakai apa pun, seperti studio atau share.

Sebuah route Worker sudah mencakup subdomain tersebut

The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.

Worker lain di akun Anda menangani setiap subdomain yang cocok dengan route itu, sehingga Studio tidak akan pernah melihat pengunjungnya sendiri. Pilih nama di luar route tersebut, atau konsultasikan dengan orang yang menyiapkan route itu.

Studio tidak dapat menemukan domain Anda

That domain is not in this Cloudflare account.

Domain tersebut berada di akun Cloudflare lain, atau token tidak dapat melihatnya. Buat token di akun yang menyimpan domain Anda, dengan Zone Read, DNS Read, dan Workers Routes Read untuk domain itu.

Domain Anda ditandai “not active yet”

yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.

Cloudflare belum melayani domain tersebut, biasanya karena nameserver-nya masih mengarah ke penyedia lama Anda. Gunakan alamat workers.dev untuk sementara; Anda dapat menambahkan subdomain nanti tanpa kehilangan apa pun.

Subdomain baru belum bisa dibuka

Cloudflare dapat memerlukan waktu untuk mengaktifkan subdomain baru. Alamat workers.dev berfungsi sejak awal, jadi gunakan alamat itu sampai saat tersebut.

Unggahan gagal di subdomain, tetapi alamat workers.dev berfungsi

Pengaturan keamanan Cloudflare pada subdomain itu menghalangi Maxisnap: Cloudflare Access (halaman masuk di depan alamat), aturan WAF, atau Bot Fight Mode. Minta orang yang mengurus Cloudflare Anda untuk mengizinkan subdomain Studio melewatinya. Ringkasan teknis memuat apa saja yang perlu diperiksa.

Rencana menyebutkan bahwa route Worker tidak dapat diperiksa

Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).

Tambahkan Workers Routes Read ke token. Tanpa izin itu, Studio tidak dapat melihat apakah Worker lain sudah menangani subdomain baru.

Penyimpanan belum diaktifkan

R2 storage is not turned on for this Cloudflare account yet.

Aktifkan R2 di dasbor Cloudflare, seperti pada langkah 1, lalu minta asisten Anda membuat rencananya lagi.

Nama Studio sudah dipakai

A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.

Beri tahu asisten Anda nama lain, seperti snaps-yourcompany. Jika nama penyimpanan atau database sudah dipakai, alat deploy otomatis memilih nama berikutnya yang tersedia.

Cloudflare menolak sebuah langkah

Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.

Token kekurangan satu izin. Buat token baru dengan izin dari langkah 5 dan tempel lagi ke terminal saat asisten Anda memintanya.

Penyiapan berhenti di tengah jalan

Minta asisten Anda menjalankan lagi perintah deploy yang sama. Perintah itu melanjutkan dari titik berhenti dan tidak membuat apa pun dua kali.

Alamat baru Anda belum bisa dibuka

Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.

Semuanya sudah dibuat; Cloudflare masih mengaktifkan alamatnya. Tunggu beberapa menit, lalu buka alamat itu lagi.

Anda kehilangan kunci Admin

Asisten Anda dapat menetapkan kunci yang baru. Asisten itu menjalankan perintah ini dari folder cloudflare di unduhan Studio Anda, dengan token Cloudflare di terminal. Perintah tersebut menampilkan kunci baru hanya satu kali; setelah itu hubungkan Maxisnap lagi dengan kunci tersebut.

node deploy/cli.mjs update --record deployment.json --yes --new-admin-key

Video besar tidak bisa diunggah

Maxisnap untuk Windows dan Maxisnap untuk Mac mengirim setiap unggahan ke Studio di Cloudflare dalam satu permintaan, dan Studio menerimanya hingga 25 MB per file.

Jaga agar rekaman tetap di bawah ukuran itu, atau persingkat rekaman sebelum Anda mengunggahnya.

Maxisnap mengatakan kuncinya tidak benar

Salin lagi kunci itu dari tempat Anda menyimpannya, tanpa spasi sebelum atau sesudahnya. Periksa juga alamatnya: alamat itu adalah yang ditampilkan saat penyiapan, diawali dengan https://.

Masih butuh bantuan?

Kirim email kepada kami dan seseorang akan membalas, biasanya dalam satu hari kerja. Detail berikut membantu kami menjawab sekaligus:

Opsi penyiapan yang Anda pilih dan langkah yang sedang Anda kerjakan.
Screenshot layar, dengan pesan kesalahan apa pun secara lengkap.
Di mana Studio Anda akan dipasang: akun Cloudflare baru atau yang sudah ada, atau nama perusahaan hosting web Anda.
Versi Maxisnap Anda: di Windows pada Pengaturan, lalu Tentang; di Mac pada Maxisnap, lalu About Maxisnap.

Mohon jangan kirimkan kunci Admin, kunci Cloudflare, atau kata sandi Anda. Kami tidak membutuhkannya untuk membantu Anda.

Kirim email ke support@maxisnap.com