Giriş

IPFS (InterPlanetary File System), Filecoin ve yeni ortaya çıkan blokzincir‑tabanlı çözümler gibi merkeziyetsiz depolama sistemleri, verilerin arşivlenme, paylaşılma ve erişilme şeklini yeniden şekillendiriyor. Geleneksel bulut kovalarından farklı olarak bu ağlar içeriği dağıtık düğümler arasında çoğaltır, içerik‑adreslenebilirliği garanti eder ve çoğu zaman katılımcılara yerel tokenlar verir. Bu özelliklerden faydalanmak için dosyalar, protokollerin beklentileriyle uyumlu bir biçimde sunulmalıdır: belirleyici hashleme, uygun parçalara bölme ve dönüşüm sürecinden geçen meta veriler. Bu kılavuz, doğru kaynak formatının seçilmesinden nihai CID’nin (İçerik Tanımlayıcısı) doğrulanmasına kadar tüm hazırlık hattını adım adım anlatır; böylece belgeleri, görüntüleri, veri setlerini veya medyayı merkeziyetsiz depolamaya taşıyabilir, kaliteyi ya da gizliliği kaybetmezsiniz.

1. İçerik‑Adreslenebilir Depolamayı Anlamak

IPFS dosyaları isimle değil, ikili temsillerinin kriptografik hash’iyle saklar. Bayt akışı tek bir bit değişse bile ortaya çıkan hash (ve dolayısıyla CID) değişir. Bu değişmezlik kaynak doğrulama için çok güçlüdür, ancak dönüşüm sırasında istemeden yapılan bir varyasyon da orijinal dosya ile depolanan kopya arasındaki bağlantıyı kırar. İki pratik sonuç ortaya çıkar:

Deterministik ön işleme – Dosyayı değiştiren tüm adımlar tekrar üretilebilir olmalıdır. Daha sonra bir CID yeniden oluşturmanız gerektiğinde aynı hattı çalıştırıp aynı bayt dizisini elde edebilmelisiniz.
İlave verilerin korunması – Meta veri, zaman damgaları ve EXIF bilgileri hash’in bir parçası haline gelir. Bunları farkında olmadan silmek CID’yi değiştirir ve değerli bağlamı kaybettirebilir.

Bu nedenle dönüşüm iş akışı, neyin saklanıp neyin çıkarıldığını ve nedenini açıkça belirtmelidir.

2. Doğru Kaynak Formatını Seçmek

Farklı dosya türleri boyut, düzenlenebilirlik ve kendi‑tanımlı özellikler açısından farklı niteliklere sahiptir. Merkeziyetsiz depolamaya hedeflenirken tercih edilmesi gereken formatlar şunlardır:

Kendine yeten – Gerekli tüm bilgi (yazı tipleri, renk profilleri, altyazılar) gömülü olmalıdır. Örneğin bir PDF/A, WebP ya da Matroska (MKV) dosyası kendi render talimatlarını taşır.
Platformlar arası kararlı – PNG, FLAC veya CSV gibi açık standartlar, ikili temsili etkileyebilecek tescilli varyasyonlara daha az açıktır.
Sıkıştırılabilir – Depolama maliyetleri (Filecoin ya da özel bir IPFS düğümü olsun) genellikle bayt üzerinden ölçülür; zaten kayıpsız sıkıştırma uygulayan bir format seçmek toplam veri ayak izini azaltır.

Orijinal varlığınız bu kriterleri karşılamayan bir formatta ise – örneğin çok katmanlı bir PSD ya da makrolu bir DOCX – yüklemeden önce kararlı bir alternatife dönüştürün. Dönüşüm, kaynak yapısına saygı gösteren bir araçla yapılmalıdır; convertise.app gibi güvenilir bir bulut hizmeti, gizli meta veri eklemeden toplu dönüşümleri halledebilir.

3. İkili Temsili Normalleştirmek

Kararlı bir format seçildikten sonra bile farklı yazılım uygulamaları ince farklar yaratabilir. Belirleyici bir çıktı sağlamak için aşağıdaki normalleştirme adımlarını uygulayın:

Satır sonlarını standartlaştır – Tüm metin‑tabanlı dosyaları LF (\n) biçimine dönüştür.
Meta veri girişlerini sırala – Anahtar‑değer çiftleri depolayan formatlarda (ör. JPEG‑de EXIF), alfabetik sıralamayı zorunlu kıl.
Gerekli olmayan zaman damgalarını kaldır – Bazı kaplayıcılar oluşturma tarihleri gömer. Bunlar aşağı yönlü kullanım için gerekli değilse, hash’in stabil kalması için silin.

