cPanel MIME Türleri Nedir ve Nasıl Eklenir

Bir dosyayı web sunucunuza yüklediğinizde, o dosyanın gerçekte ne olduğu diskteki adından ibaret değildir. Tarayıcı bir dosyayı indirdiğinde, onu ekranda göstermesi mi, çalıştırması mı, yoksa kullanıcıya indirtmesi mi gerektiğine dosyanın adına bakarak değil, sunucunun gönderdiği bir etikete bakarak karar verir. Bu etikete MIME türü (content type) denir. Sunucu her HTTP yanıtında Content-Type başlığında bu bilgiyi taşır ve tarayıcı da yalnızca bu başlığa güvenir. Doğru etiket gelmezse, mükemmel hazırlanmış bir yazı tipi yüklenmez, bir PDF tarayıcıda açılmak yerine ham metin olarak dökülür ya da bir SVG görseli kırık ikon olarak görünür.

Sorun genellikle standart dosyalarda değil, sunucunun tanımadığı özel ya da yeni uzantılarda ortaya çıkar. Apache ve cPanel, bilinen yüzlerce uzantı için MIME türlerini zaten yerleşik olarak bilir; ama alışılmadık bir uzantı kullandığınızda ya da yeni bir dosya formatı çıktığında sunucu ne göndereceğini bilemez ve varsayılan olarak yanlış bir etiket üretir. İşte cPanel'in MIME Types aracı tam burada devreye girer: belirli bir uzantıyı belirli bir içerik tipiyle eşleştirmenizi sağlar, böylece tarayıcı dosyayı olması gerektiği gibi yorumlar. Bu rehberde MIME türünün ne olduğunu, tarayıcının onu nasıl kullandığını, cPanel üzerinden yeni bir tür eklemenin adımlarını, web font ve özel indirme dosyası örneklerini ve sistem türlerinin neden geçersiz kılınamayacağını çalışan örneklerle ele alacağız.

MIME Türü Nedir ve Neden Önemlidir?#

MIME, "Multipurpose Internet Mail Extensions" ifadesinin kısaltmasıdır ve adından da anlaşılacağı gibi kökeni e-posta dünyasına dayanır. Başlangıçta e-posta eklerinin türünü belirtmek için tasarlanan bu sistem, zamanla web'in temel taşlarından biri hâline geldi. Bugün her HTTP yanıtı, gönderilen içeriğin türünü Content-Type başlığında bir MIME türü olarak bildirir. Bu türler her zaman tip/alt-tip biçiminde iki parçadan oluşur: örneğin text/html, image/png, application/pdf ya da font/woff2.

Bir MIME türünün soldaki parçası içeriğin genel kategorisini (text, image, audio, video, application, font), sağdaki parçası ise kesin formatını belirtir. Tarayıcı bu ikiliyi okuyarak dosyayı ne yapacağına karar verir. text/html gelirse içeriği HTML olarak ayrıştırıp sayfayı çizer; image/jpeg gelirse görseli gösterir; application/octet-stream gelirse "bunu nasıl göstereceğimi bilmiyorum" der ve dosyayı kullanıcıya indirtir. Bu yüzden MIME türü, dosyanızın kullanıcıya nasıl ulaştığını belirleyen görünmez ama kritik bir katmandır. Yanlış tür, en özenli içeriği bile bozar; doğru tür ise her şeyin sessizce çalışmasını sağlar.

Buradaki en önemli kavramsal nokta şudur: dosyanın uzantısı yalnızca sunucu için bir ipucudur, tarayıcı için değil. Tarayıcı dosya.woff2 adını görmez; yalnızca sunucunun o dosya için gönderdiği Content-Type: font/woff2 başlığını görür. Dolayısıyla MIME yapılandırması aslında "hangi uzantıya hangi etiketi basayım?" sorusunun sunucu tarafındaki cevabıdır.

Tarayıcı MIME Türünü Nasıl Kullanır?#

Bir HTTP isteğinin arkasında ne olduğunu görmek, MIME mantığını anlamanın en iyi yoludur. Tarayıcı bir dosya istediğinde sunucu şuna benzer bir yanıt döndürür:

HTTP/1.1 200 OK
Content-Type: font/woff2
Content-Length: 24680
Cache-Control: max-age=31536000

