Ana içeriğe geç
Studio kurulum rehberleri İşletmem zaten Cloudflare kullanıyor

Studio'yu işletmenizin Cloudflare hesabına ekleyin

Şirketinizin alan adı zaten Cloudflare'de yönetiliyorsa, Studio web sitenizin yanında aynı hesaba eklenebilir. Studio, kendi ücretsiz workers.dev adresini ve isterseniz alan adınızın yeni bir alt alan adını alır. Web siteniz ve DNS kayıtları aynen olduğu gibi kalır.

En iyi
Alan adı zaten Cloudflare'de yönetilen işletmeler.
İhtiyacınız olanlar
Windows veya Mac için Maxisnap (Studio'su olan hesapla oturum açılmış); Worker ekleyebilen, şirketinizin Cloudflare hesabına ait bir giriş bilgisi ya da o hesaba bakan kişi; ve bilgisayarınızda bir yapay zeka kodlama asistanı ya da Node.js 20 veya daha yeni sürümün kurulu olduğu bir terminal.
Süre
İlk seferde yaklaşık 20 dakika.
Elde edeceğiniz
Kendi workers.dev adresinde Studio'nuz; isterseniz snaps.yourcompany.com gibi yeni bir alt alan adı da. Web siteniz aynen olduğu gibi kalır.
Maliyet
Studio, Cloudflare'in ücretsiz planında çalışacak şekilde tasarlanmıştır. Cloudflare, R2'nin güncel ücretsiz kullanım hakkını ve fiyatlarını yayımlar.

Studio'nun neleri eklediği ve nelere dokunmadığı

Studio'nun eklediği şeyler

  • Studio uygulamasının kendisi (Cloudflare buna “Worker” der)
  • Yakalamalarınız için bir depolama alanı (bir “R2 bucket”)
  • Kitaplığınız ve ekibiniz için küçük bir veritabanı (“D1”)
  • workers.dev üzerindeki adresi; seçerseniz ayrıca yeni bir alt alan adı
  • Hesabınızın workers.dev adı, henüz yoksa (tüm hesap için tek bir ad)

Studio'nun dokunmadığı şeyler

  • Web siteniz ve dosyaları
  • Alan adlarınızın mevcut DNS kayıtları
  • Başka herhangi bir Worker, depolama alanı veya veritabanı
  • Faturalandırma bilgileriniz ve diğer hesap ayarlarınız

Bir ad zaten kullanımdaysa Studio başka bir ad seçer veya sizden seçmenizi ister; orada zaten bulunan hiçbir şeyin üzerine yazmaz.

Cloudflare hesabınızla ya da web sitenizle başka biri ilgileniyorsa önce onunla görüşün. Bazı şirketlerin şirket hesabına kimin hizmet ekleyebileceğine dair kuralları vardır ya da her alt alan adının önüne bir oturum açma sayfası koyarlar; bu da Maxisnap'in yüklemelerini engeller.

Teknik bilgi notunu Cloudflare hesabınızla ilgilenen kişiyle paylaşın.

Depolamanın açık olduğunu kontrol edin

Studio yakalamalarınızı Cloudflare R2'de saklar. Şirketinizin Cloudflare hesabında oturum açın ve bunu bir kez kontrol edin:

  1. Cloudflare panelinde Storage & databases → R2 → Overview sayfasını açın.
  2. Cloudflare R2'yi eklemeyi önerirse ödeme işlemini tamamlayın. Hesabın faturalandırma sahibi siz değilseniz, bu adımı yapmasını ondan isteyin.

Studio paneliniz ne kadar depolama kullandığınızı gösterir. Cloudflare'in Ekim 2026'da okunan R2 belgeleri, R2'ye başlamanın ücretsiz olduğunu, aylık ücretsiz kullanımın dahil olduğunu ve kullanımınız için aylık olarak faturalandırıldığınızı belirtir.

Ekranda göreceğiniz Cloudflare'in R2 genel bakış sayfası: R2'yi hesabınıza eklemek için bir düğme ve Cloudflare isterse bir kart veya PayPal formu.

Studio'yu bilgisayarınıza indirin

  • Windows'ta: Maxisnap'te Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine, ardından “Paneli indir” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder ve o klasörü açar.
  • Mac'te: Maxisnap'te Settings → Welcome & Help → Studio Setup Guide bölümünü açın, “Get Started” düğmesine, ardından “Download Dashboard” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder.

ZIP dosyasını ayıklayın. Windows'ta dosyaya sağ tıklayın ve “Tümünü Ayıkla” seçeneğini seçin. Mac'te dosyaya çift tıklayın.

Logonuzu ve renklerinizi en baştan kullanmak ister misiniz? “Maxisnap Studio - Start Here.html” dosyasına çift tıklayın, markalamanızı tasarlayın ve “Lock in my branding” düğmesine tıklayın. Asistanınız bunu kullanır. Ya da bu adımı atlayın ve markalamayı daha sonra panelinizde Branding bölümünden değiştirin.

Ekranda göreceğiniz Ayıklanmış Studio klasörü: üç klasör (cloudflare, docs ve snaps), Start Here sayfası ve yapay zeka asistanları için yönergeler.

Adresi belirleyin

Studio her zaman başlangıçtan itibaren çalışan bir workers.dev adresi alır. Alan adı bu Cloudflare hesabında etkinse, alan adınızın snaps.yourcompany.com gibi yeni bir alt alan adını da ekleyebilirsiniz.

Adresiniz şuna benzeyecek: snaps.yourcompany.workers.dev

Kendi alan adınızı daha sonra hiçbir şey kaybetmeden ekleyebilirsiniz.

İşi yapay zeka asistanınıza devredin

  1. Yapay zeka kodlama asistanınızı açın: Claude Code, Codex, Cursor veya bilgisayarınızda komut çalıştırabilen başka bir asistan.
  2. Hazır yönergeleri yapay zeka asistanı rehberinden kopyalayın, açılı parantezler içindeki satırı Studio klasörünüzle değiştirin ve yapıştırın.
  3. İşletmenizin zaten Cloudflare kullandığını ve bir alt alan adı isteyip istemediğinizi söyleyin. Asistan, Studio klasörünüzdeki yönerge dosyasını okur ve her adımı yapmadan önce açıklar.

Hazır yönergeleri alın.

Asistanınız istediğinde bir Cloudflare anahtarı oluşturun

Dağıtımın hesabınızda çalışmak için izne ihtiyacı var. Bu izni bir Cloudflare API token'ı ile verirsiniz; bu token yalnızca bu iş için bir parola gibi işlev görür.

  1. Cloudflare'de My Profile → API Tokens bölümünü açın, “Create Token” düğmesine tıklayın ve özel bir token oluşturmayı seçin.
  2. Şu dört izni ekleyin: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit ve D1 Edit.
  3. Alt alan adı için üç izin daha ekleyin: Zone Read, DNS Read ve Workers Routes Read.
  4. Account Resources altında şirketinizin hesabını seçin. Bir alt alan adı için Zone Resources altında alan adınızı ekleyin.
  5. “Continue to summary” düğmesine, ardından “Create Token” düğmesine tıklayın. Cloudflare token'ı yalnızca bir kez gösterir; bu yüzden hemen kopyalayın.
  6. Asistanınız istediğinde token'ı sohbete değil, terminale kendiniz yapıştırın.

Cloudflare'in API Tokens sayfasını açın.

Teknik bilgi notu, her iznin ne için kullanıldığını açıklar. Studio'nuz çalışmaya başladıktan sonra token'ı silebilirsiniz; Studio'nuzu daha sonra güncellemek veya kaldırmak için yeni bir token gerekir.

Ekranda göreceğiniz Cloudflare'in token sayfası: her izin için bir satır ve altta bir “Continue to summary” düğmesi.

Planı kontrol edin, ardından Studio'nuzu oluşturun

Siz evet demeden hiçbir şey oluşturulmaz. Asistanınız önce planı çalıştırır ve size gösterir. “Will create” bir Worker, bir R2 kovası ve bir D1 veritabanını listeler; ayrıca workers.dev adınız yeniyse onu, bir alt alan adı seçtiyseniz onu da listeler. “Will not touch” ise alan adlarınızı ve DNS kayıtlarınızı, diğer Worker'larınızı, kovalarınızı ve veritabanlarınızı listeler.

  1. Plan, zaten kullanımda olan bir ad gibi bir sorun gösteriyorsa başka bir ad seçin ve planı yeniden çalıştırın.
  2. Plan doğru göründüğünde asistanınıza devam etmesini söyleyin. Dağıtım yarıda kalırsa, aynı komut yeniden çalıştırıldığında hiçbir şeyi iki kez oluşturmadan devam eder.
Ekranda göreceğiniz Asistanınız planı gösterir: Studio adresi, ardından “Will create”, “Will not touch” ve varsa uyarılar.

Yönetici anahtarınızı kaydedin

  1. İş bittiğinde dağıtım, Studio'nuzun adresini ve Yönetici anahtarını yalnızca bir kez gösterir. Anahtarı parola yöneticiniz gibi güvenli bir yerde saklayın. Panelinizde onunla oturum açarsınız ve ona sahip olan herkes Studio'nuzu kullanabilir.
  2. Dağıtım ayrıca cloudflare klasörüne deployment.json adlı bir dosya yazar. Bu dosyayı saklayın, çünkü Studio'nuzu daha sonra güncellerken veya kaldırırken bu dosya kullanılır.

Maxisnap'i bağlayın ve deneyin

  • Windows için Maxisnap: Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine tıklayın, ardından “Maxisnap'ı bağlayın” başlıklı 4. adıma gelene kadar “İleri” düğmesine tıklayın. Studio'nuzun adresini ve anahtarını yapıştırın, “Bağlantıyı test et” düğmesine, ardından “İleri” düğmesine, son sayfada da “Bitir ve Kaydet” düğmesine tıklayın. Hem kurulumda gösterilen Yönetici anahtarı hem de panelinizdeki People & access bölümünden alınan bir yükleme kodu çalışır.
  • Mac için Maxisnap: Settings → Welcome & Help → Studio Setup Guide bölümünü açın ve “I already have a dashboard” seçeneğini seçin. Studio'nuzun adresini ve anahtarını yapıştırın, “Test Connection” düğmesine, ardından “Next” düğmesine, sonra da “Finish & Save” düğmesine tıklayın.

Bir şey yakalayın ve düzenleyicide “Yükle” düğmesine tıklayın. Windows'ta Ctrl+Alt+7 bir bölgeyi yakalar ve hemen yükler. Paylaşım bağlantısı panonuza kopyalanır.

Windows için Maxisnap ve Mac için Maxisnap, her yüklemeyi Cloudflare'deki bir Studio'ya tek bir istekte gönderir ve Studio bunu dosya başına 25 MB'a kadar kabul eder.

Sonraki adımlar: ekibinizi panelde People & access altından ekleyin (herkes kendi kodunu ve rolünü alır) ve logonuzu veya renklerinizi istediğiniz zaman Branding altından değiştirin.

Bir şeyler ters giderse

Alt alan adı zaten kullanımda

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

Bu ad zaten bir yere işaret ediyor, bu yüzden Studio ona dokunmaz. Henüz hiçbir şeyin kullanmadığı bir alt alan adı seçin, örneğin studio veya share.

Bir Worker rotası alt alan adını zaten kapsıyor

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

Hesabınızdaki başka bir Worker, o rotayla eşleşen her alt alan adına yanıt veriyor; bu yüzden Studio kendi ziyaretçilerini hiç görmez. Rotanın dışında kalan bir ad seçin ya da rotayı kuran kişiye danışın.

Studio alan adınızı bulamıyor

That domain is not in this Cloudflare account.

Alan adı başka bir Cloudflare hesabında bulunuyor ya da token onu göremiyor. Token'ı alan adınızın bulunduğu hesapta, o alan adı için Zone Read, DNS Read ve Workers Routes Read izinleriyle oluşturun.

Alan adınız “not active yet” olarak işaretlenmiş

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

Cloudflare henüz bu alan adı için yanıt vermiyor; bunun nedeni genellikle ad sunucularının hâlâ eski sağlayıcınızı işaret etmesidir. Şimdilik workers.dev adresini kullanın; alt alan adını sonradan hiçbir şey kaybetmeden ekleyebilirsiniz.

Yeni alt alan adı henüz açılmıyor

Cloudflare'in yeni bir alt alan adını etkinleştirmesi biraz zaman alabilir. workers.dev adresi baştan itibaren çalışır; o zamana kadar onu kullanın.

Yüklemeler alt alan adında başarısız oluyor ama workers.dev adresi çalışıyor

O alt alan adındaki bir Cloudflare güvenlik ayarı Maxisnap'i engelliyor: Cloudflare Access (adresin önüne konan bir oturum açma sayfası), bir WAF kuralı veya Bot Fight Mode. Cloudflare hesabınızla ilgilenen kişiden Studio alt alan adının geçmesine izin vermesini isteyin. Nelerin kontrol edileceği teknik bilgi notunda listelenir.

Plan, Worker rotalarını kontrol edemediğini söylüyor

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

Token'a Workers Routes Read iznini ekleyin. Bu izin olmadan Studio, başka bir Worker'ın yeni alt alan adını zaten yakalayıp yakalamadığını göremez.

Depolama açık değil

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

1. adımdaki gibi Cloudflare panelinde R2'yi açın, ardından asistanınızdan planı yeniden çalıştırmasını isteyin.

Studio adı zaten kullanımda

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

Asistanınıza başka bir ad söyleyin, örneğin snaps-yourcompany. Bir depolama ya da veritabanı adı alınmışsa dağıtım aracı sıradaki boş adı kendisi seçer.

Cloudflare bir adımı reddetti

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

Token'da bir izin eksik. 5. adımdaki izinlerle yeni bir token oluşturun ve asistanınız istediğinde onu yeniden terminale yapıştırın.

Kurulum yarıda kaldı

Asistanınızdan aynı dağıtım komutunu yeniden çalıştırmasını isteyin. Komut kaldığı yerden devam eder ve hiçbir şeyi iki kez oluşturmaz.

Yeni adresiniz henüz açılmıyor

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

Her şey oluşturuldu; Cloudflare adresi hâlâ etkinleştiriyor. Birkaç dakika bekleyin, ardından adresi yeniden açın.

Yönetici anahtarınızı kaybettiniz

Asistanınız yeni bir anahtar belirleyebilir. Bunun için şu komutu, Studio paketinizin cloudflare klasöründen, terminaldeki bir Cloudflare token'ıyla çalıştırır. Komut yeni anahtarı yalnızca bir kez gösterir; ardından Maxisnap'i bu anahtarla yeniden bağlayın.

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

Büyük videolar yüklenmiyor

Windows için Maxisnap ve Mac için Maxisnap, her yüklemeyi Cloudflare'deki bir Studio'ya tek bir istekte gönderir ve Studio bunu dosya başına 25 MB'a kadar kabul eder.

Kayıtları bu boyutun altında tutun ya da yüklemeden önce kırpın.

Maxisnap anahtarın doğru olmadığını söylüyor

Anahtarı kaydettiğiniz yerden, başında ve sonunda boşluk olmadan yeniden kopyalayın. Adresi de kontrol edin; bu, kurulumda size gösterilen adrestir ve şununla başlar: https://.

Hâlâ yardıma mı ihtiyacınız var?

Bize e-posta gönderin; bir kişi, genellikle bir iş günü içinde size geri yazar. Bu bilgiler, size tek seferde yanıt vermemize yardımcı olur:

  • Seçtiğiniz kurulum seçeneği ve bulunduğunuz adım.
  • Ekranın bir ekran görüntüsü, varsa hata mesajının tamamıyla birlikte.
  • Studio'nuzun nereye kurulacağı: yeni ya da mevcut bir Cloudflare hesabı veya web barındırma şirketinizin adı.
  • Maxisnap sürümünüz: Windows'ta Ayarlar, ardından Hakkında; Mac'te Maxisnap altında, ardından About Maxisnap.

Lütfen Yönetici anahtarınızı, bir Cloudflare anahtarını veya bir parolayı göndermeyin. Size yardım etmemiz için bunlara ihtiyacımız yok.

Diğer kurulum rehberleri