Firebase Storage: nedir, dosya yükleme ve bulut depolama

Firebase Storage Nedir ve Nasıl Çalışır

Firebase Storage, Google Cloud Storage üzerine inşa edilmiş ve Android, iOS ile web platformları için SDK sağlayan bir bulut nesne deposudur. Her dosya, bir Google Cloud bucket'ında nesne olarak saklanır ve dosya sistemi benzeri bir yolla adreslenir: gs://bucket-name/path/to/file.jpg. Tek bir dosya 5 TB'a kadar olabilir ve ön sıkıştırma olmadan herhangi bir medya verisini depolamanıza olanak tanır.

Firebase Storage'ın mimarisi, klasik klasör hiyerarşisi yerine bağlantı referans modelini (gsutil references) kullanır, ancak SDK geliştirici kolaylığı için bir dizin arayüzü sağlar. Fiziksel olarak, tüm nesneler bucket'ın düz ad alanında saklanır ve sanal klasörler yol önekleri kullanılarak oluşturulur. Bu, dosya sayısından bağımsız olarak doğrusal arama performansı sağlar.

Google Cloud Storage'ı doğrudan kullanmaya kıyasla Firebase Storage'ın temel avantajı, Firebase Authentication ve Security Rules ile yerleşik entegrasyondur. Geliştiricinin ayrı IAM rolleri ve hizmet hesapları yapılandırması gerekmez: erişim kuralları, Firebase Realtime Database Rules'a benzer bildirimsel bir dilde yazılır ve her istekte otomatik olarak uygulanır.

Bucket Yapısı ve Dosya Yolları

Firebase konsolunda hizmeti etkinleştirdiğinizde otomatik olarak bir Firebase Storage bucket'ı oluşturulur. Dosya yolu /klasör_adı/dosya_adı modelini izler ve iç içe seviyeler içerebilir. Kullanıcılar arasında veriyi yalıtmak için yolların /users/{userId}/images/{imageId}.jpg şemasına göre düzenlenmesi önerilir. Bu yapı, güvenlik kurallarını yazmayı basitleştirir çünkü yol, sahibin tanımlayıcısını içerir.

Firebase Storage'ın klasik anlamda bir ilişkisel veritabanı veya dosya sunucusu olmadığını anlamak önemlidir. Tam dosyaları okuma ve yazma işlemleri için optimize edilmiş bir nesne deposudur. Kısmi dosya güncellemesi mümkün değildir: aynı yola yeniden yüklerseniz, eski nesne yenisiyle değiştirilir. Küçük yapılandırılmış verileri depolamak için Firebase Realtime Database veya Cloud Firestore kullanın.

Firebase Storage Fiyatlandırması ve Limitleri

Firebase Storage fiyatlandırması, depolanan veri miktarına ve işlem sayısına bağlıdır. Ücretsiz plan (Spark), günde 5 GB depolama, 20.000 yazma işlemi ve 50.000 okuma işlemi içerir. Ücretli plan (Blaze), gerçek kullanıma göre ücretlendirir: depolanan veri başına $0,026/GB, 10.000 yazma işlemi başına $0,05 ve 10.000 okuma işlemi başına $0,004. Giden trafik için ek ücretler uygulanır.

Birkaç bin kullanıcılı çoğu mobil uygulama için, prototip oluşturma ve test aşamasında ücretsiz limit yeterlidir. Yüz binlerce kullanıcıya ölçeklendirirken, optimize edilmiş yükleme yaklaşımı ve istemci tarafı önbellekleme ile Storage maliyetleri nadiren ayda $50–$100'ü aşar.

Firebase Storage'a Dosya Yükleme

Firebase Storage'a dosya yükleme, bir depolama yolunu ve dosya verilerini (byte dizisi, URI, akış veya Bitmap) kabul eden uygun SDK yöntemi aracılığıyla gerçekleştirilir. SDK, bağlantıyı otomatik olarak yönetir, büyük boyutlar için dosyayı parçalara ayırır ve ilerleme takibi için geri çağırmalar sağlar. Yükleme, doğrudan istemci cihazından Google Cloud'a yapılır, sunucunuzu atlar ve kendi altyapınızdaki yükü azaltır.