Buradaki Content-Type satırı, tüm kararın verildiği yerdir. Tarayıcı bu satıra bakıp "bu bir web fontu" der ve dosyayı font motoruna teslim eder. Aynı isteği komut satırından curl ile de inceleyebilirsiniz:

curl -I https://siteniz.com/fonts/marka.woff2

-I bayrağı yalnızca yanıt başlıklarını getirir; çıktıda Content-Type satırının doğru değeri taşıyıp taşımadığını hemen görürsünüz. Eğer burada font/woff2 yerine application/octet-stream ya da text/plain gibi bir değer görüyorsanız, sorununuz tam olarak MIME yapılandırmasındadır ve bu rehberdeki adımlarla çözülür.

Tarayıcının bu davranışını üç tipik sonuçla özetleyebiliriz. Birincisi, tür doğruysa dosya olması gerektiği gibi işlenir. İkincisi, tür yanlış ama zararsızsa dosya beklenmedik biçimde davranır; örneğin application/octet-stream etiketli bir görsel, gösterilmek yerine indirilir. Üçüncüsü, tür güvenlik açısından yanlışsa tarayıcı dosyayı reddedebilir; modern tarayıcılar X-Content-Type-Options: nosniff başlığı varken yanlış MIME türlü stil ve script dosyalarını yüklemeyi güvenlik gereği durdurur. Bu son madde, MIME türlerinin yalnızca bir görüntüleme detayı değil, aynı zamanda bir güvenlik konusu olduğunu gösterir.

cPanel MIME Türleri Aracına Nereden Ulaşılır?#

cPanel'in MIME Types aracı, arayüzün Advanced (Gelişmiş) bölümünde yer alır. Eğer cPanel'in genel yerleşimine henüz alışık değilseniz, panelin bölümlerini ve mantığını /wiki/cpanel-nedir yazısında baştan sona bulabilirsiniz. Araca ulaşmak için şu adımları izleyin:

1. Hosting hesabınızın cPanel arayüzüne giriş yapın.
2. Ana ekranın üst kısmındaki arama kutusuna "MIME" yazın veya sayfayı aşağı kaydırıp Advanced bölümünü bulun.
3. MIME Types ikonuna tıklayın.

Açılan sayfa iki ana bölümden oluşur. Üstte Create a MIME Type (Yeni MIME Türü Oluştur) formu bulunur; burada bir içerik tipi ve ona bağlayacağınız uzantıları girersiniz. Altta ise iki liste yer alır: User Defined MIME Types (Kullanıcı Tanımlı Türler), yani sizin eklediğiniz kayıtlar ve System Defined MIME Types (Sistem Tanımlı Türler), yani sunucuda hazır gelen ve düzenleyemeyeceğiniz uzun liste. Sistem listesi salt okunurdur ve yalnızca referans amaçlıdır; hangi uzantının zaten tanımlı olduğunu buradan kontrol edebilirsiniz.

Bu aracı görebilmeniz için hosting paketinizin özelliğin açık olduğu bir plan olması gerekir. Clou.TR'nin paylaşımlı /hosting ve /hosting/web paketlerinde MIME Types aracı standart olarak sunulur; bu da özel dosya türlerini kendi başınıza yapılandırma esnekliği verir.

Adım Adım Yeni Bir MIME Türü Ekleme#

Yeni bir MIME türü tanımlamak yalnızca iki alanı doldurmaktan ibarettir, ama her iki alanın da doğru formatta olması gerekir. İşleyiş şöyledir:

1. MIME Types sayfasında Create a MIME Type formuna gidin.
2. MIME Type kutusuna eklemek istediğiniz içerik tipini tip/alt-tip biçiminde yazın; örneğin font/woff2.
3. Extension(s) kutusuna bu türle eşleştirilecek uzantıyı yazın; başına nokta koymadan, sadece woff2 şeklinde. Birden fazla uzantı ekleyecekseniz aralarına boşluk koyun, örneğin woff2 woff.
4. Add (Ekle) düğmesine basın.

Kayıt eklendiğinde, cPanel arka planda bu tanımı hesabınızın .htaccess dosyasına bir AddType satırı olarak yazar. Yani bu güzel arayüz, aslında Apache yapılandırmasını sizin yerinize düzenleyen bir üreteçtir. Ürettiği satır şuna benzer:

AddType font/woff2 .woff2

Bu satır Apache'ye "gövdesi .woff2 ile biten her dosyayı font/woff2 içerik tipiyle sun" der. Ekleme işleminden sonra tanımınız User Defined MIME Types listesinde belirir ve buradan istediğiniz zaman Edit (Düzenle) ya da Delete (Sil) bağlantılarıyla yönetebilirsiniz. Uzantıların büyük/küçük harf duyarlılığına dikkat edin; Apache uzantıları harf durumundan bağımsız eşleştirir, dolayısıyla woff2 yazmanız hem .woff2 hem .WOFF2 dosyalarını kapsar.

Aşağıdaki tablo, uygulamada en sık ihtiyaç duyacağınız birkaç tanımı özetler:

Örnek 1: Web Font (woff2) Sunumunu Düzeltmek#

MIME türü sorunlarının en yaygın karşılaşıldığı yer web fontlarıdır. Kendi barındırdığınız özel bir yazı tipini siteye eklediğinizi ama harflerin bir türlü yüklenmediğini, tarayıcının varsayılan fonta düştüğünü düşünelim. CSS'iniz doğru, dosya yolu doğru, dosya sunucuda mevcut; buna rağmen font gelmiyor. Bu tablonun klasik sebebi, sunucunun .woff2 dosyasını yanlış bir MIME türüyle sunmasıdır.

CSS tarafındaki tanımınız tipik olarak şöyledir:

@font-face {
  font-family: "MarkaFont";
  src: url("/fonts/marka.woff2") format("woff2");
  font-weight: 400;
  font-display: swap;
}

Bu kod kusursuz olabilir; ama sunucu marka.woff2 dosyasını application/octet-stream olarak gönderiyorsa, bazı tarayıcılar dosyayı bir font olarak değil, indirilecek genel bir ikili dosya olarak yorumlar ve @font-face kuralı sessizce başarısız olur. Sorunu doğrulamak için biraz önce gördüğümüz curl -I komutunu kullanın; Content-Type satırında font/woff2 yerine başka bir şey görüyorsanız teşhis netleşmiştir.

Çözüm, cPanel MIME Types aracında iki tanım eklemektir:

AddType font/woff2 .woff2
AddType font/woff .woff

Bu iki satırı cPanel formundan eklediğinizde (biri font/woff2 → woff2, diğeri font/woff → woff), sunucu artık fontları doğru etiketle sunar ve tarayıcı @font-face kuralını sorunsuz uygular. Değişiklik anında geçerli olur, ancak tarayıcınız eski yanlış yanıtı önbelleğe almış olabilir; bu yüzden test ederken sayfayı sabit önbellek olmadan (hard refresh) yenilemeyi unutmayın. Fontlar gibi statik varlıkların uzun süreli önbelleklenmesi ve doğru başlıklarla sunulması, sayfa hızınızı doğrudan etkilediği için performans ve /seo tarafında da önemlidir.

Örnek 2: Özel İndirme Dosyaları İçin İçerik Tipi Tanımlamak#

MIME türlerinin ikinci yaygın kullanımı, dosyaların tarayıcıda açılmak yerine bilgisayara indirilmesini sağlamaktır. Diyelim ki müşterilerinize .dwg uzantılı teknik çizim dosyaları ya da özel bir uygulamanın .pkg yapılandırma paketlerini dağıtıyorsunuz. Bu tür uzantıları sunucu tanımadığında bazen ham metin olarak ekrana döker, bazen de tarayıcının yorumlamaya çalışmasıyla garip davranışlar ortaya çıkar. Amacınız, tarayıcının bu dosyaları düşünmeden doğrudan indirmesidir.

Bunu sağlamanın standart yolu, dosyayı "genel ikili veri" anlamına gelen application/octet-stream türüyle eşleştirmektir. Bu tür, tarayıcıya "bunu gösterme, kullanıcıya kaydettir" mesajını verir:

AddType application/octet-stream .dwg
AddType application/octet-stream .pkg

