Control panel cho thời đại AI: vibe code xong, push lên GitHub là chạy.Khám phá →

Deploy app Lovable lên VPS: GitHub, build, tên miền, SSL

Cách deploy app Lovable lên VPS: đồng bộ GitHub, phân biệt app Vite với TanStack Start, giữ hay chuyển backend Supabase, rồi build, routing và gắn SSL.

Ảnh bìa blog ZoPanel: Deploy app Lovable lên VPS: GitHub, build, tên miền, SSL

Ý chính

  • Đồng bộ GitHub của Lovable là hai chiều, có ở mọi gói, luôn tạo một repository riêng tư mới và chỉ đồng bộ một branch, mặc định là main.
  • App Lovable tạo từ ngày 13/5/2026 dùng TanStack Start và cần server Node.js, còn app cũ hơn là React + Vite, build ra file tĩnh trong dist.
  • Biến VITE_ bị nhúng vào code trình duyệt lúc build, nên chỉ URL Supabase và publishable key được đặt ở đó, không bao giờ là secret key.
  • Backend có thể ở lại Lovable Cloud hoặc Supabase trong khi front end chuyển lên VPS; còn chuyển chính backend thì phải export và restore thủ công.

Để deploy app Lovable lên VPS, bạn kết nối project với GitHub bằng tính năng đồng bộ Git hai chiều của Lovable, clone repository đó về server rồi chạy npm ci && npm run build. App Lovable đời cũ là React + Vite, build ra file tĩnh trong dist/ để nginx phục vụ, mọi route đều trả về index.html; app tạo từ ngày 13/5/2026 dùng TanStack Start và chạy như một server Node.js (node .output/server/index.mjs) phía sau reverse proxy. Database, đăng nhập và storage có thể giữ nguyên trên Lovable Cloud hoặc Supabase, nên chỉ phần front end phải di chuyển.

Bài này bám theo tài liệu deploy của chính Lovable và bổ sung những phần họ để bạn tự lo: server, tên miền, SSL và tự deploy mỗi lần push. Muốn có bức tranh rộng hơn (app AI viết nào hợp hosting nào), hãy đọc trước bài deploy app vibe code.

Có tự host app Lovable được không?

Được, với app, không phải với trình soạn thảo. Tài liệu Lovable ghi trình soạn thảo và AI agent là dịch vụ được quản lý, không tự host được, nhưng "app bạn build bằng Lovable có thể host ở bất kỳ đâu", và app, code, nội dung bạn tạo ra thuộc về bạn. Cùng trang đó liệt kê những gì bạn phải gánh khi rời nền tảng: hạ tầng production, chứng chỉ SSL, cấu hình CDN, mở rộng, database, backup và giám sát bảo mật.

Bạn vẫn tiếp tục build trong Lovable sau khi chuyển. Đồng bộ Git là hai chiều, nên thay đổi trong Lovable sẽ lên GitHub và server của bạn deploy nó.

Project Lovable của bạn dùng stack nào?

Theo FAQ của Lovable, app mới "dùng TanStack Start, render trang trên server" (từ ngày 13/5/2026, hoặc 22/6/2026 với workspace Enterprise), còn app cũ "dùng React + Vite và render trên trình duyệt". Lovable không cho chọn framework khác. Để biết project của mình thuộc loại nào, mở package.json:

React + Vite (app cũ) TanStack Start (app mới)
Cách nhận biết Không có @tanstack/react-start trong dependencies Có @tanstack/react-start trong dependencies
Build npm run build npm run build, dùng preset node-server của Nitro khi chạy trên server riêng
Kết quả File tĩnh trong dist/ Thư mục .output/ chạy độc lập
Chạy bằng nginx phục vụ file node .output/server/index.mjs, mặc định cổng 3000
Routing Server phải trả index.html cho mọi route Server tự xử lý route
Biến Supabase VITE_SUPABASE_URL, VITE_SUPABASE_PUBLISHABLE_KEY SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY

Lovable khuyên dùng Node 22 cho cả hai. Mọi thông tin trong bảng đều lấy từ hướng dẫn deploy bên ngoài của Lovable.

Xuất project Lovable lên GitHub thế nào?

Tích hợp GitHub của Lovable có ở mọi gói với github.com:

  1. Vào Workspace settings → Git → GitHub → Add connection (hoặc cùng đường dẫn đó trong Project settings) rồi bấm Add account.
  2. Trong cửa sổ GitHub, chọn tài khoản hoặc tổ chức, chọn All repositories hoặc Only select repositories, rồi bấm Install & Authorize.
  3. Mở Project settings → Git → GitHub và bấm Connect cạnh kết nối vừa tạo. Lovable tạo một repository mới và bắt đầu đồng bộ hai chiều.