Android için Firebase Storage SDK, StorageReference ve UploadTask sınıflarını kullanır. Bir StorageReference, Firebase.storage.reference aracılığıyla kök yoldan oluşturulur ve bucket'taki belirli bir dosyayı işaret eder. UploadTask, ilerleme, duraklatma ve tamamlama için dinleyiciler döndürür. Bir bağlantı kesildiğinde, UploadTask otomatik olarak son başarıyla iletilen bayttan yüklemeyi sürdürür — bu davranışa sürdürülebilir yükleme denir.

Dosya meta verileri (Content-Type, özel alanlar), yükleme başlatılırken ayrı bir SettableMetadata nesnesi olarak iletilir. Tarayıcıda dosyaların doğru görüntülenmesi ve CDN önbelleklemesi için Content-Type'ı doğru ayarlamak kritiktir. Firebase Storage, tüm standart MIME türlerini destekler: image/jpeg, image/png, video/mp4, application/pdf ve diğerleri.

Yükleme Sırasında Meta Veri Yönetimi

Dosya meta verileri, sistem alanlarını (Content-Type, Cache-Control, Content-Disposition) ve özel anahtar-değer çiftlerini (customMetadata) içerir. Sistem alanları, indirme sırasında HTTP başlıklarını kontrol eder. Örneğin, Cache-Control: public, max-age=31536000 yanıt önbelleklemesini bir yıl boyunca etkinleştirir, aynı dosyanın tekrarlanan indirmelerini önemli ölçüde azaltır ve trafikten tasarruf sağlar.

Özel meta veriler, Firestore'da ayrı bir koleksiyon oluşturmadan bir dosya hakkında ek bilgi iletmek için kullanışlıdır. Örneğin, uploadedBy alanı, yükleyen kullanıcının userId'sini saklayabilir ve kullanıcı tarafından oluşturulan içerikli galerilerin uygulanmasını basitleştirir. Özel meta veriler, Security Rules tarafından ayrı olarak korunmaz — bunlara erişim, dosyanın kendisiyle aynı kurallar tarafından yönetilir.

Çoklu Yükleme ve Toplu İşleme

Aynı anda birden çok dosya yüklemeniz gerektiğinde (örneğin, bir galeriden fotoğraflar), sınırsız olarak paralelde bağımsız UploadTask'lar çalıştırmanız önerilmez. Mobil cihazlarda, 3–5'ten fazla dosyanın paralel yüklenmesi ağ yığınını aşırı yükler ve zaman aşımlarına neden olur. En uygun strateji, 3 eşzamanlılık sınırı veya paylaşılan bir ilerleme çubuğu gösterimi ile sıralı yükleme kullanmaktır.

Yükleme sonrası sunucu tarafı işleme (küçük resim oluşturma, sıkıştırma, içerik denetleme) için Firebase Cloud Functions tetikleyicisini kullanın: functions.storage.object().onFinalize(). Bu işlev, her dosya yüklemesi tamamlandıktan sonra otomatik olarak çağrılır ve işlenmiş bir kopyayı farklı bir yola kaydedebilir. Daha fazla ayrıntı tipik kullanım durumları bölümünde yer almaktadır.

Dosya İndirme ve Bağlantı Yönetimi

Firebase Storage iki indirme yöntemini destekler: SDK aracılığıyla doğrudan indirme (byte dizisi veya yerel dosya alma) ve HTTP erişimi için doğrudan indirme URL'si alma. Doğrudan URL, ImageView'da, WebView'da resim görüntülemek veya kullanıcıya bir bağlantı sağlamak için kullanılabilir. İndirme URL'si, Firebase konsolunda iptal edilebilen bir güvenlik tokeni ile oluşturulur.

storageReference.downloadUrl yöntemi, https://firebasestorage.googleapis.com/v0/b/{bucket}/o/{path}?alt=media&token={token} biçiminde bir URL döndürür. Güvenlik tokeni, oluşturma sırasında otomatik olarak URL'ye dahil edilir, bu nedenle bağlantı, yetkisiz erişim riski olmadan üçüncü taraflarla (örneğin, bir mesajlaşma uygulamasında) paylaşılabilir. Ancak token tehlikeye girerse, Firebase konsolunun Storage bölümü üzerinden iptal edilebilir — bundan sonra bu token ile tüm bağlantılar çalışmayı durdurur.