Bu tanımları cPanel MIME Types formundan eklediğinizde, ilgili uzantılı her dosya artık tarayıcıda otomatik olarak indirilir. Ancak burada ince bir ayrım vardır: içerik tipini octet-stream yapmak dosyayı çoğu durumda indirtir, ama indirmeyi kesin olarak zorlamanın daha güvenilir yolu Content-Disposition başlığıdır. Bu başlığı MIME aracıyla değil, .htaccess üzerinden eklersiniz:

<FilesMatch "\.(dwg|pkg)$">
    Header set Content-Disposition "attachment"
</FilesMatch>

Bu blok, eşleşen dosyalar için tarayıcıya "bunu bir ek olarak indir" talimatını açıkça verir. MIME türü ile Content-Disposition başlığını birlikte kullanmak, indirme davranışını hem doğru içerik tipiyle hem de kesin bir talimatla garantiler. .htaccess üzerinden başlık ve davranış yönetiminin daha fazla örneğini /wiki/htaccess-yonlendirme yazısında bulabilirsiniz.

Sistem Türleri Neden Geçersiz Kılınamaz?#

cPanel MIME Types sayfasındaki en çok kafa karıştıran nokta, System Defined MIME Types listesinin salt okunur olmasıdır. Sistemin zaten bildiği bir uzantı için buradan yeni bir tanım eklemeye çalışırsanız, cPanel ya işlemi reddeder ya da tanımınız sistem varsayılanının yanında etkisiz kalır. Bunun sebebi mimaridir: sistem türleri sunucu genelinde, tüm hesaplar için Apache'nin ana yapılandırmasında (mime.types ve genel httpd.conf) tanımlanmıştır. Tek bir hosting hesabının bu küresel tanımları değiştirmesine izin verilmez, çünkü bu diğer kullanıcıları ve sunucunun bütünlüğünü etkiler.

Pratikte bu, şu anlama gelir: html, css, js, png, jpg, pdf gibi standart uzantılar zaten doğru MIME türleriyle gelir ve siz bunları değiştiremezsiniz; zaten değiştirmenize de gerek yoktur. Kullanıcı tanımlı türler yalnızca sistemin bilmediği uzantılar için işe yarar. Aşağıdaki tablo bu ayrımı netleştirir:

Peki gerçekten standart bir uzantının davranışını değiştirmeniz gerekiyorsa ne yaparsınız? Bu durumda çözüm MIME Types aracı değil, doğrudan .htaccess dosyasıdır. .htaccess içindeki AddType yönergesi, dizin düzeyinde çalıştığı için sunucu varsayılanının önüne geçebilir. Örneğin belirli bir dizinde .txt dosyalarını farklı bir türle sunmak isterseniz:

AddType text/plain; charset=utf-8 .txt

Yani sistem türlerini "cPanel arayüzünden" geçersiz kılamamanız bir kısıtlama değil, bir güvenlik ve izolasyon tasarımıdır; dizin bazlı istisnalar için doğru araç zaten .htaccess'tir. Kendi sunucusunun tam kontrolünü isteyen ve genel Apache yapılandırmasına dokunmak isteyen kullanıcılar içinse /sunucu/vds gibi kök erişimli bir sunucu daha uygun bir zemin sunar.

MIME Türlerini .htaccess ve Nginx Düzeyinde Yönetmek#

cPanel'in MIME aracı Apache tabanlı paylaşımlı hosting için pratik bir kısayoldur, ama arka planda her zaman .htaccess dosyasına yazdığını bilmek size iki avantaj kazandırır. Birincisi, panel arayüzü olmadan bir sunucuda aynı işi elle yapabilirsiniz. İkincisi, cPanel'in izin vermediği daha ince ayarları (karakter kümesi belirtme, dizin bazlı istisnalar gibi) doğrudan yazabilirsiniz. Apache tarafında birden çok tanımı tek yerde toplamak temiz bir yaklaşımdır:

# Web fontları
AddType font/woff2 .woff2
AddType font/woff  .woff

# Modern görseller
AddType image/webp .webp
AddType image/avif .avif

# PWA manifesti
AddType application/manifest+json .webmanifest

Bir VPS ya da özel sunucuda Nginx kullanıyorsanız .htaccess çalışmaz; MIME tanımları mime.types dosyasında ya da http/server bloğunda types yönergesiyle tutulur. Nginx'te yeni bir tür eklemek şöyle görünür:

types {
    font/woff2   woff2;
    image/avif   avif;
    application/manifest+json  webmanifest;
}

