Loading...

Performans · 9 dk okuma

Cache-Control ve max-age: pratik rehber

Cache-Control, tarayıcılara ve CDN'lere bir cevabı ne kadar süre yeniden kullanabileceklerini söyleyen başlıktır. Doğru ayarlarsanız tekrar ziyaretler anında açılır ve origin'iniz sessiz kalır; yanlış ayarlarsanız ya bir yıl boyunca bayat sayfa sunarsınız ya da cache'lemeyi tümden çöpe atarsınız. Bu rehber her direktifi sade dille anlatır ve hemen her siteyi kapsayan üç durum için hazır reçeteler verir.

Güncellendi

Cache-Control ve max-age: pratik rehber

Bu başlığı kim dinliyor

Tek bir cevap birkaç cache'ten geçer: ziyaretçinin tarayıcısı (özel — tek kişiye sunar), CDN edge'i (paylaşımlı — herkese sunar) ve bazen arada bir proxy. Cache-Control, origin'in hepsiyle aynı anda konuşma şeklidir; ayrı ayrı hitap eden direktiflerin var olma sebebi de budur.

Bu ayrım geri kalan her şeyi belirler. Girişli bir kontrol paneli o kullanıcının tarayıcısında cache'lenebilir ama başka bir kullanıcının alabileceği edge'de asla cache'lenmemelidir. Herkese açık bir pazarlama sayfası tam tersidir: edge'de sıkı, tarayıcıda kısa cache'leyin. Önce "özel mi paylaşımlı mı" diye karar vermek diğer bütün seçimleri belirgin hâle getirir.

Gerçekten önemli olan direktifler

max-age=N — N saniye boyunca tekrar sormadan kullanılabilir. Ana kadran.

s-maxage=N — aynısı, ama yalnızca paylaşımlı cache'ler (CDN) için. Varsa edge ona uyar ve max-age'i yok sayar; böylece bir şeyi edge'de bir saat, tarayıcılarda bir dakika tutabilirsiniz.

public / private — public her cache tarafından saklanabilir; private saklamayı yalnızca o tarayıcıya kısıtlar. Kullanıcıya özel her şey private olmalıdır.

no-cache — sakla ama her kullanımdan önce origin ile doğrula. Değişmediğinde ucuzdur: sunucu gövdesiz 304 Not Modified cevaplayabilir.

no-store — hiçbir cache'e, ne bellekte ne diskte yazma. Bunu gerçekten hassas cevaplara saklayın; "lütfen taze olsun" değil, "hiç kopya tutma" demektir.

immutable — bu gövde bu URL'de asla değişmeyecek, yenilemede bile doğrulama yapma. Yalnızca sürümlü dosya adları için doğrudur.

stale-while-revalidate=N — süre dolduktan sonra, arka planda tazesi çekilirken bayat kopyayı N saniyeye kadar sunmaya devam et. Ziyaretçi yeniden çekmeyi hiç beklemez.

Çoğu siteyi kapsayan üç reçete

Sürümlü statik varlıklar — dosya adı içerik değiştikçe değişir, yani URL sonsuza kadar cache'lenebilir. Bu, mevcut en büyük ve en güvenli cache kazancıdır.

HTML sayfalar — URL aynı kalırken içerik değişir, yani kısa ömür gerekir. Kısa bir max-age artı stale-while-revalidate, dünkü sayfayı sunmadan hız verir.

Özel ya da kişiselleştirilmiş cevaplar — kontrol panelleri, sepetler, giriş arkasındaki her şey. Paylaşımlı cache'lerin dışında tutun; sizin için güvenliyse tarayıcı kısa süre tutabilir.

Kopyala-yapıştır başlangıç noktaları — sayıları sürüm sıklığınıza göre ayarlayın

# surumlu varliklar: /js/app.a1b2c3.js
Cache-Control: public, max-age=31536000, immutable

# HTML sayfalar (tarayicida kisa, edge'de uzun, yenilemede bekletmeden)
Cache-Control: public, max-age=60, s-maxage=600, stale-while-revalidate=86400

# kullaniciya ozel sayfalar: edge'e asla
Cache-Control: private, no-store

# sik degisen ama biraz gecikebilen bir API cevabi
Cache-Control: public, max-age=0, s-maxage=30, stale-while-revalidate=60

no-cache vs no-store: kaçınmaya değer hata

Bunlar eşanlamlı gibi okunur ama hiç benzemezler. no-cache saklamaya izin verir, yeniden kullanmadan önce doğrulama ister — kopya kalır ve hâlâ güncelse sunucu gövdesiz 304 döner, ki bu çok ucuzdur. no-store cevabı herhangi bir yerde tutmayı yasaklar.