İstemcide indirilen dosyaları önbelleğe almak için ETag mekanizması veya MD5 hash ile yerel depolama kullanın. Firebase Storage, bir dosya talep edildiğinde bir HTTP başlığı ETag döndürür ve bu, değişmemiş dosyaları yeniden indirmekten kaçınmak için yerel olarak saklanan bir değerle karşılaştırılabilir. Bu, özellikle medya içeriği için kullanışlıdır: avatarlar, kapak resimleri, önizlemeler — nadiren güncellenen ancak sık sık talep edilen dosyalar.

Doğrudan İndirme URL'leri ve Güvenlikleri

Bir token ile indirme URL'si, kimliği doğrulanmamış kullanıcılara dosya erişimi sağlamanın birincil yoludur (örneğin, bir haber akışında resim görüntüleme). Token bir kez oluşturulur ve iptal edilene kadar değişmez, bu nedenle URL bir veritabanında saklanabilir (örneğin, Firestore'daki avatarUrl alanının yanında). Avatar değiştirildiğinde, eski dosya silinir ve yeni bir URL oluşturulup kaydedilir.

Unutmamak önemlidir: indirme URL'sine sahip olmak Security Rules'ı geçersiz kılmaz. Bir kural dosya okumayı reddederse, downloadUrl yöntemi İzin Reddedildi hatası döndürür. Bu, doğru dosya yolunu bilse bile, kimliği doğrulanmamış bir istemcinin bağlantıyı alamayacağı anlamına gelir. URL elde edildikten sonra, Security Rules'ı atlayarak HTTP erişimi sağlar — bu nedenle token, indirme bağlantısının tek korumasıdır.

Önbellekleme ve ETag ile Çalışma

HTTP ETag, içerik her değiştirildiğinde değişen bir dosya sürüm tanımlayıcısıdır. Firebase Storage, GET yanıtında otomatik olarak bir ETag döndürür. İstemci uygulaması, ETag'i yerel bir önbellekte saklayabilir ve sonraki isteklerde If-None-Match: {etag} başlığını gönderebilir. Dosya değişmediyse, sunucu veri iletmeden 304 Not Modified durumu döndürür.

Bir mobil uygulamada akıllı önbellekleme uygulamak için, yerel dosya sistemi ve bir veritabanının (örneğin, yol-ETag çiftlerini saklamak için Room) birleşimini kullanın. Bir dosya yüklerken, veritabanından ETag'i kontrol edin: sunucudakiyle eşleşiyorsa, yerel kopyayı kullanın. Bu yaklaşım, statik medya dosyaları için trafiği %60–80 oranında azaltır ve galerili ekran yüklemeyi hızlandırır.

Firebase Storage için Güvenlik Kuralları

Security Rules, Firebase Storage'daki dosyalara erişim kontrolü için Firebase sunucu tarafında yürütülen bildirimsel bir dildir. Her kural, bir bucket yoluna bağlanır ve bir okuma veya yazma işlemine izin verilen koşulları tanımlar. Kurallar her istekten önce kontrol edilir ve istemci kodu tarafından atlanamaz. Bu, yetkisiz erişime karşı verinin tek savunma hattıdır.

Temel kural, yalnızca kimliği doğrulanmış kullanıcılar için erişimdir: allow read, write: if request.auth != null. Bu kural, yalnızca oturum açmış kullanıcıların dosyaları okuyup yazabilmesini sağlar. Daha ince ayar için, geçerli kullanıcının tanımlayıcısını içeren request.auth.uid değişkeni kullanılır. uid'yi dosya yolunun bir parçasıyla karşılaştırarak, her kullanıcı için izole bir depolama oluşturabilirsiniz.

Önemli: Security Rules bir içerik doğrulama mekanizması değildir. Dosya türünü, boyutunu veya kötü amaçlı kod varlığını kontrol etmeniz gerekiyorsa, yüklenen dosyanın meta verilerini içeren request.resource kuralını kullanın. Mevcut özellikler: request.resource.size (dosya boyutu), request.resource.contentType (MIME türü) ve request.resource.md5Hash (sağlama toplamı). Ancak, tam içerik doğrulaması Cloud Functions aracılığıyla sunucu tarafında gerçekleştirilir.

