Blog ZoCloud Dùng thử

Đăng ngày 13/11/2026

Object storage S3 tại Việt Nam: lưu file, ảnh và backup cho app

Để lưu file của app trên một object storage tương thích S3 đặt tại Việt Nam, trên ZoCloud bạn bấm Thêm → Object storage (S3) trong project, đặt tên và giới hạn dung lượng, rồi gắn các biến S3_* cho service. App dùng AWS SDK hay boto3 như với Amazon S3, chỉ đổi endpoint sang https://s3.zocloud.app. Mỗi bucket có access key riêng, chỉ truy cập được chính bucket đó, và dữ liệu nằm trên máy chủ tại Việt Nam.

Bài này hướng dẫn tạo bucket, lấy key, dùng với SDK và rclone, nhận file upload từ app, và chia sẻ file khi bucket là riêng tư.

Object storage là gì, khác gì volume?

Object storage lưu file dưới dạng object trong một bucket, đọc ghi qua API HTTP theo chuẩn S3 của Amazon. Gần như mọi framework và thư viện upload đều có sẵn driver S3.

Object storage (S3) Volume (ổ lưu trữ bền)
Truy cập Qua API S3, từ mọi service và từ máy bạn Thư mục gắn vào một service
Số bản chạy App scale bao nhiêu bản cũng được Service có volume chạy 1 bản
Hợp với Ảnh, tài liệu khách tải lên, file xuất, backup SQLite, app cần đĩa cục bộ (WordPress, n8n)

Nếu app cần chạy nhiều bản cho ổn định, hãy để file tải lên ở S3 thay vì ổ đĩa của container: container được tạo lại mỗi lần deploy, còn bucket thì không.

Vì sao chọn S3 tại Việt Nam?

  • Dữ liệu ở trong nước: hữu ích khi bạn cần giữ dữ liệu cá nhân của người dùng Việt Nam tại Việt Nam (xem lưu trữ dữ liệu tại Việt Nam theo Nghị định 53; đây không phải tư vấn pháp lý).
  • Gần app: app chạy trên ZoCloud đọc ghi bucket trong cùng hạ tầng tại Việt Nam.
  • Trả bằng ví VND cùng hoá đơn với app và database.

Thông số bucket

Thông số Giá trị
Endpoint https://s3.zocloud.app
Region hiện trên trang bucket (biến S3_REGION)
Kiểu địa chỉ path-style: https://s3.zocloud.app/<bucket>/<key>
Upload đơn tối đa 100 MB; file lớn hơn dùng multipart upload (SDK tự làm)
Quyền Mỗi bucket một access key, chỉ truy cập được bucket đó

Path-style là điểm hay quên nhất: nhiều SDK mặc định dùng kiểu <bucket>.s3.amazonaws.com. Hãy bật forcePathStyle (Node.js) hoặc addressing_style: path (Python) như ví dụ bên dưới.

Tạo bucket

  1. Mở project, trên canvas bấm Thêm → Object storage (S3).
  2. Nhập Tên (chữ thường, số và -), ví dụ files. Service gọi bucket qua tên này trong biến.
  3. Nhập Giới hạn dung lượng (GB). Ghi vượt giới hạn sẽ bị từ chối; bạn trả tiền theo dung lượng thực dùng.
  4. Bấm Tạo.

Từ terminal (sau khi zo link thư mục với service):

zo buckets create files -quota-gb 5   # tạo bucket, in cách gắn vào service
zo buckets                            # liệt kê bucket của environment
zo buckets creds files                # endpoint, access key, secret key

AI agent dùng công cụ MCP create_bucket để làm việc tương tự (xem MCP server là gì).

Gắn bucket vào app

Mục Kết nối của bucket hiện các biến tham chiếu. Thêm vào Biến môi trường của service rồi deploy lại:

S3_ENDPOINT=${{files.S3_ENDPOINT}}
S3_REGION=${{files.S3_REGION}}
S3_BUCKET=${{files.S3_BUCKET}}
S3_ACCESS_KEY_ID=${{files.S3_ACCESS_KEY_ID}}
S3_SECRET_ACCESS_KEY=${{files.S3_SECRET_ACCESS_KEY}}

