Blog ZoCloud Dùng thử

Đăng ngày 13/11/2026

Deploy app Lovable lên ZoCloud, từ GitHub tới tên miền riêng

Để deploy app làm bằng Lovable lên ZoCloud, bạn đồng bộ dự án Lovable sang GitHub, kết nối repo đó với ZoCloud và bấm Tạo và deploy. ZoCloud nhận ra dự án Vite + React, build và phục vụ app qua HTTPS tại https://web-<project>.zocloud.app; sau đó bạn đặt các biến VITE_* và gắn tên miền riêng. Nếu app dùng Supabase, bạn có thể giữ nguyên Supabase hoặc chuyển dữ liệu sang PostgreSQL của ZoCloud, với một số phần phải làm lại.

App Lovable gồm những gì

Lovable sinh ra một dự án front-end khá chuẩn:

  • Vite + React + TypeScript, giao diện bằng Tailwind và shadcn/ui.
  • package.json có các script dev, build, preview (thường không có start).
  • Nếu bạn bật tích hợp Supabase: database, đăng nhập, lưu file và Edge Functions đều chạy trên Supabase; app gọi Supabase thẳng từ trình duyệt.

Nghĩa là phần bạn cần "host" chỉ là giao diện đã build: một thư mục dist gồm HTML, CSS, JavaScript. Đây là site tĩnh, rất nhẹ, chạy tốt trên gói nhỏ.

Trên ZoCloud, dự án có vite trong package.json mà không có script start được nhận diện là Vite (React/Vue/Svelte): ZoCloud cài thư viện, chạy build, rồi phục vụ thư mục dist. Mọi đường dẫn không phải file (ví dụ /dashboard, /san-pham/12) đều trả về index.html, nên React Router hoạt động khi người dùng tải lại trang.

Bước 1: Đưa code Lovable lên GitHub

Trong Lovable, mở dự án và dùng tích hợp GitHub để kết nối tài khoản GitHub, rồi tạo repo cho dự án. Lovable đồng bộ hai chiều: sửa trong Lovable thì commit vào GitHub, push lên GitHub thì Lovable thấy thay đổi. Giao diện Lovable thay đổi thường xuyên, nên tên nút có thể khác đôi chút.

Repo do Lovable tạo thường là repo riêng tư. Để ZoCloud đọc được repo riêng tư, bạn kết nối qua GitHub App (bước 2). Nếu muốn, bạn cũng có thể clone repo về máy và deploy bằng zo CLI (xem phần cuối).

Trước khi deploy, kiểm tra repo:

  • Lockfile: ZoCloud chọn trình quản lý gói theo lockfile npm, pnpm hoặc yarn. Repo Lovable hay chỉ có lockfile của bun (bun.lockb); khi đó ZoCloud cài bằng npm install, phiên bản thư viện có thể lệch đôi chút. Muốn cố định, chạy npm install trên máy để sinh package-lock.json rồi commit.
  • Chạy thử npm run build trên máy nếu có thể. Build trên máy được thì thường build trên ZoCloud cũng được.

Bước 2: Kết nối GitHub và deploy

  1. Đăng ký ZoCloud, xác minh e-mail. Bạn có thể bắt đầu với gói Dùng thử miễn phí.
  2. Mục Project → Tạo project, đặt tên (ví dụ shop).
  3. Mục GitHub của tổ chức → Kết nối GitHub, cài ZoCloud cho repo Lovable. ZoCloud chỉ đọc mã nguồn, không ghi.
  4. Trên canvas, Thêm → Từ repo GitHub, chọn repo, đặt Tên service là web, Nhánh là main.
  5. Bấm Tạo và deploy.

Khi xong, app có địa chỉ https://web-shop.zocloud.app. Bật Tự deploy khi push ở tab Cấu hình: từ giờ mỗi lần bạn sửa trong Lovable (Lovable commit vào GitHub) là ZoCloud tự build bản mới. Bản đang chạy vẫn phục vụ trong lúc build; nếu bản mới lỗi, bản cũ giữ nguyên.

Muốn cố định cách build, đặt zocloud.json ở gốc repo:

{
  "build": {
    "install": "npm ci",
    "build": "npm run build",
    "runtime_version": "22",
    "output_dir": "dist"
  }
}

Bước 3: Biến môi trường VITE_

Vite chỉ đưa vào code phía trình duyệt những biến có tiền tố VITE_, và đưa vào lúc build. Trên ZoCloud, biến môi trường của service được dùng cả lúc build và lúc chạy, nên biến VITE_* hoạt động bình thường.

Mở src/integrations/supabase/client.ts (hoặc file tạo Supabase client) để xem app lấy cấu hình từ đâu:

  • Nếu code đọc import.meta.env.VITE_SUPABASE_URL và một biến khoá (ví dụ VITE_SUPABASE_PUBLISHABLE_KEY hay VITE_SUPABASE_ANON_KEY), hãy đặt đúng các tên đó ở tab Biến môi trường của service. Bấm Sửa dạng .env để dán nhiều dòng:
VITE_SUPABASE_URL=https://xxxx.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=eyJ...
  • Nếu URL và khoá được ghi thẳng trong file, app vẫn chạy mà không cần biến. Bạn có thể đổi sang import.meta.env để dễ dùng nhiều môi trường.

Khoá anon/publishable của Supabase được thiết kế để nằm trong trình duyệt; an toàn dữ liệu phụ thuộc vào Row Level Security trên Supabase. Tuyệt đối không đặt khoá service_role vào biến VITE_*: mọi biến VITE_* đều lộ ra cho người xem trang.