Kullanıcı Tarafından Oluşturulan İçerik için Örnek Kurallar

Kullanıcı avatarları ve bir galeri içeren bir uygulama için tipik bir yapılandırma aşağıdaki gibidir. Kullanıcı yalnızca kendi dizinine /users/{userId}/ yazabilir, ancak bu dizindeki herhangi bir dosyayı okuyabilir (herkese açık galeri). Dosya boyutu 5 MB ile sınırlıdır ve tür yalnızca resimlerle sınırlıdır. Bu kural kombinasyonu, sosyal ve KOK uygulamalarında Firebase Storage kullanım durumlarının %80'ini kapsar.

Güvenlik İpucu: tüm bucket için allow read, write: if true kuralını asla kullanmayın. Bu, projectId'nizi bilen herkes için yazma erişimini açar. 2025'te, saldırganların yasa dışı içerik depolamak için açık erişimi kullandığı korumasız Firebase bucket'larına yönelik saldırılar arttı. Her zaman minimum gerekli izinlerle başlayın ve yalnızca açıkça gerektiğinde genişletin.

Cloud Functions ile İçerik Doğrulama

Cloud Functions tetikleyicisi functions.storage.object().onFinalize(), yükleme sonrası içerik doğrulaması yapmanıza olanak tanır. Dosya doğrulamayı geçemezse (örneğin, virüs içeriyor veya platform kurallarını ihlal ediyorsa), işlev dosyayı silebilir ve kullanıcıyı bilgilendirebilir. Bu, gerçek içeriği kontrol etmenin tek yoludur çünkü Security Rules yalnızca meta verileri (boyut ve MIME türü) görür, ikili verileri görmez.

Doğrulama örneği: bir Node.js işlevi, yüklenen dosyayı geçici bir dizine indirir, bir antivirüs dedektörü (örneğin, ClamAV) aracılığıyla çalıştırır ve bir tehdit bulunursa dosyayı siler ve Firebase Crashlytics'e olayı kaydeder. İşlev yürütme süresi 540 saniye ile sınırlıdır ve 50 MB'a kadar dosyaları kontrol etmek için yeterlidir.

Kotlin'de Firebase Storage için Kod Örnekleri

Kotlin kullanarak bir Android uygulamasında Firebase Storage entegrasyonunun pratik örneklerine bakalım. Kod, standart Firebase SDK sınıflarını kullanır ve cihaz galerisinden bir resim yükleme, ilerleme takibi ile dosya indirme ve indirme URL'si alma işlemlerini gösterir. Tüm örnekler, hata yönetimini ve bağlantı kaybında görev askıya almayı içerir.

Kodu kullanmadan önce, build.gradle dosyasının implementation(platform("com.google.firebase:firebase-bom:33.0.0")) ve implementation("com.google.firebase:firebase-storage") bağımlılıklarını içerdiğinden emin olun. Firebase BOM, tüm SDK'ların uyumlu sürümlerini otomatik olarak seçer ve sürüm çakışmalarını ortadan kaldırır.

Galeriden Resim Yükleme

İlk örnek, Intent ACTION_GET_CONTENT aracılığıyla kullanıcı tarafından seçilen dosya yüklemeyi gösterir. Elde edilen dosyanın URI'si, bu URI'den verileri okuyan Firebase Storage SDK'sına iletilir. putFile yöntemi bir URI kabul eder ve ilerlemeyi izleyebileceğiniz, yüklemeyi duraklatıp sürdürebileceğiniz bir UploadTask döndürür.

val storageRef = Firebase.storage.reference
val imageRef = storageRef.child(
    "users/${auth.uid}/profile.jpg"
)

val metadata = SettableMetadata().apply {
    contentType = "image/jpeg"
    customMetadata = mapOf(
        "uploadedBy" to auth.uid!!
    )
}

imageRef.putFile(imageUri, metadata)
    .addOnSuccessListener {
        Log.d("Storage", "Dosya yüklendi")
    }
    .addOnFailureListener { e ->
        Log.e("Storage", "Hata: ${e.message}")
    }

