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.jsoncó các scriptdev,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ằngnpm install, phiên bản thư viện có thể lệch đôi chút. Muốn cố định, chạynpm installtrên máy để sinhpackage-lock.jsonrồi commit. - Chạy thử
npm run buildtrê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
- Đă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í.
- Mục Project → Tạo project, đặt tên (ví dụ
shop). - 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.
- Trên canvas, Thêm → Từ repo GitHub, chọn repo, đặt Tên service là
web, Nhánh làmain. - 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_URLvà một biến khoá (ví dụVITE_SUPABASE_PUBLISHABLE_KEYhayVITE_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.appvà 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
- Tab Tên miền của service → nhập
www.shopcuatoi.vn→ Thêm. - Tạo bản ghi DNS mà portal hiện: tên con dùng
CNAMEvềweb-shop.zocloud.app; tên gốc dùng bản ghiAvề 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. - 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
- 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.
- 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ằngpsql. - Viết service API, đặt
DATABASE_URL=${{pg.DATABASE_URL}}, sửa giao diện gọi API này thay vì Supabase. - 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.