no-cache demek isterken no-store'a uzanmak, hiçbir fayda karşılığında bütün optimizasyonu çöpe atar: hiçbir şey değişmese bile her istek tam indirme olur. no-store'u yalnızca saklanmış bir kopyanın kendisi sorun olduğunda kullanın — banka ekstreleri, parola sıfırlama sayfaları, paylaşılan bir makinenin cache'inde durmaması gereken her şey. "Hep en yenisini göster" için doğru ve çok daha ucuz cevap no-cache'tir.

Bu CDN'inizle nasıl etkileşiyor

Cache-Control ve max-age: pratik rehber — Bu CDN'inizle nasıl etkileşiyor
Statik dosyalar için yayınlama kuralı: /assets/ ile başlayan yollar 30 gün önbellekte tutulur.

Origin'inizin gönderdiği başlıklar, edge'in bir kopyayı ne kadar tutacağına karar verirken uyduğu şeydir — bu da Cache-Control'ü bir tarayıcı ayrıntısı değil, bütün dağıtım zincirinizin kontrol yüzeyi yapar. s-maxage gönderin, edge ona uyar; no-store gönderin, edge hiç cache'lemeyi reddeder — yani her istek origin'inize gider ve o cevap için CDN'i fiilen kapatmış olursunuz.

cdn.com.tr'de, uygulamanın başlıklarını değiştiremediğiniz durumlarda cache davranışını panelden dağıtım kuralı bazında da ayarlayabilirsiniz — dokunmak istemediğiniz eski uygulamalar için kullanışlıdır. Cache'lenmiş bir URL'in döndürdüğünü değiştirdiğinizde, edge'in süresi dolana kadar hâlâ önceki kopyayı tuttuğunu unutmayın: purge tam da bunun içindir.

Hangisinin kazandığı kurala bakar ve panelde görünür: kuralda Kaynak sunucunun önbellek başlıklarına uy seçiliyse origin'inizin başlığı hem edge süresini belirler hem de tarayıcıya değişmeden ulaşır. O kuralda Sabit süre önbelleğe al'ı seçerseniz origin başlıkları yok sayılır — üstelik yalnız edge'de değil, tarayıcıya giden başlık da bizim sürelerimizle yeniden yazılır. Kural başına biri geçerlidir, ikisi birden değil.

Küçük bir ipucu: yanıtta iki ayrı Cache-Control satırı görüyorsanız, ikincisini origin değil edge eklemiştir. Tek virgüllü satır sizin yazdığınızdır. Dört katmanlı gerçek bir örnek: bir haber sitesinin cache header düzeni.

Gerçekte ne gönderdiğinizi kontrol edin

Başlıklar hakkındaki varsayımlar sık sık yanlıştır — bir framework, eklenti ya da web sunucusu varsayılanı çoğu zaman ayarladığınızı sandığınız şeyi ezer. Her URL tipi için tek komutla doğrulayın; sürümlü bir varlığa ve bir HTML sayfaya ayrı ayrı bakın, çünkü tamamen farklı görünmeleri gerekir. Ayrıca herkese açık cache'lemek istediğiniz bir cevaptaki Set-Cookie'ye dikkat edin: birçok cache bunları saklamayı reddeder ve bir sayfanın gizemli biçimde hiç cache'lenmemesinin yaygın sebebidir.

Gerçek cevap başlıklarını okuyun

# edge ve origin gercekte ne diyor
curl -sI https://example.com/ | grep -i "cache-control\|age\|set-cookie"

# surumlu bir varlikla karsilastir (uzun max-age olmali)
curl -sI https://example.com/js/app.a1b2c3.js | grep -i cache-control

ETag ve yeniden doğrulama (If-None-Match, 304 Not Modified)

ETag, sunucunun bir yanıta iliştirdiği parmak izidir: ETag: "5f2b-1a3c" gibi. Cache'teki kopyanın süresi dolduğunda ya da Cache-Control no-cache dediğinde tarayıcı dosyayı körlemesine yeniden indirmez; elindeki parmak izini If-None-Match başlığıyla geri gönderir. Hiçbir şey değişmediyse sunucu 304 Not Modified döner: yalnız başlıklar, gövde yok. Tarayıcı kopyasını kullanmaya devam eder ve tazelik sayacı baştan başlar. no-cache'i ucuz yapan budur.

ETag iki güçte gelir. Düz bir değer ("abc") güçlü ETag'dir: içeriğin bayt bayt aynı olduğunu vaat eder; range istekleri ve yarıda kalan indirmelerin sürdürülmesi buna dayanır. Başındaki W/ (W/"abc") zayıf ETag'i işaretler: içerik eşdeğerdir ama baytlar aynı olmayabilir — aynı sayfanın gzip ve Brotli sürümleri gibi. Yeniden doğrulamada bu fark önemsizdir, çünkü If-None-Match zayıf karşılaştırma kullanır: W/"abc" ile "abc" eşleşir.