Yukarıdaki örnekte, storageRef değişkeni proje bucket'ına kök referanstır. child yöntemi bir yol dizesi kabul eder ve belirli bir dosyayı işaret eden bir StorageReference döndürür. Belirtilen yolda zaten bir dosya varsa, üzerine yazılır. contentType ve customMetadata, putFile isteğine eklenen SettableMetadata nesnesi aracılığıyla iletilir.

İlerleme ile Dosya İndirme

İkinci örnek, bir ImageView'da görüntülemek için bir byte dizisi alarak dosya indirmeyi gösterir. getBytes(maxSize) yöntemi tüm dosyayı belleğe yükler. 10 MB'dan büyük dosyalar için getFile(localUri) kullanın — içeriği RAM'de saklamadan doğrudan yerel bir dosyaya kaydeder ve OutOfMemoryError'ı önler.

val islandRef = storageRef.child("images/island.jpg")

val ONE_MEGABYTE: Long = 1024 * 1024
islandRef.getBytes(ONE_MEGABYTE)
    .addOnSuccessListener { bytes ->
        imageView.setImageBitmap(
            BitmapFactory.decodeByteArray(
                bytes, 0, bytes.size
            )
        )
    }
    .addOnFailureListener { e ->
        Log.e("Storage", "Yükleme başarısız: ${e.message}")
    }

İndirme URL'si almak için (örneğin, bağlantıyı Firestore'da saklamak için) downloadUrl yöntemini kullanın:

islandRef.downloadUrl.addOnSuccessListener { uri ->
    Log.d("Storage", "İndirme URL'si: $uri")
    // uri.toString() öğesini Firestore'a kaydet
}

İpucu: indirme URL'si bir kez oluşturulur ve iptal edilene kadar kararlı kalır. Dosyayı her görüntülediğinizde talep etmek yerine, ilk yüklemede veritabanına kaydedin. Bu, Firebase Storage'a yapılan istek sayısını azaltır ve kullanıcı arayüzü performansını artırır.

Firebase Storage için Tipik Kullanım Durumları

Firebase Storage, mobil uygulamalarda kullanıcı ve sistem dosyalarını depolamak için kullanılır. En yaygın senaryolar arasında avatarlar ve profil fotoğrafları, içerik akışı resimleri, video ve ses dosyaları, kullanıcılar arasında paylaşım için belgeler (PDF, DOCX) ve küçük ölçekli veri yedekleme yer alır. Tüm bu durumlarda Storage, meta verileri ve bağlantıları depolamak için Firestore ile birlikte özel bir dosya deposu olarak çalışır.

Sosyal uygulamalar en yaygın kullanım durumudur. Her kullanıcı bir avatar, gönderi fotoğrafları ve medya dosyaları yükler. Yol yapısı /users/{uid}/posts/{postId}/image.jpg verileri yalıtır ve Security Rules'ı basitleştirir. Bir kullanıcı silindiğinde, bir Cloud Function tüm kullanıcı dizinlerini tarayarak depolamayı temizleyebilir. Firebase bloguna (2025) göre, bu model Firebase üretim projelerinin %70'inde kullanılır.

E-ticaret uygulamaları, ürün fotoğraflarını, katalogları ve talimatlı PDF dosyalarını depolamak için Firebase Storage'ı kullanır. Bu durumda, dosya erişimi genellikle herkese açıktır (kimlik doğrulama olmadan okuma), yazma erişimi ise izin denetimi ile Cloud Functions aracılığıyla yöneticilerle sınırlıdır. Ürün indirme URL'leri, diğer ürün verilerinin yanında Firestore'da saklanır ve Storage'a ek istekler olmadan resimlerin görüntülenmesini sağlar.

Mesajlaşma uygulamaları ve sohbetler, konuşmalarda gönderilen resimleri ve sesli mesajları Firebase Storage'da saklar. Yol /chats/{chatId}/messages/{messageId}.jpg olarak yapılandırılır. Okuma erişimi, Firestore verilerini kullanan Security Rules aracılığıyla doğrulanan sohbet katılımcılarıyla sınırlıdır. Bu, bir kuralın başka bir Firebase hizmetinden veri okuduğu birkaç senaryodan biridir: allow read: if firestore.exists(/databases/(default)/documents/chats/{chatId}/members/{request.auth.uid}).