Browser Cache, CDN Cache ve HTTP Cache-Control Rehberi

Browser Cache, CDN Cache ve HTTP Cache-Control Rehberi

Bu kapsamlı rehberde browser cache ve CDN cache mantığı, Cache-Control direktifleri, max-age, no-cache, no-store, immutable, ETag kullanımı ve cache invalidation süreçleri request/response örnekleriyle detaylı şekilde açıklanır. İçerik, web geliştiricileri ve sistem yöneticileri için performans, doğruluk ve güncelleme yönetimi açısından pratik bir başvuru kaynağı sunar.

Web performansı denildiğinde akla ilk gelen konulardan biri önbelleklemedir. Doğru kurgulanmış bir cache stratejisi, sunucu yükünü düşürür, sayfa açılışını hızlandırır ve son kullanıcı deneyimini belirgin biçimde iyileştirir. Ancak browser cache, CDN cache, ETag ve cache invalidation gibi başlıklar birbiriyle bağlantılı olduğu için yanlış yapılandırıldığında güncel olmayan içerik, beklenmeyen stale response'lar ve hata ayıklaması zor problemler ortaya çıkabilir.

Bu rehberde HTTP cache mantığını katman katman ele alacağız. Browser cache ile CDN cache arasındaki farkı, Cache-Control direktiflerinin ne yaptığını, ETag ve yeniden doğrulama süreçlerini ve içerik güncelleme sırasında hangi invalidation yöntemlerinin kullanılacağını request/response örnekleriyle inceleyeceğiz.

HTTP Cache Mantığı Nedir ve Neden Önemlidir?

HTTP cache, istemci ile sunucu arasındaki veri alışverişinde daha önce alınmış bir yanıtın tekrar kullanılabilmesini sağlayan bir mekanizmadır. Amaç, her istekte aynı içeriği origin sunucudan yeniden üretmek yerine, belirli kurallara göre mevcut kopyayı kullanmaktır. Bu yaklaşım hem ağ trafiğini azaltır hem de ilk byte süresini iyileştirir. Özellikle statik varlıklar, görseller, CSS ve JavaScript dosyaları için doğru cache politikaları büyük fark yaratır.

Cache yalnızca performans için değil, ölçeklenebilirlik için de kritik bir araçtır. Trafiği yüksek bir uygulamada her isteğin doğrudan uygulama sunucusuna gitmesi CPU, disk ve veri tabanı yükünü hızla artırır. İyi tasarlanmış bir önbellek stratejisi sayesinde aynı dosya veya yanıt yüz binlerce kez üretmek yerine tek sefer üretilip çok kez sunulabilir. Bu durum maliyetleri düşürürken kesintilere karşı dayanıklılığı da artırır.

HTTP cache yapısında birden fazla katman bulunabilir. Kullanıcının tarayıcısındaki browser cache, ISP veya kurumsal proxy katmanları ve edge noktalarda çalışan CDN cache bunların başlıcalarıdır. Aynı response farklı katmanlarda farklı sürelerle tutulabilir. Bu yüzden bir cache politikasını düşünürken yalnızca tarayıcıyı değil, tüm dağıtım yolunu hesaba katmak gerekir.

Browser Cache ve CDN Cache Arasındaki Fark

Browser cache, son kullanıcının cihazındaki tarayıcı tarafından yönetilir. Tarayıcı, daha önce indirilen dosyaları yerel olarak saklar ve cache kuralları uygunsa sonraki isteklerde bu dosyaları ağ üzerinden yeniden çekmeden kullanır. Bu yapı özellikle tekrar ziyaretlerde ve sayfa içi gezintilerde çok etkilidir. Kullanıcı açısından daha hızlı yüklenme ve daha az veri tüketimi anlamına gelir.

CDN cache ise içeriğin kullanıcıya yakın edge sunucularda tutulmasıdır. Kullanıcı bir kaynağı istediğinde, eğer içerik CDN üzerinde mevcutsa istek origin sunucuya gitmeden edge üzerinden yanıtlanır. Böylece coğrafi gecikme azalır, origin üzerindeki yük düşer ve yüksek trafikte daha stabil dağıtım sağlanır. Browser cache yerel seviyede hız sağlar, CDN cache ise dağıtık ağ seviyesinde hız ve ölçek sağlar.