Bucket còn có sẵn các biến tên kiểu AWS (AWS_ENDPOINT_URL_S3, AWS_REGION, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY) để SDK tự đọc, và S3_FORCE_PATH_STYLE=true. Giá trị đầy đủ (dùng cho rclone, script trên máy) xem ở Biến kết nối → Xem thông tin kết nối. Đừng chép secret key vào code hay commit lên Git; xem bài biến môi trường và file .env.

Upload file từ app

Node.js (Express + AWS SDK v3)

import express from "express";
import multer from "multer";
import crypto from "node:crypto";
import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  forcePathStyle: true,
  credentials: {
    accessKeyId: process.env.S3_ACCESS_KEY_ID,
    secretAccessKey: process.env.S3_SECRET_ACCESS_KEY,
  },
});

const upload = multer({ limits: { fileSize: 20 * 1024 * 1024 } }); // 20 MB
const app = express();

app.post("/upload", upload.single("file"), async (req, res) => {
  const key = `uploads/${crypto.randomUUID()}-${req.file.originalname}`;
  await s3.send(new PutObjectCommand({
    Bucket: process.env.S3_BUCKET,
    Key: key,
    Body: req.file.buffer,
    ContentType: req.file.mimetype,
  }));
  res.json({ key });
});

Lưu key vào database cùng bản ghi (ảnh đại diện của người dùng, file đính kèm của đơn hàng). Với file lớn, dùng Upload của @aws-sdk/lib-storage để SDK tự chia multipart.

Python (boto3)

import os, uuid, boto3
from botocore.config import Config

s3 = boto3.client(
    "s3",
    endpoint_url=os.environ["S3_ENDPOINT"],
    region_name=os.environ["S3_REGION"],
    aws_access_key_id=os.environ["S3_ACCESS_KEY_ID"],
    aws_secret_access_key=os.environ["S3_SECRET_ACCESS_KEY"],
    config=Config(s3={"addressing_style": "path"}),
)

def save_upload(fileobj, filename, content_type):
    key = f"uploads/{uuid.uuid4()}-{filename}"
    s3.upload_fileobj(fileobj, os.environ["S3_BUCKET"], key,
                      ExtraArgs={"ContentType": content_type})
    return key

upload_fileobj tự chuyển sang multipart khi file lớn. Django dùng django-storages với cùng các tham số (AWS_S3_ENDPOINT_URL, AWS_S3_ADDRESSING_STYLE = "path").

PHP (Laravel)

Laravel có sẵn disk s3 (cài league/flysystem-aws-s3-v3). Đặt biến:

FILESYSTEM_DISK=s3
AWS_ENDPOINT=${{files.S3_ENDPOINT}}
AWS_DEFAULT_REGION=${{files.S3_REGION}}
AWS_BUCKET=${{files.S3_BUCKET}}
AWS_ACCESS_KEY_ID=${{files.S3_ACCESS_KEY_ID}}
AWS_SECRET_ACCESS_KEY=${{files.S3_SECRET_ACCESS_KEY}}
AWS_USE_PATH_STYLE_ENDPOINT=true

Rồi Storage::put('uploads/'.$name, $content) như thường. Xem thêm bài deploy Laravel PHP.

Công khai hay riêng tư?

Bucket trên ZoCloud là riêng tư: chỉ ai có access key của bucket mới đọc ghi được, và key chỉ có quyền trên đúng bucket đó. Không có chế độ "ai có link cũng xem" cho cả bucket. Có hai cách đưa file tới người dùng:

1. Link có thời hạn (presigned URL). App ký một đường dẫn chỉ dùng được trong vài phút. Hợp với hoá đơn, tài liệu cá nhân, file chỉ chủ tài khoản được tải.

import { GetObjectCommand } from "@aws-sdk/client-s3";
import { getSignedUrl } from "@aws-sdk/s3-request-presigner";

app.get("/files/:id", async (req, res) => {
  const file = await db.findFileForUser(req.params.id, req.user.id); // kiểm tra quyền
  const url = await getSignedUrl(s3,
    new GetObjectCommand({ Bucket: process.env.S3_BUCKET, Key: file.key }),
    { expiresIn: 300 });                       // 5 phút
  res.redirect(url);
});

Python: s3.generate_presigned_url("get_object", Params={"Bucket": ..., "Key": ...}, ExpiresIn=300). Laravel: Storage::temporaryUrl($key, now()->addMinutes(5)).

