Lưu trữ đối tượng (MinIO)

MyPanel dựng một kho lưu trữ đối tượng tương thích S3 cho server của bạn bằng cách bọc MinIO trong một container chuẩn — giống cách Mail Server bọc docker-mailserver. Dùng để lưu ảnh, file tải lên, media và phục vụ chúng qua URL.

Bản Free dùng thử

Free cài được engine và tạo 1 bucket để dùng thử. Gói Pro mở không giới hạn số bucket.

Yêu cầu

• VPS Linux có Docker (panel tự kéo image MinIO + mc khi bấm Cài đặt).

Cài đặt & vận hành

Vào menu Lưu trữ. Thẻ trạng thái cho biết engine đang ở đâu:

1. Chưa cài — bấm Cài đặt MinIO (panel kéo image và khởi động container, có thể mất vài phút).
2. Đã dừng — bấm Khởi động.
3. Đang chạy — phần quản lý bucket hiện ra ngay bên dưới.

Nút Gỡ cài đặt xoá container; xác nhận thêm nếu muốn xoá luôn dữ liệu.

Bucket & khoá truy cập

Khi engine đang chạy:

• Tạo bucket — đặt tên (chữ thường, số, -, .), tuỳ chọn gắn website và bật Cho đọc công khai (để ảnh tải được qua URL).
• Mỗi bucket được cấp một khoá truy cập (access key + secret) giới hạn ĐÚNG bucket đó — key của một bucket không đụng được bucket khác.
• Secret chỉ hiện đúng một lần lúc tạo. Lưu lại ngay; sau đó chỉ còn cách Xoay khoá để sinh khoá mới.
• Công khai / Riêng tư — bật/tắt đọc ẩn danh bất cứ lúc nào.
• Xoá bucket — nếu bucket còn object, panel hỏi để xoá sạch rồi xoá bucket (hoặc chỉ xoá khi rỗng).

Chú ý

Secret không xem lại được. Nếu mất, dùng Xoay khoá — khoá cũ ngừng hoạt động ngay, nhớ cập nhật nơi đang dùng.

Truy cập từ bên ngoài (1 chạm + SSL)

Vì an toàn, MinIO chỉ lắng nghe nội bộ (127.0.0.1): API/ảnh ở cổng 9000, Console (quản trị) ở 9001. Ngay trong trang Lưu trữ, dùng nút “Mở ra tên miền” — panel tự tạo một Website kiểu Reverse Proxy trỏ vào MinIO và tự cấp Let’s Encrypt khi DNS đã trỏ. Có hai mục riêng:

Mục đích	Nút trong panel	Trỏ tới
Phục vụ ảnh / dùng S3 API	Mở ra tên miền	127.0.0.1:9000
Mở Console quản trị	Mở Console ra tên miền	127.0.0.1:9001

Sau khi mở, trỏ bản ghi A của tên miền về IP server (SSL cấp tự động). Mỗi tên miền tính là một website trong hạn mức gói. Reverse Proxy của MyPanel đã hỗ trợ WebSocket nên Console chạy đầy đủ.

Cấu hình cho hệ thống ngoài

Kết nối bằng Endpoint https://<tên-miền>, Region us-east-1, và bắt buộc bật path-style (forcePathStyle: true) — vì client dùng path-style. Trang Lưu trữ hiển thị sẵn các giá trị này để copy.

Dùng với WordPress / ứng dụng

Bucket là S3 chuẩn nên mọi plugin/SDK hỗ trợ S3 đều dùng được:

• Endpoint — https://<tên-miền> đã mở ở trên (hoặc http://127.0.0.1:9000 nếu chạy cùng máy).
• Access key / Secret key — khoá của bucket (cần để upload).
• Bucket — tên bucket. Nhớ bật path-style trong cấu hình SDK.

Ví dụ WordPress: plugin offload media (như WP Offload Media) điền các thông tin trên để đẩy thư viện ảnh sang MinIO.

Link ảnh công khai (bucket bật public-read): https://<tên-miền>/<bucket>/<file> — dùng thẳng làm <img src>.

Hạn mức Free / Pro

	Free	Pro
Cài & chạy engine	✓	✓
Số bucket	1	Không giới hạn
Khoá giới hạn theo bucket	✓	✓
Public-read / xoay khoá	✓	✓

Sao lưu dữ liệu

Dữ liệu thật của MinIO nằm tại /var/lib/mypanel/minio/data trên server.

Chú ý

Đừng dựa vào backup cấu hình của panel để lưu dữ liệu object — ảnh/file có thể lên tới nhiều GB, không phù hợp đóng gói chung. Hãy sao lưu riêng:

• Mirror sang kho khác — mc mirror (hoặc bật replication của MinIO) đẩy bucket sang một S3/MinIO khác định kỳ.
• rsync / snapshot — sao lưu thư mục /var/lib/mypanel/minio/data ở tầng hệ thống theo lịch.