Nginx yapılandırmasını değiştirdikten sonra nginx -t ile sözdizimini doğrulayıp servisi yeniden yüklemeniz gerekir. Sunucu düzeyinde yapılandırmayı kendiniz üstlenmek istemiyorsanız, bu tür ayarları sizin yerinize yapan /sunucu-yonetimi hizmeti işinizi kolaylaştırır. Sitenizi başka bir sunucudan taşırken MIME tanımlarının da birlikte gelmesi gerektiğini unutmayın; taşıma sırasında .htaccess dosyanızın eksiksiz kopyalanması için /site-tasima sürecinde bu dosyayı özellikle kontrol edin.

Yaygın MIME Türü Sorunları ve Çözümleri#

Uygulamada karşılaşacağınız sorunların çoğu birkaç tipik hataya indirgenir ve teşhisleri de bir o kadar tekrarlanabilir. En sık görülen belirti, "dosya var ama yanlış davranıyor" durumudur: font yüklenmez, SVG kırık görünür, JSON dosyası indirilir, PDF ham metin olarak dökülür. Bu belirtilerin neredeyse tamamı Content-Type başlığının yanlış olmasından kaynaklanır ve teşhisin ilk adımı her zaman aynıdır: curl -I ile dosyanın gerçekte hangi türle sunulduğunu görmek.

Aşağıdaki tablo, sık rastlanan belirtileri olası sebep ve çözümleriyle eşleştirir:

Burada dikkat edilmesi gereken sinsi bir tuzak, tarayıcı önbelleğidir. Bir MIME tanımını düzelttiğinizde sunucu artık doğru başlığı gönderir; ama tarayıcınız bir süre önce aldığı yanlış yanıtı önbelleğinde tutuyorsa, değişikliğin işe yaramadığını sanabilirsiniz. Bu yüzden her testten önce sayfayı sabit önbelleksiz yenilemek ya da geliştirici araçlarının "Disable cache" seçeneğini açık tutmak iyi bir alışkanlıktır. İkinci bir tuzak, karakter kümesidir: özellikle metin tabanlı dosyalarda text/html; charset=utf-8 gibi Türkçe karakterleri doğru gösteren tam bir tanım kullanmak, bozuk görünen harflerin önüne geçer. Bir sonraki adımda daha geniş bir yapılandırma bilgisi için /hosting/wordpress gibi hazır yapılandırılmış çözümler, bu ayarların çoğunu sizin için baştan doğru getirir.

Sıkça Sorulan Sorular#

MIME türü ile dosya uzantısı arasındaki fark nedir?#

Dosya uzantısı, dosyanın diskteki adının sonundaki .woff2 ya da .pdf gibi eklentidir ve yalnızca sunucu için bir ipucudur. MIME türü ise sunucunun HTTP yanıtının Content-Type başlığında gönderdiği font/woff2 ya da application/pdf gibi resmi etikettir ve tarayıcının dosyayı nasıl yorumlayacağına karar veren asıl bilgidir. Tarayıcı uzantıyı görmez, yalnızca MIME türünü görür; bu yüzden uzantı doğru olsa bile MIME türü yanlışsa dosya beklendiği gibi çalışmaz.

cPanel MIME Types aracıyla yaptığım değişiklik ne zaman geçerli olur?#

Tanımı ekleyip Add düğmesine bastığınız anda cPanel bunu hesabınızın .htaccess dosyasına yazar ve değişiklik sunucu tarafında hemen etkinleşir. Ancak değişikliği görmemenizin en yaygın sebebi tarayıcı önbelleğidir; tarayıcınız dosyanın eski, yanlış türlü sürümünü önbellekte tutuyor olabilir. Bu nedenle test ederken sayfayı sabit önbelleksiz yenileyin ya da farklı bir tarayıcıda deneyin; sunucunun gerçekte ne gönderdiğini kesin olarak görmek için curl -I komutunu kullanın.

Standart bir uzantının MIME türünü neden değiştiremiyorum?#