İki cache türü birlikte çalışır, ama davranışları aynı değildir. Tarayıcı bir kaynağı kendi cache'inden sunabilirken CDN aynı kaynağın edge üzerinde süresini doldurmuş olabilir veya tam tersi olabilir. Ayrıca bazı header'lar browser ve shared cache davranışını ayrı ayrı kontrol etmek için tasarlanmıştır. Örneğin public, private ve s-maxage gibi direktifler bu ayrımı yönetmede önemlidir.

Aşağıdaki örnek, bir statik dosya için temel bir response yapısını gösterir:

HTTP
GET /assets/app.8f3a1c.js HTTP/1.1 Host: example.com
HTTP
HTTP/1.1 200 OK Content-Type: application/javascript Cache-Control: public, max-age=31536000, immutable ETag: "app-8f3a1c" Content-Length: 184220

Bu örnekte browser da CDN de dosyayı cache'leyebilir. max-age uzun olduğu için içerik bir yıl boyunca fresh kabul edilir. immutable ifadesi de dosya adı versiyonlandığı sürece tarayıcıya, bu dosyanın değişmeyeceğini söyler.

Cache-Control Direktifi Nasıl Çalışır?

Cache-Control, bir HTTP response'un nasıl cache'leneceğini belirleyen temel başlıktır. Sunucu bu header ile tarayıcıya ve ara cache katmanlarına açık talimat verir. En yaygın kullanım, içeriğin ne kadar süre fresh sayılacağını belirtmek ve cache'in hangi koşullarda yeniden doğrulama yapacağını belirlemektir. Modern web uygulamalarında cache davranışının merkezi çoğunlukla bu başlıktır.

Cache-Control içinde birden fazla direktif birlikte kullanılabilir. public, private, max-age, s-maxage, no-cache, no-store, must-revalidate ve immutable bunların en bilinenleridir. Her biri farklı bir problemi çözer. Örneğin herkese açık statik bir CSS dosyası ile kullanıcıya özel hesap verisinin aynı cache politikasıyla sunulmaması gerekir.

Genel mantık şu şekildedir: response cache için uygunsa önce belirlenen süre boyunca fresh tutulur. Süre dolduğunda veya belirli direktifler bunu gerektirdiğinde yeniden doğrulama yapılır. Eğer içerik uygun değilse veya no-store gibi kesin engeller varsa response hiç saklanmaz. Bu nedenle bir kaynağın doğası, güncellenme sıklığı ve kişiselleştirme seviyesi doğru direktif seçiminde belirleyicidir.

Sık kullanılan bazı direktiflerin kısa özeti şöyledir:

DirektifAnlamıTipik kullanım
publicShared cache'lerde tutulabilirStatik dosyalar, görseller
privateYalnız browser cache için uygundurKullanıcıya özel sayfalar
max-age=6060 saniye fresh kalırSık güncellenen ama cache'lenebilir içerik
s-maxage=300Shared cache için ayrı TTL tanımlarCDN odaklı politika
no-cacheSaklanabilir ama kullanmadan önce doğrulanmalıHTML, API response
no-storeHiç saklanmamalıHassas veri, ödeme adımları
immutableFresh sürede değişmez varsayılırFingerprint'li asset dosyaları

max-age, no-cache, no-store ve immutable Ne Anlama Gelir?

max-age, bir response'un kaç saniye boyunca fresh kabul edileceğini belirtir. Örneğin max-age=3600 bir kaynağın 1 saat boyunca yeniden istenmeden kullanılabileceği anlamına gelir. Bu süre içinde browser cache veya CDN cache, içeriği doğrudan sunabilir. Statik dosyalar için oldukça etkilidir, ancak sık değişen içerikte dikkatli kullanılmalıdır.

no-cache çoğu zaman yanlış anlaşılır. Bu direktif, içeriğin cache'lenemeyeceğini değil, kullanmadan önce yeniden doğrulanması gerektiğini ifade eder. Yani response saklanabilir, fakat cache'deki kopya doğrudan kullanılamaz. Browser veya CDN önce origin'e conditional request gönderir ve içerik değişmediyse 304 Not Modified ile mevcut kopyayı kullanmaya devam eder.