2. Phục vụ qua app. Một route của app đọc object từ S3 rồi trả về, kèm header cache. Hợp với ảnh sản phẩm, avatar công khai. Đặt Cloudflare phía trước để cache ảnh ở mạng biên, app chỉ phải đọc mỗi file một lần.

Về upload: cách chắc chắn là cho file đi qua backend như các ví dụ trên, nơi bạn kiểm tra quyền, loại file và kích thước trước khi ghi.

Dùng bucket từ máy bạn: rclone và AWS CLI

Lấy giá trị bằng zo buckets creds files, rồi cấu hình rclone (~/.config/rclone/rclone.conf):

[zocloud]
type = s3
provider = Other
endpoint = https://s3.zocloud.app
region = <S3_REGION>
access_key_id = <S3_ACCESS_KEY_ID>
secret_access_key = <S3_SECRET_ACCESS_KEY>
force_path_style = true
rclone ls zocloud:<tên-bucket>
rclone copy ./anh-san-pham zocloud:<tên-bucket>/products --progress
rclone sync zocloud:<tên-bucket> ./backup-bucket      # tải toàn bộ về máy

<tên-bucket> là giá trị S3_BUCKET, không nhất thiết trùng tên bạn đặt trên portal. Với AWS CLI:

export AWS_ACCESS_KEY_ID=… AWS_SECRET_ACCESS_KEY=… AWS_REGION=<S3_REGION>
aws s3 ls s3://<tên-bucket>/ --endpoint-url https://s3.zocloud.app
aws s3 cp ./bao-cao.pdf s3://<tên-bucket>/reports/ --endpoint-url https://s3.zocloud.app

rclone cũng là cách nhanh để chuyển dữ liệu từ một S3 khác sang ZoCloud: cấu hình cả hai remote rồi rclone copy nguon:bucket zocloud:<tên-bucket>.

Dùng bucket để chứa backup

Bucket hợp để giữ bản xuất dữ liệu, log hay file backup của app. Một cron job chạy mỗi đêm có thể xuất dữ liệu rồi đẩy lên bucket bằng SDK. Database PostgreSQL, MySQL và Valkey trên ZoCloud đã có backup tự động mỗi đêm riêng, nên bạn không cần tự làm việc này cho chúng (xem PostgreSQL cloud tại Việt Nam).

Dung lượng, chi phí và xoá bucket

  • Mục Dung lượng hiện phần đã dùng, giới hạn và số file (đo định kỳ, không tức thời). Bấm Đổi giới hạn để đặt giới hạn mới.
  • Bạn trả tiền theo dung lượng thực dùng; tổng dung lượng object storage là một giới hạn của gói. Xem Thanh toán.
  • Ghi vượt giới hạn sẽ bị từ chối, nên app nên bắt lỗi khi upload và báo rõ cho người dùng.
  • Vùng nguy hiểm → Xoá bucket: xoá mọi file, rồi xoá bucket và key. Không hoàn tác được. CLI: zo buckets delete files.

Tài liệu đầy đủ: Object storage (S3), zo CLI.

Câu hỏi thường gặp

Object storage của ZoCloud có tương thích S3 không? Có. Bucket nằm tại endpoint https://s3.zocloud.app, kiểu địa chỉ path-style, dùng được với AWS SDK, boto3, rclone, s3cmd và các S3 client khác.

Có để bucket công khai cho ai cũng xem được không? Bucket trên ZoCloud là riêng tư, mỗi bucket có access key riêng chỉ truy cập được bucket đó. Để chia sẻ file, tạo link có thời hạn (presigned URL) hoặc phục vụ file qua app của bạn.

Upload file lớn bao nhiêu được? Một lần upload đơn tối đa 100 MB. File lớn hơn dùng multipart upload, việc mà AWS SDK, boto3 và rclone tự làm.

Dung lượng bucket tính tiền thế nào? Bạn đặt giới hạn dung lượng cho mỗi bucket và trả tiền theo dung lượng thực dùng. Tổng dung lượng object storage là một giới hạn của gói.

Chạy app của bạn tại Việt Nam trong vài phút.
Deploy từ GitHub, database được quản lý, thanh toán bằng VND, có hoá đơn VAT.
Đăng ký ZoCloud   Xem hướng dẫn