Görseller için exiftool -All= -TagsFromFile @ -All:All, PDF’ler için pdfcpu trim gibi araçlar ince ayar kontrolü sağlar. Her komutu sürüm‑kontrollü bir betikte belgeleyin, böylece dönüşüm tam olarak yeniden üretilebilir.

4. Büyük Dosyalar İçin Parçalama Stratejileri

IPFS veriyi otomatik olarak 256 KB bloklara ayırır, ancak kendi CAR (Content‑Addressable Archive) dosyalarınızı oluşturarak bu süreci etkileyebilirsiniz. Manuel parçalama iki avantaj sunar:

Paralel alma – Büyük veri setleri mantıksal olarak gruplanmış CAR dosyalarına bölündüğünde, eş‑dönüşümcüler yalnızca ihtiyaç duydukları parçayı alabilir.
Alt‑bileşenler için öngörülebilir CID’ler – Parça sınırlarını önceden tanımlayarak, bir veri setinin bireysel bölümleri için sabit tanımlayıcılar elde edilir; bu sürüm takibi için faydalıdır.

Tipik bir iş akışı şu şekildedir:

# Kaynağı kararlı bir formata dönüştür (ör. CSV → Parquet)
convertise.app --input data.csv --output data.parquet

# Özel bir parça boyutu ile CAR arşivi oluştur
ipfs-car pack --chunker=size-1MiB data.parquet -o data.car

# IPFS’e ekle (veya bir Filecoin anlaşması) ve kök CID’yi yakala
ipfs add data.car

--chunker=size-1MiB bayrağı, varsayılan 256 KB yerine 1 MiB bloklar kullanılmasını söyler; bu, çok büyük dosyalar için performansı artırabilir.

5. Doğrulama Bilgisi Gömmek

CID zaten bir hash olduğu için bir doğrulama jetonu görevi görür. Ancak dosyalar birden çok elden (katkıcılar, denetçiler, depolama sağlayıcıları) geçiyorsa, CID’nin yanına insan‑okunur bir kontrol toplamı (SHA‑256, MD5) eklemek el ile kontrolleri basitleştirir.

Her varlığı, CID’sini ve isteğe bağlı bir kontrol toplamını listeleyen küçük bir manifest.json oluşturun:

{
  "assets": [
    {
      "filename": "report.pdf",
      "cid": "bafybeih5z...",
      "sha256": "3a7bd3e2360..."
    },
    {
      "filename": "data.car",
      "cid": "bafybeifhj...",
      "sha256": "d2c4f9a5f..."
    }
  ]
}

Manifest’i de IPFS’e ekleyin – ipfs add manifest.json – bu tek referans noktasını birden çok düğüm sabitleyebilir. İlerideki tüketiciler, saklanan kontrol toplamını yeni bir hesapla karşılaştırarak rastgele bozulmaları tespit edebilir.

6. Dönüşüm Sırasında Gizlilik Hususları

Merkeziyetsiz ağlar varsayılan olarak herkese açıktır. Kaynak materyal kişisel veri (PII), gizli iş bilgileri ya da telif hakkı korunan içerik içeriyorsa, yüklemeden önce gizlilik önlemleri alın:

Kırpma – Hassas bölgeleri (ör. PDF’de kara kutular) kalıcı olarak kaldıran araçlar kullanın; sadece görünmez hâle getirmek yetmez.
Şifreleme – Son dosyayı simetrik bir şifreleme katmanı (AES‑256) ile sarın ve şifre çözme anahtarını zincir‑dışı tutun. Şifreli blok güvenle IPFS’e konulabilir; yalnızca yetkili kişiler anahtarıyla orijinali görebilir.
Sıfır‑Bilgi Kanıtları – Gelişmiş senaryolarda, dosyanın kendisini ifşa etmeden bütünlüğüne dair kriptografik kanıt depolamayı düşünün. Bu konu bu makalenin kapsamı dışındadır, ancak uyumluluk‑ağır ortamlar için araştırmaya değerdir.

Şifrelerken, şifreleme işleminin dosyanın ikili temsiliyi değiştirdiğini unutmayın; CID, şifreli sürümle eşleşir. Dönüşüm adımlarını manifest’inizde kaydedin.

7. Sabitleme (Pinning) ve Kalıcılık Stratejileri

IPFS tek başına uzun vadeli depolama garantilemez; içerik, hiç kimse sabitlemediğinde kaybolur. Üç tamamlayıcı yaklaşım vardır:

