Blog ZoCloud Dùng thử

Đăng ngày 13/11/2026

Deploy app Bolt.new lên ZoCloud: từ file tải về hoặc GitHub tới HTTPS

Để deploy app làm bằng Bolt.new lên ZoCloud, lấy code ra khỏi Bolt (tải về máy hoặc đẩy lên GitHub), rồi deploy bằng lệnh zo deploy hoặc Deploy từ Git trên portal. ZoCloud tự nhận diện dự án Vite hay Node.js, build và trả về link HTTPS dạng https://web-<project>.zocloud.app. Sau đó bạn đặt biến môi trường, thêm database nếu cần, và gắn tên miền riêng.

Bolt.new sinh ra loại dự án nào

Bolt.new chạy code trong trình duyệt bằng môi trường Node.js, nên app Bolt là dự án Node.js thông thường với package.json. Tuỳ yêu cầu ban đầu, bạn sẽ gặp một trong các dạng:

Dạng dự án Nhận biết trong package.json ZoCloud chạy thế nào
Vite + React (hay Vue, Svelte), chỉ có giao diện có vite, script dev, build, preview, không có start Build rồi phục vụ thư mục dist thành site tĩnh
Vite + server Express có thêm script start chạy file server (ví dụ node server.js) Build rồi chạy start như một app Node.js
Next.js có next Build rồi chạy next start
Astro, SvelteKit, Remix… có framework tương ứng Nhận diện theo framework

Không chắc app của bạn thuộc dạng nào? Sau khi lấy code về máy, chạy zo detect: lệnh này in framework, lệnh cài, lệnh build, lệnh chạy mà ZoCloud sẽ dùng.

Một lưu ý: nếu script start chỉ là vite (chạy server phát triển), đừng để ZoCloud dùng nó cho production. Xoá script start đó để ZoCloud phục vụ bản build tĩnh, hoặc đổi thành lệnh chạy server thật.