Biến có hiệu lực từ lần deploy sau: đặt xong, bấm Deploy để build lại. Bằng CLI:

zo link myorg/shop/web
zo vars set VITE_SUPABASE_URL=https://xxxx.supabase.co VITE_SUPABASE_PUBLISHABLE_KEY=eyJ...
zo deploy

Đọc thêm về biến ở biến môi trường và file .env.

Bước 4: Cập nhật Supabase Auth cho địa chỉ mới

Nếu app có đăng nhập bằng Supabase (e-mail magic link, Google…), Supabase chỉ chuyển người dùng về những địa chỉ đã khai báo. Trong dự án Supabase, phần cấu hình Authentication → URL Configuration:

  • Site URL: địa chỉ chính của app (tên miền riêng, hoặc https://web-shop.zocloud.app).
  • Redirect URLs: thêm cả địa chỉ ….zocloud.app và tên miền riêng.

Đăng nhập Google, GitHub qua Supabase không cần đổi gì ở phía Google hay GitHub, vì callback vẫn là địa chỉ của Supabase.

Bước 5: Gắn tên miền riêng

  1. Tab Tên miền của service → nhập www.shopcuatoi.vn → Thêm.
  2. Tạo bản ghi DNS mà portal hiện: tên con dùng CNAME về web-shop.zocloud.app; tên gốc dùng bản ghi A về IP của ZoCloud. Tên miền mua tại ZoCloud hoặc dùng ZoCloud DNS thì bản ghi được tạo tự động.
  3. Khi DNS đúng, HTTPS được cấp tự động trong vài phút.

CLI: zo domains add www.shopcuatoi.vn. Gói Dùng thử chưa có tên miền riêng; gói Hobby (119.000 đ/tháng, chưa VAT) có 3 tên miền. Chi tiết: trỏ tên miền về hosting.

Giữ Supabase hay chuyển dữ liệu sang ZoCloud?

Đây là câu hỏi quan trọng nhất, và câu trả lời thật là: với đa số app Lovable, giữ Supabase là hợp lý nhất lúc đầu. Bạn chỉ chuyển phần giao diện, không phải viết lại gì.

Chuyển dữ liệu sang PostgreSQL của ZoCloud có lợi khi bạn muốn dữ liệu nằm tại Việt Nam, gom chi phí về một chỗ trả bằng VND, hoặc đã vượt giới hạn gói Supabase. Nhưng cần biết rõ phần nào chuyển được, phần nào không:

Thành phần Supabase Chuyển sang ZoCloud
Bảng dữ liệu (PostgreSQL) Được: dump và nạp vào PostgreSQL của ZoCloud
Row Level Security, policy Không còn tác dụng như cũ: app không gọi database thẳng từ trình duyệt được nữa
Đăng nhập (Supabase Auth) Không tự chuyển: cần thư viện đăng nhập khác trong backend của bạn
File (Supabase Storage) Không tự chuyển: chép file sang bucket S3 và sửa code tải lên
Edge Functions, Realtime Không tự chuyển: viết lại thành API trong service backend

Điểm mấu chốt: app Lovable gọi Supabase từ trình duyệt. PostgreSQL trên ZoCloud chạy trong mạng riêng, chỉ service của bạn truy cập được, nên bạn cần thêm một service backend (ví dụ Node.js + Express) đứng giữa giao diện và database. Đó là một dự án viết lại thật sự, không phải một thao tác.

Nếu vẫn muốn chuyển, lộ trình gọn:

zo db create pg -engine postgres
zo db vars pg                   # lấy thông tin kết nối
  1. Bật Truy cập từ Internet cho database (tab Kết nối) để nạp dữ liệu từ máy, xong thì tắt.
  2. Dump schema và dữ liệu bảng của bạn từ Supabase bằng pg_dump (bỏ các schema riêng của Supabase như auth, storage), nạp vào ZoCloud bằng psql.
  3. Viết service API, đặt DATABASE_URL=${{pg.DATABASE_URL}}, sửa giao diện gọi API này thay vì Supabase.
  4. File: tạo bucket bằng zo buckets create files, xem object storage S3 tại Việt Nam.

Có thể nhờ chính AI agent làm phần viết lại này (xem deploy từ ChatGPT, Claude), nhưng hãy kiểm tra kỹ phần đăng nhập và phân quyền. Đọc thêm về PostgreSQL trên cloud tại Việt Nam.

Deploy bằng zo CLI thay vì GitHub

Không muốn kết nối GitHub? Clone repo về máy rồi:

curl -fsSL https://app.zocloud.io/install.sh | sh
zo login
zo detect                     # phải thấy Vite, thư mục dist
zo deploy -to myorg/shop/web

zo không gửi file .env, nên các biến VITE_* phải đặt bằng zo vars set trước khi deploy. Cách này không tự deploy khi bạn sửa trong Lovable; mỗi lần cần cập nhật, chạy lại zo deploy.

Lỗi hay gặp

Hiện tượng Cách xử lý
Trang trắng, console báo thiếu Supabase URL Chưa đặt biến VITE_*, hoặc đặt xong chưa deploy lại
Tải lại /dashboard báo 404 Dự án không được nhận diện là Vite; kiểm tra zo detect và Thư mục gốc
Build lỗi ở bước cài đặt Xem log build; thường do phiên bản thư viện lệch, sinh package-lock.json và commit
Đăng nhập xong bị đưa về địa chỉ Lovable Cập nhật Site URL và Redirect URLs trong Supabase

Muốn đọc thêm về Vite nói chung: deploy React, Vite. Hướng dẫn đầy đủ về app ở tài liệu App.

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