Vài điều nên biết trước khi nối server vào:

  • Đồng bộ Git luôn tạo repository mới; không gắn được vào repository có sẵn, và kết nối lại sau khi ngắt cũng tạo thêm một repository mới. Khi đó URL repository trên server phải đổi theo.
  • Repository mặc định là riêng tư, nên server cần một deploy key chỉ đọc.
  • Lovable chỉ đồng bộ một branch, mặc định là branch chính của repository (thường là main). Commit ở branch khác không được đồng bộ cho tới khi merge vào.
  • Nếu Lovable và GitHub lệch nhau, Lovable đẩy thay đổi của nó sang branch lovable-sync thay vì branch đang đồng bộ, theo trang tổng quan về đồng bộ Git.

Cơ chế đồng bộ đó cũng hỗ trợ GitLab và Bitbucket Cloud. Ở gói trả phí bạn còn tải được cả project dưới dạng .zip, nhưng chỉ đồng bộ Git mới cho phép tự động deploy.

Nên giữ Lovable Cloud, Supabase hay tự host backend?

Backend tích hợp của Lovable, ở một số chỗ trong sản phẩm gọi là Lovable Cloud, "dựa trên nền tảng mã nguồn mở của Supabase" và gồm database, đăng nhập, lưu trữ file, edge function, realtime, tác vụ định kỳ và secret. Project cũng có thể kết nối với project Supabase của riêng bạn.

Bạn có ba lựa chọn:

Lựa chọn Công sức Điều gì thay đổi
Giữ backend trên Lovable Cloud Không có Chỉ front end di chuyển. Mức dùng backend vẫn tính vào credit của Lovable.
Giữ hoặc chuyển sang project Supabase được host sẵn Trung bình Phải chuyển thủ công nếu bạn đang ở Lovable Cloud
Tự host Supabase Cao Bạn tự vận hành toàn bộ stack Supabase

Với đa số người dùng, lựa chọn đầu tiên là bước đi hợp lý: chuyển front end, giữ backend, tính tiếp sau.

Rời Lovable Cloud là việc thủ công. Lovable ghi rõ họ "không chuyển project từ backend tích hợp sang project Supabase của bạn trong một bước". Hướng dẫn deploy bên ngoài mô tả từng phần: export database dưới dạng .backup định dạng custom của PostgreSQL (restore bằng pg_restore, mỗi 24 giờ được export một lần), migration trong supabase/migrations/, tải file storage về rồi tải lên lại, Edge Function trong supabase/functions/ deploy bằng npx supabase functions deploy, và tạo lại tác vụ định kỳ. Hash mật khẩu có trong bản export nên người dùng giữ được mật khẩu, nhưng phiên đăng nhập không được chuyển và các nhà cung cấp đăng nhập phải cấu hình lại. App connector, tính năng AI và việc quản lý token OAuth chạy qua Lovable nên không chuyển được.

Tự host Supabase là một dự án riêng. Hướng dẫn tự host của Supabase dùng Docker Compose với Studio, Auth, PostgREST, Realtime, Storage và Postgres, yêu cầu tối thiểu 4 GB RAM và 2 nhân CPU (khuyên dùng 8 GB và 4 nhân), và nhấn mạnh "không bao giờ" được khởi động với các secret mẫu. Một database PostgreSQL thông thường trên VPS không thay thế được, vì app còn dựa vào Supabase Auth, Storage và API của nó.

App Lovable cần những biến môi trường nào?

Giá trị nằm trong file .env của project, xem được trong trình soạn code của Lovable hoặc trong repository đã đồng bộ. Với app Vite, đó là VITE_SUPABASE_URL, VITE_SUPABASE_PUBLISHABLE_KEY và, khi chuyển Supabase, thêm VITE_SUPABASE_PROJECT_ID.

Quy tắc quan trọng nhất: Vite đưa mọi biến VITE_ vào code chạy phía client và cảnh báo chúng "không được chứa thông tin nhạy cảm như API key". Chúng cũng được nhúng lúc build, nên đổi một biến là phải build lại.

  • Publishable key của Supabase được thiết kế để dùng trên trình duyệt. Supabase giải thích key này "chỉ truy cập được những gì Row Level Security cho phép", nên mọi bảng đều phải bật Row Level Security.
  • Secret key hay service_role bỏ qua mọi policy RLS. Không bao giờ đặt nó trong biến VITE_, trong repository hay trong bản build.
  • Secret mà server function hoặc Edge Function đọc không nằm trong repository, và secret lưu trong Lovable không có trong bản export. Đặt secret cho Edge Function trong dashboard Supabase hoặc bằng supabase secrets set; đặt secret phía server của TanStack Start trên hosting của bạn.