no-store ise çok daha katıdır. Bu direktif verinin hiçbir şekilde cache'e yazılmamasını söyler. Tarayıcı, CDN veya başka ara katman response'u saklamamalıdır. Özellikle kimlik doğrulama sonrası hassas sayfalar, ödeme akışı, tek kullanımlık token dönen endpoint'ler veya gizli veriler için tercih edilir.

immutable ise özellikle fingerprint edilmiş statik dosyalarda güçlü bir optimizasyondur. app.8f3a1c.js gibi hash içeren dosya adlarında içerik değiştiğinde dosya adı da değişir. Bu durumda tarayıcı aynı URL için tekrar doğrulama yapmak zorunda kalmaz. immutable, kullanıcı yeniden yükleme yaptığında bile tarayıcının gereksiz validation yapmasını azaltabilir.

Aşağıda farklı senaryolar için örnek response'lar yer alıyor:

HTTP
HTTP/1.1 200 OK Content-Type: text/css Cache-Control: public, max-age=31536000, immutable

Bu yapı versiyonlu CSS dosyaları için idealdir.

HTTP
HTTP/1.1 200 OK Content-Type: text/html; charset=utf-8 Cache-Control: no-cache ETag: "page-home-v42"

Bu yapı HTML dokümanları için uygundur. İçerik saklanabilir ama her kullanım öncesi doğrulama yapılır.

HTTP
HTTP/1.1 200 OK Content-Type: application/json Cache-Control: no-store

Bu yapı hassas veya anlık API verileri için kullanılır.

ETag ve Conditional Request Mantığı

ETag, bir response'un belirli bir sürümünü temsil eden tanımlayıcıdır. Sunucu bir kaynağa ait ETag değeri üretir ve response header içinde döner. Tarayıcı veya ara cache bu değeri saklar. Daha sonra kaynak yeniden isteneceğinde istemci If-None-Match başlığıyla elindeki ETag'i sunucuya gönderir.

Sunucu, mevcut içeriğin ETag değeri ile istemcinin gönderdiğini karşılaştırır. Eğer içerik değişmemişse tüm gövdeyi yeniden göndermek yerine 304 Not Modified döner. Böylece bant genişliği korunur ve yanıt süresi düşer. Eğer içerik değişmişse sunucu yeni body ve yeni ETag ile 200 OK döner.

Basit bir doğrulama akışı şu şekildedir:

HTTP
GET /blog/cache-rehberi HTTP/1.1 Host: example.com
HTTP
HTTP/1.1 200 OK Content-Type: text/html; charset=utf-8 Cache-Control: no-cache ETag: "post-981-v3" Content-Length: 24518

Tarayıcı bu yanıtı aldıktan sonra içeriği saklar. Sonraki istekte şu header ile gelir:

HTTP
GET /blog/cache-rehberi HTTP/1.1 Host: example.com If-None-Match: "post-981-v3"

İçerik değişmemişse sunucu şöyle cevap verir:

HTTP
HTTP/1.1 304 Not Modified Cache-Control: no-cache ETag: "post-981-v3"

İçerik değişmişse yeni response şu şekilde olabilir:

HTTP
HTTP/1.1 200 OK Content-Type: text/html; charset=utf-8 Cache-Control: no-cache ETag: "post-981-v4" Content-Length: 25102

ETag üretimi güçlü veya zayıf olabilir. Güçlü ETag byte seviyesinde aynı içeriği temsil ederken, zayıf ETag semantik olarak aynı kabul edilen sürümleri ifade edebilir. Uygulama katmanında çoğu senaryoda içerik sürüm numarası, hash veya last update timestamp tabanlı ETag üretmek yeterlidir. Ancak load balancer arkasında birden fazla sunucu varsa tüm node'ların tutarlı ETag üretmesi önemlidir.

Request ve Response Örnekleriyle Yaygın Senaryolar

Pratikte tüm kaynaklar için tek tip cache politikası kullanmak doğru değildir. HTML sayfalar, API response'ları, kullanıcıya özel veriler ve statik varlıklar farklı davranış ister. Bu nedenle aşağıdaki senaryolar, gerçek uygulamalarda en sık karşılaşılan yapıların mantığını anlamak açısından önemlidir.

Fingerprint edilmiş statik dosya

HTTP
GET /static/main.a1b2c3d4.js HTTP/1.1 Host: cdn.example.com
HTTP
HTTP/1.1 200 OK Content-Type: application/javascript Cache-Control: public, max-age=31536000, immutable Content-Length: 402122