Last-Modified daha eski, tarihe dayalı doğrulayıcıdır. Sunucu Last-Modified ile bir tarih gönderir, tarayıcı aynı tarihi If-Modified-Since ile geri sorar ve değişmemiş kaynak yine 304 alır. Tam saniyelerle sayar ve dosyanın zaman damgasına bağlıdır; ikisi birden varsa daha keskin kontrol ETag'dir.

ETag'ler sunucudan sunucuya sanıldığından sık farklılaşır. Apache ve nginx statik bir dosyanın varsayılan ETag'ini değişiklik zamanı ve boyutundan üretir; aynı dosya iki origin sunucusuna farklı zaman damgalarıyla kopyalanırsa iki farklı ETag alır. Yük dengeleyicinin arkasında, öbür sunucu her cevap verdiğinde tarayıcı 304 yerine tam bir 200 indirir. Doğrulayıcıları origin'ler arasında aynı tutun: değişiklik zamanlarını koruyan tek bir build çıktısı dağıtın (rsync -a, bir tar arşivi) ya da ETag'i içeriğin hash'inden üretin.

cdn.com.tr'de edge, origin'inizin ETag ve Last-Modified değerlerini cache'teki kopyayla birlikte saklar ve yeniden doğrulamayı kendisi cevaplar: tarayıcının If-None-Match ya da If-Modified-Since başlığı bu kopyayla karşılaştırılır ve kopya tazeyken 304 doğrudan edge'den gelir, origin'inize gidilmez. Her ziyaretçi edge'deki kopyaya karşı doğruladığı için origin sunucuları arasındaki ETag farkı, edge kopyayı başka bir sunucudan tazelediğinde ortaya çıkar: baytlar değişmediği hâlde ETag değişir ve ziyaretçiler dosyayı bir kez daha indirir. Edge bir metin yanıtını Brotli ya da Gzip ile sıkıştırdığında güçlü ETag tarayıcıya zayıf olarak (W/"…") ulaşır; yeniden doğrulama çalışmaya devam eder.

Yeniden doğrulamayı kendi URL'inizde test edin

# 1. dogrulayicilari okuyun (GET kullanin: bazi framework'ler HEAD'e farkli cevap verir)
curl -s -o /dev/null -D - https://example.com/css/site.css | grep -i "etag\|last-modified\|x-proxy-cache-mt"

# 2. ETag'i geri gonderin: 304, yeniden dogrulamanin calistigini gosterir
curl -s -o /dev/null -w "%{http_code}\n" -H 'If-None-Match: "5f2b-1a3c"' https://example.com/css/site.css

# 3. tarih dogrulayicisi: Last-Modified degerini geldigi gibi yapistirin
curl -s -o /dev/null -w "%{http_code}\n" -H "If-Modified-Since: Tue, 06 Oct 2026 08:00:00 GMT" https://example.com/css/site.css

Nasıl yapılır

Yardım merkezindeki adım adım rehberler:

Sık sorulan sorular

HTML sayfalar için iyi bir max-age nedir?

Kısa — saniyeler ya da birkaç dakika — çünkü URL aynı kalırken içerik değişir. Bunu edge'de daha uzun bir s-maxage ve stale-while-revalidate ile eşleyin; ziyaretçi anında cevap alırken tazeleme arka planda olsun.

Cache-Control yanında Expires hâlâ gerekli mi?

Hayır. Cache-Control Expires'ın yerini alır ve ikisi birlikte göründüğünde kazanır. Expires yalnızca çok eski istemciler için önemlidir; göndermek zararsızdır ama bir şey katmaz.

Uzun max-age verdiğim hâlde sayfam neden cache'lenmiyor?

Çoğunlukla cevaptaki bir Set-Cookie başlığı, zincirin bir yerindeki private ya da no-store direktifi, ya da her isteği benzersiz cache anahtarı yapan bir sorgu dizesi. Konfigürasyonu değiştirmeden önce gerçek cevap başlıklarını inceleyin.

immutable gerçekten sonsuza kadar mı demek?

"Bu URL'deki gövde değişmeyecek" demektir, yani cache'ler doğrulamayı tümden atlar. Bu yalnızca sürümlü dosya adları için doğrudur. Sonradan üzerine yazacağınız bir URL'e immutable koymak, ziyaretçilerin temiz bir çıkış yolu olmadan eski dosyada takılı kalmasının yoludur.