Bài checklist bảo mật cho vibe coding nói kỹ hơn về key và RLS.

Build và phục vụ app Lovable Vite trên VPS

Trên server có Node 22 và nginx, chạy bằng user thường (không phải root):

git clone git@github.com:you/my-lovable-app.git /srv/lovable
cd /srv/lovable
cat > .env.production <<'EOF'
VITE_SUPABASE_URL=https://xxxx.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=sb_publishable_xxx
EOF
npm ci
npm run build

npm ci cần có package-lock.json. Hướng dẫn của Lovable lưu ý nếu repository chỉ có bun.lock, bạn dùng Bun hoặc tạo rồi commit một package-lock.json.

Sau đó cho nginx phục vụ dist/. Dòng try_files chính là fallback SPA mà tài liệu Lovable đưa ra cho nginx: thiếu nó, mở thẳng hoặc tải lại /dashboard sẽ ra 404.

server {
    listen 80;
    server_name app.example.com;
    root /srv/lovable/dist;
    index index.html;

    location /assets/ {
        add_header Cache-Control "public, max-age=31536000, immutable";
        try_files $uri =404;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }
}

Vite đặt tên file có mã hash trong dist/assets, nên cache dài ở đó là an toàn; riêng index.html không bị cache nên luôn lấy bản build mới.

Chạy app Lovable TanStack Start trên VPS

App TanStack Start cần một tiến trình Node.js chạy liên tục. Hướng dẫn của Lovable yêu cầu package.json phải có nitro, và build cho server riêng như sau:

npm ci
NITRO_PRESET=node-server npm run build
PORT=3000 HOST=127.0.0.1 node .output/server/index.mjs

Chạy lệnh cuối bằng systemd (xem file unit mẫu trong bài deploy Node.js lên VPS) và cho nginx proxy tới nó bằng proxy_pass http://127.0.0.1:3000;. Không thêm fallback try_files ở đây: server tự xử lý routing. Đặt SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY và các secret phía server trong biến môi trường của service.

