Django phân biệt hai loại file: static file (tài nguyên là một phần của ứng dụng của bạn — CSS, JavaScript, hình ảnh bạn ship) và media file (file do user upload lúc runtime — ảnh đại diện, tài liệu). Chúng được xử lý khác nhau vì nguồn gốc và vòng đời của chúng khác nhau về cơ bản.
STATIC_URL =
STATICFILES_DIRS = [BASE_DIR / ]
STATIC_ROOT = BASE_DIR /
<!-- trong template -->
{% load static %}
<link rel="stylesheet" href="{% static 'css/style.css' %}">
<img src="{% static 'images/logo.png' %}">
Static file là một phần của codebase — CSS, JS, font, hình ảnh thiết kế. Chúng được quản lý phiên bản, giống nhau cho mọi user, và được phục vụ từ các thư mục static của project.
python manage.py collectstatic
# gom TẤT CẢ static file (từ các app và STATICFILES_DIRS của bạn) vào STATIC_ROOT,
# để một web server / CDN có thể phục vụ chúng hiệu quả trong production
Trong production, collectstatic hợp nhất static file từ tất cả các app vào một thư mục (STATIC_ROOT) để web server hoặc CDN phục vụ — Django không tự phục vụ chúng trong production.
# settings.py
MEDIA_URL = "/media/"
MEDIA_ROOT = BASE_DIR / "media" # nơi file được UPLOAD được lưu
# một model với một file có thể upload
class Profile(models.Model):
avatar = models.ImageField(upload_to="avatars/") # lưu dưới MEDIA_ROOT/avatars/
document = models.FileField(upload_to="docs/")
profile.avatar.url # URL để truy cập file được upload
Media file được user upload lúc runtime qua FileField/ImageField. Chúng động, KHÔNG nằm trong version control, và tăng dần theo thời gian khi user upload nội dung.
Static file Media file
Nguồn một phần của mã do user upload lúc runtime
Version control CÓ (được commit) KHÔNG (do user tạo, .gitignore)
Vòng đời cố định (đổi theo mã) động (tăng liên tục)
Ví dụ CSS, JS, logo, font avatar, tài liệu upload, ảnh
Settings STATIC_URL/ROOT/DIRS MEDIA_URL/ROOT
Production collectstatic + CDN/server lưu trên disk/cloud (S3), phục vụ cẩn thận
✓ Static → phục vụ qua web server (nginx) hoặc một CDN (được cache, nhanh)
✓ Media → lưu trên cloud storage (S3) cho khả năng mở rộng/bền vững; trong thiết lập
nhiều server, disk cục bộ không hoạt động (file phải được chia sẻ) → dùng S3/object storage
✓ Bảo mật → VALIDATE file được upload (loại, kích thước); cẩn thận khi phục vụ upload của user
(một user có thể upload nội dung độc hại)
Hiểu sự phân biệt static-với-media quan trọng cả để xây dựng đúng đắn lẫn triển khai phù hợp các ứng dụng Django, vì hai loại file có nguồn gốc, vòng đời, và yêu cầu xử lý khác nhau về cơ bản. Static file (CSS, JavaScript, hình ảnh, font của riêng ứng dụng) là một phần của codebase, được quản lý phiên bản, và giống nhau cho mọi người — được tham chiếu qua {% static %} và hợp nhất với collectstatic để web server hoặc CDN phục vụ trong production. Media file (upload của user qua FileField/ImageField) là nội dung động, do user tạo lúc runtime, KHÔNG nằm trong version control, và tăng liên tục.
Nhầm lẫn chúng hoặc cấu hình sai settings của chúng (STATIC_* so với MEDIA_*) là một nguồn phổ biến của các vấn đề "CSS của tôi không load" hoặc "upload không hoạt động", đặc biệt trong production nơi Django không tự phục vụ static file (đòi hỏi collectstatic và một server/CDN phù hợp).
Sự phân biệt cũng có hệ quả production và bảo mật quan trọng: media file trong các triển khai nhiều server không thể dựa vào disk cục bộ (chúng phải dùng cloud storage chia sẻ như S3), và upload của user đòi hỏi validation (loại file, kích thước) và phục vụ cẩn thận để tránh rủi ro bảo mật từ nội dung độc hại.
Biết cách cấu hình và xử lý cả hai loại, vai trò của collectstatic, và các cân nhắc production (CDN cho static, cloud storage cho media, bảo mật upload) là kiến thức thực tế, thường cần để xây dựng và triển khai các ứng dụng Django thực một cách đúng đắn — một vật cản phổ biến mà hiểu biết này giải quyết.