Thư viện media

Thư viện media gom ảnh và file của từng site, có thư mục để sắp xếp và trình chỉnh sửa ảnh ngay trong trang quản trị.

Hai nơi lưu trữ

CMS quyết định theo từng lần tải lên, theo từng site:

Điều kiện	Nơi lưu
Site có cấu hình Cloudflare R2 (bucket và account ID)	Cloudflare R2
Các trường hợp còn lại	Đĩa máy chủ

Bản cài mới không cần dịch vụ lưu trữ nào: ảnh nằm trên đĩa, trong thư mục MEDIA_DIR (trong Docker là volume /app/media). Các site khác nhau trên cùng một bản cài có thể dùng hai nơi lưu khác nhau.

Bật Cloudflare R2 cho một site

Vào Sites > Hệ thống > Cloudflare R2, điền bucket, account ID, URL công khai (CDN) và khoá truy cập. Chỉ super admin sửa được nhóm này; hai khoá bí mật không bao giờ được trả qua REST hay GraphQL. Có thêm tuỳ chọn tự chuyển ảnh sang WebP khi tải lên.

Không có biến môi trường R2 toàn cục. Đặt R2_OFF=true nếu muốn ép mọi site dùng đĩa (ví dụ khi dev trên bản sao dữ liệu thật).

Tính năng

• Thư mục để sắp xếp ảnh, tách theo site.
• Chỉnh sửa ảnh (cắt, xoay…) hoạt động ở cả hai nơi lưu.
• Tải ảnh từ URL: nhập địa chỉ, CMS tải về và lưu vào thư viện, có chặn các địa chỉ nội bộ để tránh lỗi SSRF.
• Tên file được chuẩn hoá (bỏ dấu, chữ thường). Cùng tên trong cùng site sẽ ghi đè file cũ.
• Media đọc công khai, vì đường dẫn ảnh được nhúng trong bài đã xuất bản. Chỉ thành viên của site mới tải lên, sửa hoặc xoá được.

Chi tiết (cấu trúc thư mục, header cache, giới hạn loại file) ở Media storage reference (tiếng Anh).