Kendi sabitlemen – Kişisel bir IPFS düğümü çalıştırıp ihtiyacınız olan CID’leri sabitleyin. Doğrudan kontrol sağlar ancak donanım ve bant genişliği gerektirir.
Sabitleme hizmetleri – Pinata, Eternum veya Infura gibi şirketler ücretli sabitleme sunar. Veri gizliliğine saygı gösteren ve yeniden üretilebilir sabitleme günlükleri sağlayan bir sağlayıcı seçin.
Filecoin anlaşmaları – Arşivleme amaçlı, Filecoin ağında bir depolama kontratı (deal) yapın. Anlaşma, bir madencinin replikasyon kanıtını verinize bağlar ve belirlenen süre boyunca kalıcılığı temin eder.

Yöntem ne olursa olsun, sabitlenen CID’nin sizin oluşturduğunuz CID ile aynı olduğundan emin olun. Kendi düğümünüzde ipfs pin ls --type=recursive komutu tüm sabitlenmiş nesneleri listeler.

8. Dosyaları Bağlantıyı Kırmadan Güncellemek

CID’ler değişmez olduğundan dosyada herhangi bir değişiklik yeni bir tanımlayıcı üretir ve mevcut bağlantılar kırılır. Sürekliliği korurken güncellemeye izin vermek için bir yönlendirme katmanı kullanın:

IPNS (InterPlanetary Naming System) – En son CID’ye yönelten değiştirilebilir bir işaretçi yayınlayın. Kullanıcılar IPNS ismini çözerek güncel sürümü alabilir.
Değiştirilebilir DNSLink – DNS’i IPNS ile birleştirerek alan adınıza bir TXT kaydı (dnslink=/ipfs/<cid>) ekleyin. DNS kaydını güncellemek, temel CID’yi değiştirir ama alan adı URL’si aynı kalır.

Her iki yöntem de kriptografik imzalara dayanır; özel anahtarınızı güvende tutun ve sadece zorunlu olduğunda değiştirin.

9. Vaka Çalışması: Açık Erişimli Araştırma Arşivi Yayınlama

Bir üniversite bölümü, tezler, veri setleri ve ek videolar koleksiyonunu ücretsiz olarak sunmak ve akademik bütünlüğü korumak istedi. Ekip şu adımları izledi:

Standartlaştırma – Tüm tezler toplu bir işlemle PDF/A‑2b’e dönüştürüldü; veri setleri Parquet, videolar AV1‑kodlu WebM’e çevrildi.
Normalleştirme – Atıfla ilgisi olmayan meta veri (ör. yazarın yerel dosya yolu) temizlendi.
Parçalama – Büyük video dosyaları 4 MiB bloklu CAR arşivlerine paketlendi, böylece parçalı akış mümkün oldu.
Doğrulama – CID ve SHA‑256 toplamlarını içeren bir manifest.json oluşturuldu ve Git’te sürüm‑kontrol edildi.
Gizlilik – Kişisel veri içeren tezler bölüm‑geniş bir anahtarla şifrelendi; şifre çözme anahtarı güvenli bir kasada saklandı.
Sabitleme – Üniversite kendi IPFS düğümünü çalıştırıp tüm koleksiyonu sabitledi; paralel bir Filecoin anlaşmasıyla 5‑yıllık arşiv garantisi sağlandı.
Erişim – Bir IPNS ismi (k51...) yayınlandı ve bölümün web sitesine linklendi. Öğrenciler ve araştırmacılar, CID’yi bilmelerine gerek kalmadan, her zaman en yeni sürümü alabilmek için bu ismi çözdüler.

Sonuç, kalıcı, müdahale‑kanıtlayıcı bir depo oldu; akademik çalışmalar IPNS kalıcı linkiyle atıf alabilirken, altta yatan CID’ler kimlik doğrulama kanıtı sağladı.

10. İş Akışını Otomatikleştirmek

Sürekli projelerde manuel yürütme hızla hataya açık hâle gelir. Tipik bir otomasyon betiği (bash veya PowerShell) şöyle görünebilir:

#!/usr/bin/env bash
set -euo pipefail

