Django membedakan dua jenis file: file statis (aset yang merupakan bagian dari aplikasi Anda — CSS, JavaScript, gambar yang Anda kirimkan) dan file media (file diunggah oleh pengguna saat runtime — foto profil, dokumen). Keduanya ditangani secara berbeda karena sumber dan siklus hidupnya berbeda secara fundamental.
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' %}">
File statis adalah bagian dari basis kode Anda — CSS, JS, font, gambar desain. Mereka dikontrol versi, sama untuk semua pengguna, dan disajikan dari direktori statis proyek Anda.
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
Dalam production, collectstatic menggabungkan file statis dari semua aplikasi ke dalam satu direktori (STATIC_ROOT) agar web server atau CDN dapat melayaninya — Django tidak melayaninya sendiri dalam production.
# 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
File media diunggah oleh pengguna saat runtime melalui FileField/ImageField. Mereka bersifat dinamis, BUKAN dalam kontrol versi, dan berkembang seiring waktu seiring pengguna mengunggah konten.
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)
Memahami perbedaan antara statis dan media penting untuk membangun dan menerapkan aplikasi Django dengan benar, karena kedua jenis file memiliki sumber, siklus hidup, dan persyaratan penanganan yang secara fundamental berbeda. File statis (CSS, JavaScript, gambar, dan font milik aplikasi Anda) adalah bagian dari basis kode, dikontrol versi, dan sama untuk semua orang — dirujuk melalui {% static %} dan dikonsolidasikan dengan collectstatic untuk disajikan oleh web server atau CDN dalam production. File media (unggahan pengguna melalui FileField/ImageField) adalah konten dinamis yang dihasilkan pengguna dibuat saat runtime, BUKAN dalam kontrol versi, dan terus berkembang.
Mercampurkan keduanya atau salah mengonfigurasi pengaturannya (STATIC_* vs MEDIA_*) adalah sumber umum dari masalah "CSS saya tidak memuat" atau "unggahan tidak berfungsi", terutama dalam production di mana Django tidak melayani file statis sendiri (memerlukan collectstatic dan server/CDN yang tepat).
Perbedaan ini juga memiliki implikasi production dan keamanan yang penting: file media dalam penerapan multi-server tidak dapat mengandalkan disk lokal (mereka harus menggunakan penyimpanan cloud bersama seperti S3), dan unggahan pengguna memerlukan validasi (tipe file, ukuran) dan penyajian yang hati-hati untuk menghindari risiko keamanan dari konten berbahaya.
Mengetahui cara mengonfigurasi dan menangani kedua jenis ini, peran collectstatic, dan pertimbangan production (CDN untuk statis, penyimpanan cloud untuk media, keamanan unggahan) adalah pengetahuan praktis yang sering dibutuhkan untuk membangun dan menerapkan aplikasi Django yang benar — titik kesulitan umum yang pemahaman ini selesaikan.