PostgreSQL cloud tại Việt Nam: managed, có backup và TLS
ZoCloud cho bạn một database PostgreSQL được quản lý, chạy trên máy chủ tại Việt Nam: tạo trong vài giây bằng Thêm → PostgreSQL hoặc zo db create pg -engine postgres, nối vào app bằng một biến DATABASE_URL=${{pg.DATABASE_URL}}, tự động backup mỗi đêm có mã hoá. Database chỉ mở trong mạng riêng của project; khi cần làm việc từ máy cá nhân, bạn bật truy cập từ Internet với TLS bắt buộc và tắt lại khi xong.
Bài này đi qua toàn bộ vòng đời: tạo, kết nối, chuyển dữ liệu cũ sang, sao lưu, khôi phục và theo dõi dung lượng.
Vì sao dùng PostgreSQL được quản lý thay vì tự cài
Tự cài PostgreSQL trên VPS thì rẻ lúc đầu, nhưng bạn phải tự lo cập nhật, cấu hình pg_hba.conf, chứng chỉ TLS, script backup, kiểm tra bản backup có khôi phục được không, và theo dõi đĩa đầy. Với database được quản lý trên ZoCloud:
- Không có máy chủ để quản trị: bạn chỉ thấy database, biến kết nối, backup và số liệu.
- Đặt tại Việt Nam: app và database cùng nằm trong nước, độ trễ thấp với người dùng Việt Nam; bản backup chính cũng lưu trong nước. Xem thêm lưu trữ dữ liệu tại Việt Nam và Nghị định 53.
- Pool kết nối có sẵn:
DATABASE_URLđi qua PgBouncer, app mở nhiều kết nối cũng không làm máy chủ hết chỗ. - Biến tham chiếu: app không chứa mật khẩu; giá trị tự cập nhật nếu database đổi máy chủ hay mật khẩu.
So sánh rộng hơn ở VPS hay PaaS.
Tạo database PostgreSQL
- Đăng ký ZoCloud, vào Project → Tạo project, chọn Vị trí.
- Trên canvas, bấm Thêm → PostgreSQL (dưới mục Database).
- Nhập Tên, ví dụ
pg(chữ thường, số,-). Tên này dùng trong biến tham chiếu. - Bấm Tạo. Database sẵn sàng sau vài giây.
Bằng CLI, trong thư mục đã gắn với service (zo link myorg/shop/web):
zo db create pg -engine postgres
zo db list
Lệnh create in luôn biến tham chiếu cần dùng. AI agent làm được việc này qua công cụ create_database của MCP server.
Nối app với PostgreSQL qua mạng riêng
Database chỉ nhận kết nối từ các app trong cùng environment, qua mạng riêng của ZoCloud. Mở service → tab Biến môi trường, thêm:
DATABASE_URL=${{pg.DATABASE_URL}}
Hoặc:
zo vars set 'DATABASE_URL=${{pg.DATABASE_URL}}'
zo deploy
(Dấu nháy đơn để shell không hiểu ${{…}} là biến của shell.) Biến có hiệu lực từ lần deploy sau.
Các biến PostgreSQL có sẵn:
| Biến | Dùng cho |
|---|---|
DATABASE_URL |
Truy vấn của app, đi qua PgBouncer chế độ transaction |
DATABASE_URL_DIRECT |
Nối thẳng: migration, LISTEN/NOTIFY, advisory lock, SET theo phiên, cursor WITH HOLD |
PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE |
Thư viện hoặc công cụ cần từng phần riêng (psql đọc thẳng các biến này) |
DATABASE_PUBLIC_URL |
Chỉ có khi bật truy cập từ Internet |
Phần lớn ORM chạy bình thường qua pool, kể cả prepared statement. Với Prisma, đặt hai biến:
DATABASE_URL=${{pg.DATABASE_URL}}
DIRECT_URL=${{pg.DATABASE_URL_DIRECT}}
và trong schema.prisma khai báo directUrl = env("DIRECT_URL") để prisma migrate dùng kết nối thẳng. Với Django, Rails, Laravel, chạy migration bằng DATABASE_URL_DIRECT nếu gặp lỗi liên quan tới phiên.
Hướng dẫn trọn vẹn cho từng ngôn ngữ: Node.js + PostgreSQL, Python FastAPI, Django.
Kết nối từ máy của bạn bằng TLS
Khi cần mở bằng TablePlus, DBeaver, pgAdmin hay chạy script từ máy:
- Database → tab Kết nối → Truy cập từ Internet → bật, xác nhận Mở.
- Portal hiện
host:cổngdạngtcp.zocloud.app:30xxx. Chuỗi đầy đủ (kèm mật khẩu) nằm trong biếnDATABASE_PUBLIC_URLở mục Biến kết nối. - Kết nối bắt buộc TLS;
sslmode=requiređã có sẵn trong chuỗi. Trong công cụ đồ hoạ, nhớ bật SSL.
psql "$(zo db vars pg | grep ^DATABASE_PUBLIC_URL= | cut -d= -f2-)"
Ai có mật khẩu đều kết nối được từ bất kỳ đâu, nên tắt khi không dùng. Agent có công cụ database_public để mở và đóng.
Chỉ cần xem nhanh vài bảng thì không phải mở ra Internet: tab Dữ liệu cho xem bảng theo trang và chạy SQL ngay trên portal, mặc định ở chế độ Chỉ đọc. Tắt Chỉ đọc mới chạy được INSERT, UPDATE, ALTER; lệnh ghi không hoàn tác được. Vai trò Developer chỉ chạy được truy vấn đọc.
Chuyển dữ liệu PostgreSQL cũ sang ZoCloud
Từ máy chủ cũ, xuất bằng định dạng custom của pg_dump:
pg_dump -Fc --no-owner --no-privileges "postgresql://user:pass@old-host:5432/shop" -f shop.dump
Bật Truy cập từ Internet cho database mới, rồi nạp vào:
URL="$(zo db vars pg | grep ^DATABASE_PUBLIC_URL= | cut -d= -f2-)"
pg_restore --no-owner --no-privileges -d "$URL" shop.dump
--no-owner và --no-privileges bỏ các lệnh đổi chủ sở hữu và phân quyền theo tài khoản ở máy cũ, vốn không tồn tại trên ZoCloud. Dump lớn thì chạy ngoài giờ cao điểm, và kiểm tra số dòng của vài bảng chính sau khi xong. Xong việc, tắt truy cập từ Internet.
Backup và khôi phục
Tab Sao lưu của database:
- Tự động mỗi đêm, mã hoá, bản chính lưu tại Việt Nam.
- Backup ngay: tạo bản thủ công, nên bấm trước khi chạy migration lớn hay lệnh ghi hàng loạt. CLI:
zo db backup pg; xem danh sách:zo db backups pg. - Lịch backup: chọn Giờ backup (giờ Việt Nam) lúc app ít tải và Giữ backup tự động (ngày), tối đa theo gói. Bản thủ công không bị xoá theo lịch.
- Tải về: file dump định dạng custom của
pg_dump(.dump), khôi phục ở bất kỳ đâu bằngpg_restore -d <db> file.dump. Mỗi lượt tải được ghi vào nhật ký hoạt động.
Khôi phục luôn vào một database mới, database đang chạy không bị đụng tới:
- Nhập tên database mới ở ô phía trên danh sách (ví dụ
pg-restore). - Chọn bản backup → Khôi phục.
- Kiểm tra dữ liệu trong database mới (tab Dữ liệu).
- Đổi biến của service sang
${{pg-restore.DATABASE_URL}}và deploy lại.
Cách này cho phép bạn so sánh dữ liệu trước khi chuyển, và quay lại database cũ ngay nếu cần.
Dung lượng, kết nối và chọn gói
Mỗi database có một định mức đĩa hiện ở đầu trang (ví dụ "Dung lượng 120 / 5120 MB"), đo khoảng 10 phút một lần; ZoCloud gợi ý khi database dùng quá khoảng 85% định mức. Tab Số liệu có biểu đồ Kết nối (số kết nối đang mở so với giới hạn) và Dung lượng trên đĩa, xem theo 1 giờ tới 7 ngày.
Số database là giới hạn theo gói (giá theo tháng, chưa gồm VAT 10%, trả từ ví VND):
| Gói | Giá/tháng | Số database | RAM |
|---|---|---|---|
| Dùng thử | 0 đ | 1 | 512 MB |
| Hobby | 119.000 đ | 2 | 1 GB |
| Pro | 499.000 đ | 5 | 4 GB |
| Team | 1.990.000 đ | 20 | 16 GB |
Vài kinh nghiệm để database chạy nhẹ:
- Dùng
DATABASE_URL(qua pool) cho app; đừng tự mở pool hàng trăm kết nối mỗi bản chạy. - Thêm index cho các cột hay lọc; dùng
EXPLAIN ANALYZEở tab Dữ liệu để xem truy vấn chậm. - Đừng lưu file, ảnh trong database: dùng object storage S3.
- Dữ liệu tạm, session, rate limit: dùng Redis (Valkey).
Staging và preview có database riêng
Khi tạo environment staging, chọn Database riêng (trống) để có một PostgreSQL trống giống bản gốc, không đụng dữ liệu production:
zo env create staging -from production -branch develop -fresh-db
Preview cho Pull Request cũng có thể dùng database riêng, trống cho mỗi PR. Xem môi trường staging và preview. Tài liệu đầy đủ: hướng dẫn database, zo CLI.
Câu hỏi thường gặp
Tạo một database PostgreSQL trên ZoCloud mất bao lâu?
Vài giây. Trong project, bấm Thêm → PostgreSQL, đặt tên và bấm Tạo, hoặc chạy zo db create pg -engine postgres. Bạn không cài hay cấu hình máy chủ nào.
DATABASE_URL và DATABASE_URL_DIRECT khác nhau thế nào?
DATABASE_URL đi qua PgBouncer ở chế độ transaction, hợp cho truy vấn của app. DATABASE_URL_DIRECT nối thẳng, dùng cho migration, LISTEN/NOTIFY, advisory lock và các việc cần một phiên liền mạch.
PostgreSQL trên ZoCloud được sao lưu thế nào?
Mỗi đêm có bản backup tự động, mã hoá, bản chính lưu tại Việt Nam; bạn bấm Backup ngay bất cứ lúc nào và tải bản dump về được. Khôi phục luôn vào một database mới nên database đang chạy không bị đụng tới.
Có kết nối PostgreSQL từ máy cá nhân hay công cụ BI được không?
Được. Bật Truy cập từ Internet ở tab Kết nối; kết nối bắt buộc TLS (sslmode=require) và chuỗi đầy đủ nằm trong biến DATABASE_PUBLIC_URL. Nên tắt khi không dùng.