Tên miền riêng, SSL và redirect đăng nhập

  1. Tạo bản ghi A cho tên miền trỏ về VPS (xem cách trỏ tên miền về VPS).
  2. Lấy chứng chỉ miễn phí bằng Certbot: sudo certbot --nginx -d app.example.com (xem SSL miễn phí với Let's Encrypt).
  3. Trong Supabase (hoặc phần cài đặt đăng nhập của Lovable Cloud), đặt Site URL và Redirect URLs theo tên miền mới. Checklist của Lovable yêu cầu xác nhận redirect URL đăng nhập có tên miền mới; nếu không, đăng nhập và email xác nhận sẽ đưa người dùng về địa chỉ cũ.

Bản host sẵn của Lovable ở xxx.lovable.app vẫn chạy song song; tài liệu của họ ghi hiện chưa có cách gỡ URL project đó.

Tự deploy mỗi khi sửa trong Lovable

Vì Lovable đẩy mọi thay đổi lên branch đang đồng bộ, một webhook push (hoặc workflow GitHub Actions) trên branch đó sẽ deploy mọi chỉnh sửa bạn làm trong Lovable. Cách làm giống mọi repository khác: build vào thư mục mới, chỉ chuyển khi chạy ổn, giữ bản cũ để rollback. Bài tự động deploy từ GitHub lên VPS có sẵn script và cách xác thực webhook.

Trước khi coi là xong, chạy các bước kiểm tra của chính Lovable: mở thẳng một route lồng nhau rồi tải lại, đăng nhập và đăng xuất, thử đọc, ghi và tải file lên, và với TanStack Start thì mở một trang render phía server và gọi thử một server function.

Deploy app Lovable bằng ZoPanel

Git deploy của ZoPanel lo phần clone, build, thư mục release, SSL và webhook cho bạn:

  1. Websites → New website, chọn loại Git deploy. Nhập URL repository dạng git@github.com:… và branch mà Lovable đồng bộ (mặc định main). Vì repository của Lovable là riêng tư, trước hết hãy chép key ở Deploy → Deploy key (private repositories) và thêm vào repository dưới dạng deploy key chỉ đọc.
  2. Giữ Free SSL (Let's Encrypt) bật và bấm Create website. Chứng chỉ được cấp khi tên miền đã trỏ về server.
  3. Ở tab Deploy, bấm Paste .env, dán các biến từ file .env của Lovable rồi Save & redeploy. Biến có sẵn lúc build, nên giá trị VITE_ được nhúng vào.
  4. Bật Deploy when main is pushed và thêm Payload URL cùng Secret làm webhook trên GitHub (content type application/json). Từ giờ mỗi thay đổi Lovable đồng bộ sẽ build một bản mới; 5 bản gần nhất được giữ để Rollback.

Với app Vite, bấm Analyze repository: project có vite mà không có script start được nhận diện là Vite (React/Vue/Svelte), build bằng npm run build và phục vụ như site tĩnh từ dist, asset có hash được cache 30 ngày và có sẵn bản nén. Từ ZoPanel 0.4.35, website mới deploy theo cách này được bật sẵn fallback cho single-page app, nên /dashboard mở được khi truy cập trực tiếp hay tải lại với mã 200; với website có từ trước, bật Fallback cho single-page app trong tab Công cụ. Ảnh, CSS và JavaScript bị thiếu vẫn trả 404.

Với app TanStack Start, ZoPanel 0.4.35 trở lên nhận diện được TanStack Start: lệnh build chạy với NITRO_PRESET=node-server (nếu bạn tự đặt NITRO_PRESET trong Environment variables thì giá trị của bạn được dùng) và app khởi động bằng node .output/server/index.mjs, hoặc script start của project. Bấm Analyze repository để kiểm tra trước lần deploy đầu; nếu project thiếu Nitro, phần nhận diện sẽ báo. Với ZoPanel cũ hơn, tắt Auto-detect trong Build & run, đặt Type là Server app (process), Build command npm run build, Start command node .output/server/index.mjs và thêm NITRO_PRESET=node-server trong Environment variables. Cách nào thì ZoPanel cũng tự đặt PORT và HOST=127.0.0.1 cho server Nitro, và chỉ chuyển traffic khi Health check path trả lời dưới mã 500 trong 90 giây.

Hai chi tiết áp dụng cho cả hai loại: nếu repository chỉ có bun.lock, ZoPanel cài bằng npm install; và muốn cố định Node 22 thì thêm file .nvmrc có nội dung 22. ZoPanel không có CDN toàn cầu hay preview deployment, và server là của bạn, bạn tự bảo trì. Trang vibe coding tóm tắt quy trình, còn gói Free dùng được cho 10 website.

Kết luận

Chuyển app Lovable lên VPS xoay quanh ba quyết định: bạn có stack nào (Vite tĩnh hay server TanStack Start), backend nằm ở đâu (thường là cứ để trên Lovable Cloud hoặc Supabase đã), và deploy diễn ra thế nào (webhook trên branch Lovable đồng bộ). Làm đúng biến VITE_, fallback SPA và redirect URL đăng nhập là phần còn lại chỉ còn là hosting bình thường.

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

Đồng bộ GitHub của Lovable có dùng được ở gói miễn phí không?

Có. Tài liệu Lovable ghi đồng bộ với github.com có ở mọi gói. GitHub Enterprise Cloud có data residency và GitHub Enterprise Server thì cần gói Enterprise.

Có kết nối Lovable với repository GitHub có sẵn được không?

Không. Đồng bộ Git luôn tạo repository mới. Muốn bắt đầu từ code có sẵn, Lovable gợi ý tải code đó về dạng ZIP, import vào một project mới rồi mới kết nối đồng bộ Git.

Sửa code trên GitHub có làm hỏng project Lovable không?

Không, vì đồng bộ là hai chiều: thay đổi push lên branch đang dùng sẽ được đồng bộ ngược vào Lovable. Nếu mỗi bên có commit mà bên kia không có, Lovable sẽ đẩy thay đổi của nó sang branch lovable-sync.

Key Supabase hiện trên trình duyệt có an toàn không?

Publishable key (hoặc anon key kiểu cũ) vốn để công khai, nhưng chỉ an toàn khi đã bật Row Level Security với policy đúng. Secret key hay service_role không bao giờ được nằm ở front end.

Vì sao tải lại một trang của app Lovable thì bị 404?

App Vite xử lý routing trên trình duyệt, nên server phải trả index.html cho các đường dẫn không có file. Thêm try_files $uri $uri/ /index.html; vào nginx, hoặc thiết lập tương đương trên hosting của bạn.

Tự host rồi có còn phải trả tiền Lovable không?

Tùy bạn giữ lại gì ở đó. Host front end ở nơi khác không làm mức dùng backend trên Lovable Cloud ngừng tính vào credit của Lovable, nên nếu backend vẫn ở đó thì bạn vẫn dùng Lovable cho phần đó.