Burada dosya adı içerik hash'i taşıdığı için uzun süreli cache güvenlidir. Yeni deploy geldiğinde URL değişir ve eski dosyayı invalid etmeden yeni dosya çağrılır. Bu yaklaşım cache invalidation problemini büyük ölçüde sadeleştirir.

Sık güncellenen HTML sayfası

HTTP
GET / HTTP/1.1 Host: www.example.com
HTTP
HTTP/1.1 200 OK Content-Type: text/html; charset=utf-8 Cache-Control: no-cache ETag: "home-v128"

Anasayfa gibi içeriklerin tam anlamıyla no-store olması gerekmez. no-cache ile saklanır ama yeniden doğrulanır. Böylece hem güncellik korunur hem de değişmeyen durumda body transferi engellenir.

Kullanıcıya özel dashboard verisi

HTTP
GET /api/account HTTP/1.1 Host: app.example.com Authorization: Bearer token
HTTP
HTTP/1.1 200 OK Content-Type: application/json Cache-Control: private, no-store

Bu veri kullanıcıya özeldir ve hassastır. Shared cache'de tutulmamalı, hatta çoğu durumda tarayıcıda da saklanmamalıdır. private, response'un ortak cache'lerde tutulmaması gerektiğini belirtir; no-store ise saklamayı tamamen engeller.

CDN için ayrı TTL tanımlama

HTTP
HTTP/1.1 200 OK Content-Type: application/json Cache-Control: public, max-age=60, s-maxage=300 ETag: "listing-v55"

Bu örnekte browser 60 saniye boyunca response'u fresh kabul eder. CDN gibi shared cache'ler ise 300 saniye boyunca içeriği fresh tutabilir. Böylece son kullanıcı tarafında daha kısa, edge tarafında daha uzun bir TTL stratejisi uygulanmış olur.

Cache Invalidation Nedir ve Neden Zordur?

Cache invalidation, cache'te tutulan içeriğin artık geçerli olmadığını sisteme kabul ettirme sürecidir. Bilgisayar biliminde zor problemlerden biri olarak anılmasının sebebi, performans ile doğruluk arasındaki dengeyi kurmanın kolay olmamasıdır. İçeriği çok uzun cache'lerseniz eski veri gösterirsiniz, çok kısa cache'lerseniz performans avantajını kaybedersiniz. Üstelik browser, CDN ve origin katmanlarının her biri farklı zamanlarda farklı kararlar verebilir.

Cache invalidation iki temel yaklaşım üzerinden düşünülür. Birincisi URL değiştirme, yani content versioning veya cache busting yöntemidir. İkincisi mevcut URL'yi koruyup cache'teki kopyayı purge, revalidate veya expire etmektir. Modern frontend dağıtımlarında statik dosyalar için en güvenli yöntem genellikle dosya adı versiyonlamasıdır.

Örneğin app.js yerine app.8f3a1c.js kullanıldığında yeni deploy ile birlikte app.b7d912.js yayınlanır. Böylece eski URL eski içeriği gösterse bile uygulama yeni HTML içinde yeni dosyayı referans eder. CDN purge işlemi zorunlu olmaz. Ancak HTML dokümanları, API response'ları veya aynı URL altında kalması gereken içerikler için farklı invalidation stratejileri gerekir.

Yaygın invalidation yöntemleri şunlardır:

  • Cache busting: Dosya adını veya query string'i değiştirmek
  • TTL bazlı sonlandırma: Süre dolunca kaynağın yeniden alınması
  • Revalidation: ETag veya Last-Modified ile doğrulama
  • CDN purge: Belirli URL veya pattern için edge cache temizleme
  • Soft purge veya stale-while-revalidate benzeri yaklaşım: Kullanıcıya eski içerik verilirken arka planda yenileme

En iyi yaklaşım çoğu zaman hibrittir. Statik asset'ler için fingerprint, HTML için no-cache artı ETag, API için veri hassasiyetine göre private veya kısa TTL kombinasyonu kullanılır. Böylece hem dağıtım güvenliği hem de performans dengelenir.

En İyi Uygulamalar ve Sık Yapılan Hatalar

