#Tổng quan

#Giới thiệu

Storage engine dùng để lưu file vào dịch vụ cụ thể, bao gồm Local Storage (lưu vào ổ cứng server), cloud storage, v.v.

Trước khi sử dụng bất kỳ tính năng upload file nào, cần phải cấu hình storage engine trước. Khi cài đặt hệ thống, một Local Storage engine sẽ được tự động thêm và có thể sử dụng ngay. Bạn cũng có thể thêm engine mới hoặc chỉnh sửa các tham số của engine đã có.

#Loại Storage Engine

Hiện tại NocoBase tích hợp sẵn các loại engine sau:

• Local Storage
• Amazon S3
• Aliyun OSS
• Tencent COS
• S3 Pro

Khi cài đặt hệ thống, một Local Storage engine sẽ được tự động thêm và có thể sử dụng ngay. Bạn cũng có thể thêm engine mới hoặc chỉnh sửa các tham số của engine đã có.

#Tham số chung

Ngoài các tham số riêng của từng loại engine, các phần dưới đây là tham số chung (lấy Local Storage làm ví dụ):

#Tiêu đề

Tên của storage engine, dùng để nhận biết bằng mắt thường.

#Tên hệ thống

Tên hệ thống của storage engine, dùng để hệ thống nhận biết. Phải là duy nhất trong hệ thống. Nếu không điền, hệ thống sẽ tự động sinh ngẫu nhiên.

#Tiền tố URL truy cập

Phần tiền tố địa chỉ URL có thể truy cập đến file đó, có thể là URL truy cập cơ sở của CDN, ví dụ: "https://cdn.nocobase.com/app" (không cần "/" ở cuối).

#Đường dẫn

Đường dẫn tương đối được sử dụng khi lưu file, phần này cũng sẽ được tự động nối vào URL cuối cùng khi truy cập. Ví dụ: "user/avatar" (không cần "/" ở đầu và cuối).

#Giới hạn kích thước file

Giới hạn kích thước khi upload file vào storage engine này, các file vượt quá kích thước cài đặt sẽ không thể upload được. Hệ thống mặc định giới hạn 20MB, có thể điều chỉnh tối đa lên 1GB.

#Loại file

Có thể giới hạn loại file được upload, sử dụng cú pháp MIME để mô tả định dạng. Ví dụ: image/* đại diện cho file hình ảnh. Nhiều loại có thể được phân tách bằng dấu phẩy, ví dụ: image/*, application/pdf cho phép cả file hình ảnh và file PDF.

#Storage engine mặc định

Sau khi tích chọn sẽ được đặt làm storage engine mặc định của hệ thống. Khi field attachment hoặc bảng file không chỉ định storage engine, file được upload sẽ đều được lưu vào storage engine mặc định. Storage engine mặc định không thể xóa.

#Giữ file khi xóa bản ghi

Sau khi tích chọn, khi bản ghi dữ liệu của bảng attachment hoặc bảng file bị xóa, file đã upload trong storage engine vẫn được giữ lại. Mặc định không tích chọn, tức là khi xóa bản ghi sẽ xóa file trong storage engine cùng lúc.

<URL truy cập cơ sở>/<đường dẫn>/<tên file><phần mở rộng>

#URL file và kiểm soát truy cập

Storage engine có thể trả về URL NocoBase hoặc URL gốc của dịch vụ storage. URL NocoBase được dùng mặc định. Chỉ chọn URL gốc khi một dịch vụ bên ngoài bắt buộc phải sử dụng trực tiếp địa chỉ storage.

Cấu hình này áp dụng theo từng storage engine. Sau khi lưu, cả file hiện có và file mới upload trong engine đó đều trả về URL theo định dạng đã chọn. File không bị di chuyển hoặc upload lại.

#URL NocoBase

Bản ghi file trả về đường dẫn truy cập do NocoBase cung cấp, ví dụ:

/files/main/main/attachments/1.png

Request đến URL này trước tiên đi qua NocoBase và tuân theo quyền xem được cấu hình cho bản ghi file tương ứng. Chỉ sau khi kiểm tra quyền thành công, NocoBase mới đọc file hoặc chuyển hướng đến địa chỉ do dịch vụ storage tạo ra.

Đây là lựa chọn mặc định được khuyến nghị. Bản ghi file trả về đường dẫn NocoBase, vì vậy bên gọi không cần biết đang sử dụng Local Storage hay cloud storage.

#URL gốc

Bản ghi file trả về trực tiếp địa chỉ do dịch vụ storage tạo ra, ví dụ:

https://storage.example.com/path/to/file.png

URL này không kiểm tra quyền xem của bản ghi file. Với Local Storage, đây thường là URL cũ /storage/uploads/, mặc định yêu cầu đăng nhập nhưng không kiểm tra lại từng bản ghi file. Với cloud storage, đây thường là địa chỉ Object Storage hoặc CDN có chính sách truy cập do dịch vụ đó kiểm soát.

Chỉ chọn URL gốc khi bên gọi không thể sử dụng URL NocoBase, chẳng hạn như không thể theo chuyển hướng 302 hoặc cần rõ ràng một địa chỉ Object Storage hay CDN.

#Cho phép truy cập công khai

"Cho phép truy cập công khai" chỉ có hiệu lực khi chọn "URL NocoBase". Khi tích chọn, storage engine vẫn trả về URL NocoBase nhưng NocoBase không còn kiểm tra quyền của bản ghi file khi URL được truy cập. Bất kỳ ai có URL đều có thể truy cập file.

Tùy chọn này không thay đổi cấu hình đọc công khai của chính dịch vụ storage. Nó chỉ kiểm soát việc NocoBase có kiểm tra quyền của bản ghi file hay không.

Markdown, trang bên ngoài và dịch vụ bên thứ ba cũng có thể sử dụng URL NocoBase công khai. Khi sử dụng bên ngoài, hãy bổ sung domain NocoBase vào path do API trả về để tạo URL tuyệt đối, đồng thời bảo đảm bên gọi có thể theo chuyển hướng 302.

#Cách chọn

Nếu bạn đang sử dụng storage engine công khai và muốn di chuyển file hiện có sang S3 Pro, hãy xem Di chuyển sang S3 Pro.