Çünkü html, css, png gibi standart uzantılar sunucunun genel yapılandırmasında, tüm hesaplar için ortak olarak tanımlanmış sistem türleridir ve tek bir hosting hesabının bunları panel üzerinden değiştirmesine güvenlik ve izolasyon gereği izin verilmez. Bu türleri MIME Types sayfasında yalnızca salt okunur olarak görürsünüz. Gerçekten belirli bir dizinde standart bir uzantının davranışını değiştirmeniz gerekiyorsa, bunu MIME aracıyla değil doğrudan .htaccess dosyasındaki bir AddType satırıyla yaparsınız; bu yönerge dizin düzeyinde çalıştığı için sunucu varsayılanının önüne geçebilir.

Web fontlarım yüklenmiyor, sorun MIME türünde mi?#

Büyük olasılıkla evet, özellikle CSS'iniz ve dosya yolunuz doğruyken fontlar hâlâ gelmiyorsa. Bunu kesinleştirmek için font dosyanızın adresine curl -I ile bakın; Content-Type satırında font/woff2 yerine application/octet-stream ya da text/plain görüyorsanız sorun tam olarak MIME yapılandırmasındadır. cPanel MIME Types aracından font/woff2 türünü woff2 uzantısına ve font/woff türünü woff uzantısına bağlayarak sorunu çözersiniz; ardından tarayıcı önbelleğini temizleyip tekrar deneyin.

Bir dosyanın tarayıcıda açılmak yerine indirilmesini nasıl sağlarım?#

Bunun en pratik yolu, dosyanın uzantısını application/octet-stream MIME türüyle eşleştirmektir; bu tür tarayıcıya içeriği gösteremeyeceğini söyleyip dosyayı indirtir. Daha kesin bir garanti için .htaccess dosyasında ilgili uzantılar için Content-Disposition attachment başlığını da eklersiniz; böylece tarayıcı dosyayı her koşulda bir ek olarak indirir. İki yöntemi birlikte kullanmak, indirme davranışını hem doğru içerik tipiyle hem de açık bir talimatla güvence altına alır.

Nginx sunucusunda MIME türlerini nasıl eklerim?#

Nginx .htaccess dosyalarını okumaz; bu yüzden cPanel'in MIME aracının eşdeğeri, sunucunun mime.types dosyası ya da yapılandırmadaki types bloğudur. Yeni bir tür eklemek için types { font/woff2 woff2; } benzeri bir satır yazar, ardından nginx -t ile yapılandırmayı doğrulayıp servisi yeniden yüklersiniz. Kök erişimi olan bir VPS ya da özel sunucuda çalışıyorsanız bu düzenlemeyi kendiniz yapabilir, ya da sunucu yönetimini bir ekibe bırakarak bu tür ince ayarların sizin adınıza yapılmasını tercih edebilirsiniz.

Kapanış#

MIME türleri, çoğu zaman fark edilmeden çalışan ama yanlış yapılandırıldığında en özenli içeriği bile sessizce bozan görünmez bir katmandır. Temel mantık basittir: sunucu her dosyaya Content-Type başlığında bir etiket basar ve tarayıcı yalnızca bu etikete güvenir. cPanel'in MIME Types aracı, sistemin tanımadığı özel uzantılar için bu etiketi kolayca tanımlamanızı sağlar; arka planda .htaccess dosyanıza yazdığı AddType satırlarını anlamak ise size web fontlarını düzeltmek, özel dosyaları indirtmek ve Nginx gibi farklı ortamlara aynı mantığı taşımak için gereken esnekliği kazandırır. Sistem türlerinin salt okunur olması bir kısıtlama değil, sunucu izolasyonunun doğal bir sonucudur; gerçek istisnalara ihtiyaç duyduğunuzda doğru araç zaten .htaccess'tir.

Fontlarınızın, görsellerinizin ve özel dosyalarınızın her zaman doğru içerik tipiyle sunulduğu, MIME Types ve .htaccess araçlarının tam desteklendiği bir altyapı arıyorsanız Clou.TR'nin /hosting paketleri ve WordPress siteleri için önceden doğru yapılandırılmış /hosting/wordpress çözümleri güçlü bir başlangıç noktasıdır. Kök erişimiyle sunucu yapılandırmasının tamamını yönetmek isteyenler /sunucu/vds sunucularımıza göz atabilir, kurulum ve ince ayarları uzman bir ekibe bırakmak isteyenler /sunucu-yonetimi hizmetimizden yararlanabilir. Sorularınız için destek ekibimiz her zaman yanınızda.