# 1. Kaynak dosyaları dönüştür (örnek: DOCX -> PDF/A)
for src in ./source/*.docx; do
  base=$(basename "$src" .docx)
  convertise.app --input "$src" --output "./converted/${base}.pdf" --format pdfa
done

# 2. PDF meta verilerini normalleştir
for pdf in ./converted/*.pdf; do
  pdfcpu trim "$pdf" "${pdf}.norm"
  mv "${pdf}.norm" "$pdf"
done

# 3. CAR arşivleri oluştur (1 MiB parçalar)
for file in ./converted/*; do
  ipfs-car pack --chunker=size-1MiB "$file" -o "./car/$(basename "$file").car"
done

# 4. IPFS’e ekle ve CID’leri yakala
manifest="{\"assets\": ["
for car in ./car/*.car; do
  cid=$(ipfs add -q "$car")
  sha=$(sha256sum "$car" | cut -d' ' -f1)
  manifest+="{\"filename\": \"$(basename "$car")\", \"cid\": \"$cid\", \"sha256\": \"$sha\"},"
  # CAR dosyasını sabitle
  ipfs pin add "$cid"
done
manifest=${manifest%,}]
}

echo -e "$manifest" > manifest.json
ipfs add -q manifest.json

Betik bir Git deposunda tutulduğunda, ekipteki herkes aynı dönüşüm hattını yeniden üretebilir; CI/CD araçları yeni bir kaynak materyal belirli bir klasöre geldiğinde süreci otomatik tetikleyebilir.

11. Yaygın Tuzaklar ve Çözüm Önerileri

Tuzak	Belirti	Çözüm
Deterministik olmayan zaman damgaları	Aynı dosyayı yeniden eklediğinizde farklı CID alınır.	Normalleştirme sırasında oluşturma/güncelleme tarihlerini silin veya standartlaştırın.
Gizli meta veri sızıntısı	Son CID’de istenmeyen hassas bilgiler bulunur.	Yüklemeden önce `exiftool -a -G1 -s file` gibi bir meta veri denetimi yapın.
Parça boyutu uyumsuzluğu	Eş‑dönüşümcüler farklı blok sınırları beklediğinde alım başarısız olur.	Tüm veri seti için tek bir parça boyutu seçin ve belgeleyin.
Sabitlememiş içerik	Dosya birkaç gün içinde kaybolur.	`ipfs pin ls` ile sabitleme durumunu kontrol edin ve otomatik sabitleme yenilemesi ayarlayın.
Anahtar yönetimsiz şifreleme	Yetkili kullanıcılar veriyi açamaz.	Şifre çözme anahtarlarını güvenli bir gizli yönetici (secret manager) içinde saklayın ve manifest’te referans verin.

Bu sorunları erken aşamada ele almak, veri bütünlüğü kaybını ve gereksiz yeniden yüklemeleri önler.

12. Merkeziyetsiz Dönüşümü Şekillendiren Gelecek Trendleri

İçerik‑Adreslenebilir Medya Formatları – CAR‑V2 gibi yeni standartlar, CID’yi doğrudan dosya başlıklarına gömerek doğrulamayı basitleştirir.
Sıfır‑Bilgi Depolama – Şifreli veri depolarken aynı anda aranabilir indeksler sunan protokoller gelişiyor; bu da ayrı bir kırpma adımına duyulan ihtiyacı azaltıyor.
Uç‑tan‑IPFS Ağ Geçitleri – Ağ kenarındaki cihazlar (IoT sensörleri gibi) ham telemetriyi CBOR ya da Parquet’e dönüştürüp doğrudan IPFS’e itebilir, merkezi sunucuları devre dışı bırakır.
Dinamik NFT’ler – Dosyalar, farklı gösterim bağlamlarına uyum sağlamak için anlık dönüşüm gerektirebilir; bu da deterministik iş akışları talep eder.

Bu gelişmeleri takip etmek, ekosistemin evrimini göz önünde bulundurarak uyumlu dönüşüm hatları tasarlamanıza yardımcı olur.

13. Sonuç

Dosyaları merkeziyetsiz ağlara koymak yalnızca bir “yükle” işlemi değildir; deterministik çıktı garantisi, kritik meta verilerin korunması ve gizliliğin gözetilmesi için disiplinli bir dönüşüm süreci gerekir. Kararlı kaynak formatları seçerek, ikili temsili normalleştirerek, amaçlı parçalama yaparak ve her adımı yeniden üretilebilir bir betikte belgelerken, yıllar boyunca değişmez referanslar sağlayan CID’ler üretebilirsiniz. Sabitleme stratejileri ve IPNS gibi bir yönlendirme katmanı ile veriniz dayanıklı ve tek bir sağlayıcıya bağlı kalmadan erişilebilir olur.

Burada anlatılan teknikler, geliştiricileri, arşivcileri ve içerik üreticilerini IPFS, Filecoin ve ilgili blokzincir depolama çözümlerinin sunduğu avantajları, yüksek kalite standartlarını koruyarak kullanmaya hazırlar. Araştırma arşivi, kurumsal bilgi tabanı ya da halka açık bir medya kütüphanesi hazırlıyor olun; prensipler aynıdır: deterministik dönüşüm, doğrulanmış bütünlük ve gizlilik‑ilkeliği işleme.

Merkezi Olmayan Dosya Depolama: IPFS ve Blockchain için Dosyaları Dönüştürme ve Hazırlama