En iyi cache stratejisi, tüm kaynakları sınıflandırmakla başlar. Önce hangi içeriğin statik, hangisinin dinamik, hangisinin kullanıcıya özel ve hangisinin herkese açık olduğunu netleştirmek gerekir. Bu ayrım yapılmadan tek tip Cache-Control politikası uygulamak sorun üretir. Özellikle HTML ile asset dosyalarını aynı mantıkla cache'lemek yaygın bir hatadır.

Statik dosyalar için dosya adı hash'leme neredeyse standart kabul edilmelidir. CSS, JS, font ve derleme ile üretilen görseller için public, max-age=31536000, immutable politikası oldukça verimlidir. Ancak bu yalnızca URL değiştiğinde yeni sürümün sunulacağından eminseniz güvenlidir. Versiyonlama yoksa uzun TTL ciddi güncellik problemleri yaratır.

HTML belgelerinde çoğu projede no-cache iyi bir başlangıçtır. Böylece sayfa saklanır ama her kullanım öncesi doğrulanır. no-store yalnızca gerçekten saklanmaması gereken hassas sayfalar için kullanılmalıdır. Aksi halde gereksiz performans kaybı yaşanır. Birçok ekip, yalnızca güncellik istedikleri için no-store kullanır, ancak bu gereksiz sert bir tercihtir.

API tarafında da veri türüne göre ayrım yapmak gerekir. Herkese açık ve saniyelik değişmeyen listeleme verileri kısa süreli public cache ile sunulabilir. Kullanıcı profili, sipariş bilgisi veya oturum verisi ise private veya no-store gerektirebilir. CDN üzerinden API cache'lemek isteniyorsa Vary, Authorization ve cookie davranışları dikkatle ele alınmalıdır.

Sık yapılan hatalar arasında şunlar öne çıkar:

  • Versiyonlama yapmadan uzun max-age vermek
  • no-cache ile no-store'u aynı sanmak
  • Kullanıcıya özel response'ları public cache'lemek
  • ETag üretimini sunucular arasında tutarsız bırakmak
  • CDN purge sonrası browser cache'i hesaba katmamak
  • HTML dokümanlarını immutable benzeri agresif stratejilerle sunmak

Pratik Kurulum Önerileri ve Son Notlar

Gerçek dünyada uygulanabilir basit bir strateji kurmak isteyen ekipler için iyi bir başlangıç modeli vardır. Build ile üretilen tüm statik dosyaları fingerprint edin ve uzun süreli immutable cache verin. HTML belgelerini no-cache ve mümkünse ETag ile sunun. Kullanıcıya özel API response'larında private veya no-store kullanın. Genel API listelemelerinde ise iş ihtiyacına göre kısa TTL ve gerekiyorsa s-maxage ekleyin.

CDN kullanıyorsanız browser ile edge davranışını ayrı düşünün. Tarayıcı için daha kısa max-age, CDN için s-maxage ile daha uzun edge cache tanımlamak çok işe yarar. Deploy süreçlerine CDN purge adımı eklenebilir, ancak asıl hedef purge bağımlılığını azaltmak olmalıdır. Bunu da çoğunlukla doğru URL versiyonlama stratejisi sağlar.

Web sitesi ve platform altyapısı sunan yapılarda bu konular daha da önemlidir. Çünkü aynı altyapıda hem kurumsal sayfalar, hem blog içerikleri, hem de daha gelişmiş web tabanlı servisler çalışabilir. Pratikweb gibi yönetilen web çözümlerinde doğru caching kurgusu, yalnızca hız değil, yayın güvenliği ve sürdürülebilir ölçek açısından da fark yaratır. Özellikle ebazaars tabanlı servis yaklaşımında farklı içerik tipleri için ayrı cache politikaları tanımlamak performansı daha öngörülebilir hale getirir.

Sonuç olarak amaç, her şeyi agresif biçimde cache'lemek ya da her şeyi tamamen canlı sunmak değildir. Doğru hedef, her kaynak için uygun doğruluk ve hız dengesini kurmaktır. Kendi sisteminizde önce kaynak envanteri çıkarın, sonra response header'larını gözden geçirin ve gerçek tarayıcı ile CDN davranışını test ederek ilerleyin. Sağlam bir cache stratejisi, performans optimizasyonunun yan ürünü değil, mimarinin doğrudan parçasıdır.