Django iki tür dosyayı ayırt eder: static dosyaları (uygulamanızın parçası olan varlıklar — CSS, JavaScript, gönderdiğiniz resimler) ve media dosyaları (kullanıcılar tarafından çalışma zamanında yüklenen dosyalar — profil resimleri, belgeler). Kaynakları ve yaşam döngüleri temelden farklı olduğu için farklı şekilde işlenirler.
STATIC_URL =
STATICFILES_DIRS = [BASE_DIR / ]
STATIC_ROOT = BASE_DIR /
<!-- in templates -->
{% load static %}
<link rel="stylesheet" href="{% static 'css/style.css' %}">
<img src="{% static 'images/logo.png' %}">
Statik dosyalar kod tabanınızın parçasıdır — CSS, JS, fontlar, tasarım görselleri. Sürüm kontrollü, tüm kullanıcılar için aynı ve projenizin statik dizinlerinden sunulur.
python manage.py collectstatic
# gathers ALL static files (from your apps and STATICFILES_DIRS) into STATIC_ROOT,
# so a web server / CDN can serve them efficiently in production
Üretimde, collectstatic tüm uygulamaların statik dosyalarını tek bir dizine (STATIC_ROOT) birleştirir ve web sunucusu veya CDN tarafından sunulur — Django bunları üretimde kendisi sunmaz.
# settings.py
MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media" # where UPLOADED files are stored
# a model with an uploadable file
class Profile(models.Model):
avatar = models.ImageField(upload_to="avatars/") # stored under MEDIA_ROOT/avatars/
document = models.FileField(upload_to="docs/")
profile.avatar.url # the URL to access the uploaded file
Media dosyaları kullanıcılar tarafından çalışma zamanında FileField/ImageField aracılığıyla yüklenir. Dinamiktir, sürüm kontrolünde DEĞİLdir ve kullanıcılar içerik yükledikçe zamanla büyür.
Static files Media files
Source part of your code uploaded by users at runtime
Version control YES (committed) NO (user-generated, .gitignored)
Lifecycle fixed (changes with code) dynamic (grows continuously)
Examples CSS, JS, logos, fonts avatars, uploaded documents, photos
Settings STATIC_URL/ROOT/DIRS MEDIA_URL/ROOT
Production collectstatic + CDN/server stored on disk/cloud (S3), served carefully
✓ Static → serve via the web server (nginx) or a CDN (cached, fast)
✓ Media → store on cloud storage (S3) for scalability/persistence; in multi-server
setups, local disk doesn't work (files must be shared) → use S3/object storage
✓ Security → VALIDATE uploaded files (type, size); be careful serving user uploads
(a user could upload malicious content)
Statik ve media ayrımını anlamak, Django uygulamalarını hem doğru şekilde oluşturmak hem de uygun şekilde dağıtmak için önemlidir, çünkü iki dosya türünün temelden farklı kaynakları, yaşam döngüleri ve işleme gereksinimleri vardır. Statik dosyalar (uygulamanızın kendi CSS, JavaScript, görselleri, fontları) kod tabanının parçasıdır, sürüm kontrolüne tabi ve herkes için aynıdır — {% static %} aracılığıyla referans alınır ve üretimde web sunucusu veya CDN tarafından sunulması için collectstatic ile birleştirilir. Media dosyaları (FileField/ImageField aracılığıyla kullanıcı yüklemeleri) dinamik, kullanıcı tarafından oluşturulan içerik, çalışma zamanında oluşturulur, sürüm kontrolünde DEĞİLdir ve sürekli olarak büyür.
Bunları karıştırmak veya ayarlarını yanlış yapılandırmak (STATIC_* vs MEDIA_*) sık karşılaşılan "CSS yüklenmedi" veya "yüklemeler çalışmıyor" sorunlarının kaynağıdır, özellikle Django'nun statik dosyaları kendisi sunmadığı üretimde (collectstatic ve uygun sunucu/CDN gereklidir).
Bu ayrım ayrıca önemli üretim ve güvenlik etkileri taşır: çok sunuculu dağıtımlarda media dosyaları yerel diske güvenemez (S3 gibi paylaşılan bulut depolama kullanmalıdırlar) ve kullanıcı yüklemeleri doğrulama (dosya türü, boyut) gerektirir ve kötü niyetli içerikten kaynaklanan güvenlik risklerini önlemek için dikkatli sunulmalıdır.
Her iki türü de nasıl yapılandıracağınızı ve işleyeceğinizi, collectstatic'in rolünü ve üretim konularını (statik için CDN, media için bulut depolama, yükleme güvenliği) bilmek, gerçek Django uygulamalarını doğru şekilde oluşturmak ve dağıtmak için pratik, sık ihtiyaç duyulan bilgidir — bu anlayışın çözdüğü yaygın bir engel noktasıdır.