Với site tĩnh Vite, mọi đường dẫn không phải file (/gio-hang, /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: Lấy code ra khỏi Bolt

Bạn có hai cách (giao diện Bolt thay đổi thường xuyên, nên tên nút có thể khác đôi chút):

  • Tải về: dùng tuỳ chọn tải dự án thành file zip trong Bolt, giải nén ra một thư mục.
  • GitHub: dùng tích hợp GitHub của Bolt để đẩy dự án lên một repo. Cách này tiện nếu bạn muốn tự deploy mỗi lần cập nhật.

Trên máy, nên chạy thử trước:

npm install
npm run build

Build trên máy được thì thường build trên ZoCloud cũng được. Đây cũng là lúc kiểm tra file .env mà Bolt tạo: ghi lại các biến trong đó, bạn sẽ đặt chúng trên ZoCloud ở bước 3.

Bước 2a: Deploy từ thư mục bằng zo CLI

Đây là cách nhanh nhất khi bạn vừa tải zip về.

curl -fsSL https://app.zocloud.io/install.sh | sh
zo login                         # dán token tạo ở Tài khoản → Token truy cập
cd duong-dan/app-bolt
zo detect
zo deploy -to myorg/shop/web

Windows: tải zo.exe ở Tài khoản → mục Deploy từ máy của bạn.

Project shop và service web được tạo tự động nếu chưa có. zo đóng gói thư mục, bỏ qua node_modules, .git và các mẫu trong .gitignore, không bao giờ gửi file .env, rồi in log build và địa chỉ HTTPS khi xong. Lần sau chỉ cần zo deploy.

Bước 2b: Deploy từ GitHub

  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.
  3. Mục GitHub của tổ chức → Kết nối GitHub, cài ZoCloud cho repo. ZoCloud chỉ đọc mã nguồn.
  4. Trên canvas, Thêm → Từ repo GitHub, chọn repo, kiểm tra Tên service, Nhánh, Thư mục gốc.
  5. Bấm Tạo và deploy.

Bật Tự deploy khi push ở tab Cấu hình để mỗi lần push là có bản mới. Bản đang chạy vẫn phục vụ khi bản mới đang build hoặc bị lỗi.

Bước 3: Đặt biến môi trường

Đặt lại các biến từ file .env của Bolt ở tab Biến môi trường của service (bấm Sửa dạng .env để dán nhiều dòng), hoặc:

zo vars set VITE_SUPABASE_URL=https://xxxx.supabase.co VITE_SUPABASE_ANON_KEY=eyJ...
zo deploy

Hai điều cần nhớ:

  • Biến có hiệu lực từ lần deploy sau. Biến VITE_* còn được đưa thẳng vào bản build, nên đổi biến là phải deploy lại.
  • Biến VITE_* lộ ra cho mọi người xem trang. Chỉ đặt vào đó những giá trị công khai (URL, khoá anon). Khoá bí mật như khoá API trả phí hay service_role của Supabase phải nằm ở phía server, không có tiền tố VITE_.

Chi tiết ở biến môi trường và file .env.

Bước 4: Database cho app Bolt

App dùng Supabase

Nhiều app Bolt gọi Supabase thẳng từ trình duyệt. Bạn có thể giữ nguyên: chỉ cần đặt biến như bước 3. Nếu app có đăng nhập, thêm địa chỉ ….zocloud.app và tên miền riêng vào Site URL và Redirect URLs trong phần cấu hình Authentication của dự án Supabase.

Chuyển hẳn từ Supabase sang PostgreSQL của ZoCloud thì được với dữ liệu bảng (dump và nạp lại), nhưng đăng nhập, lưu file, Edge Functions và quy tắc Row Level Security không tự chuyển theo: bạn cần một service backend đứng giữa giao diện và database. Phân tích kỹ hơn trong bài deploy app Lovable, phần "Giữ Supabase hay chuyển dữ liệu".

App có server Node.js cần database

Nếu app Bolt có server Express (hoặc Next.js với API routes) và cần database, thêm database trong cùng project:

zo db create pg -engine postgres
zo vars set 'DATABASE_URL=${{pg.DATABASE_URL}}'
zo deploy

Dùng dấu nháy đơn để shell không hiểu ${{…}} là biến của shell. Biến tham chiếu tự cập nhật nếu database đổi máy chủ hay mật khẩu. Database chạy trong mạng riêng, chỉ service trong cùng environment truy cập được, và được sao lưu mỗi đêm.

Cần MySQL hay bộ đệm Redis? Dùng -engine mysql hoặc -engine valkey (biến ${{cache.REDIS_URL}}). Xem PostgreSQL trên cloud tại Việt Nam, MySQL hosting và Redis, Valkey làm cache.

App dùng SQLite (một file database)? Thêm volume để file không mất khi deploy lại: tab Cấu hình → Volume → Thêm volume, đường dẫn ví dụ /data, rồi trỏ SQLite vào /data/app.db. Service có volume chạy 1 bản.

Server phải nghe đúng cổng ZoCloud đặt:

const port = process.env.PORT || 3000;
app.listen(port, "0.0.0.0");

Bước 5: Tên miền riêng và HTTPS

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

Gói Dùng thử chưa có tên miền riêng; gói Hobby (119.000 đ/tháng, chưa gồm VAT) có 3 tên miền, gói Pro (499.000 đ) có 20. Xem trỏ tên miền về hosting.

Tiếp tục sửa app sau khi deploy

Sau khi app đã lên mạng, bạn có thể:

Khi có lỗi, xem log ở tab Log hoặc:

zo logs -since 1h
zo logs -stream http -status 5xx

Lỗi hay gặp

Hiện tượng Cách xử lý
Trang trắng sau deploy Thiếu biến VITE_*, hoặc đặt biến xong chưa deploy lại
"không có gì nghe trên cổng N" Server không nghe 0.0.0.0:$PORT
App chạy chế độ phát triển, chậm Script start là vite; xoá hoặc đổi thành lệnh chạy server thật
Tải lại trang con báo 404 Dự án có start nên không được phục vụ như SPA; kiểm tra zo detect
Dữ liệu SQLite mất sau deploy Chưa có volume; thêm volume và lưu file database trong đó

Tài liệu đầy đủ: App, zo CLI, Database.

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