Deploy ứng dụng vibe-code với Cloudflare: Hướng dẫn từ A đến Z

Bạn vừa “vibe code” ra một ứng dụng chạy ngon trên máy. Vậy, câu hỏi tiếp theo luôn là: đưa nó lên Internet ở đâu, rẻ, nhanh và không bị lộ dữ liệu? Câu trả lời ngắn gọn của bài này: Cloudflare Workers cùng hệ sinh thái đi kèm, với gói miễn phí đủ cho hầu hết các sản phẩm MVP.

Vì sao Cloudflare hợp với app Vibe-code

Vibe coding là cách làm phần mềm bằng cách mô tả ý tưởng bằng ngôn ngữ tự nhiên để AI viết code, còn người làm tập trung vào việc thử, chỉnh và định hướng. Vì vậy, Cách làm này giúp ra sản phẩm rất nhanh, nhưng thường vấp ở khâu cuối: hosting, database, tên miền, bảo mật.

Cloudflare giải quyết gần trọn khâu đó:

  • Một nơi cho tất cả: frontend, API, database, lưu file, AI và tên miền đều nằm chung trong một dashboard, được khai báo trong một file cấu hình.
  • Miễn phí rộng rãi: phục vụ file tĩnh không giới hạn băng thông, 100.000 request động mỗi ngày ở gói Free.
  • Nhanh toàn cầu: code chạy trên mạng edge của Cloudflare, gần người dùng ở cả Việt Nam lẫn nước ngoài.
  • AI dễ làm theo: công cụ dòng lệnh Wrangler và file cấu hình rõ ràng nên các AI coding agent viết cấu hình và deploy khá chính xác.

Lưu ý quan trọng năm 2026: Cloudflare hiện khuyến nghị dự án mới dùng Workers với static assets thay vì Cloudflare Pages. Pages vẫn hoạt động, nhưng tính năng mới gần như chỉ có trên Workers. Bài viết này đi theo hướng Workers.

Bản đồ dịch vụ Cloudflare

Bạn không cần dùng hết các dịch vụ của Cloudflare. Chỉ một app vibe-code điển hình chỉ cần một Worker làm trung tâm, cộng vài dịch vụ gắn vào khi cần.

Người dùng đi qua lớp bảo vệ của Cloudflare, tới Worker; Worker trả giao diện hoặc xử lý API rồi đọc ghi dữ liệu qua binding.

Dịch vụVai tròDùng khi
Workers + static assetsHost giao diện và chạy code backendLuôn cần, là nền tảng của mọi app
D1Database SQL (SQLite)Có người dùng, bài viết, đơn hàng…
KVKho key-value đọc nhanhCache, cấu hình, feature flag
R2Lưu file dạng objectẢnh, tài liệu người dùng tải lên
Workers AI / AI GatewayChạy hoặc quản lý lời gọi mô hình AIApp có chatbot, tóm tắt, sinh nội dung
TurnstileCAPTCHA miễn phí, không bắt chọn ảnhForm đăng ký, liên hệ, endpoint AI
Access (Zero Trust)Khoá trang bằng đăng nhậpTrang admin, bản staging
DNS, CDN, SSLTên miền, tăng tốc, HTTPSKhi gắn tên miền riêng

Chuẩn bị trước khi deploy

Bạn cần bốn thứ, mất khoảng 15 phút:

  1. Tài khoản Cloudflare miễn phí tại dash.cloudflare.com.
  2. Node.js bản LTS trên máy.
  3. Wrangler, công cụ dòng lệnh của Cloudflare. Cài trong project và đăng nhập:
npm install -D wrangler
npx wrangler login
  1. Code đã đẩy lên GitHub hoặc GitLab, để bật deploy tự động ở bước sau.

Nếu bắt đầu project mới, cách nhanh nhất là dùng bộ khởi tạo chính thức. Vậy nên, hỏi bạn chọn framework (React, Vue, Astro, Next.js, Hono…) và sinh sẵn file cấu hình:

npm create cloudflare@latest ten-app-cua-ban

Nếu đã có app do AI viết sẵn, chỉ cần thêm file wrangler.jsonc ở thư mục gốc như phần dưới.

Deploy từng bước theo 3 kịch bản

Phần lớn app vibe-code rơi vào một trong ba dạng dưới đây. Hãy xác định app của bạn thuộc dạng nào trước khi làm.

Kịch bản 1: App chỉ có giao diện (React/Vue SPA, landing page)

Đây là dạng phổ biến nhất khi dùng Bolt, Lovable hay v0: chạy npm run build ra thư mục dist. Tạo file wrangler.jsonc:

{
  "name": "my-vibe-app",
  "compatibility_date": "2026-09-01",
  "assets": {
    "directory": "./dist",
    "not_found_handling": "single-page-application"
  }
}

Dòng not_found_handling giúp các đường dẫn như /dashboard không bị lỗi 404 khi người dùng tải lại trang. Deploy:

npm run build
npx wrangler deploy

Vài giây sau bạn có link dạng my-vibe-app.<tài-khoản>.workers.dev. Request tới file tĩnh không bị tính phí và không tính vào hạn mức.

Kịch bản 2: App full-stack có API riêng

Khi app cần lưu dữ liệu, gọi AI hay giấu API key, bạn thêm một Worker làm backend. Hono là framework nhẹ, AI viết rất thạo:

// worker/index.ts
import { Hono } from "hono";

const app = new Hono<{ Bindings: Env }>();

app.get("/api/hello", (c) => c.json({ message: "Xin chào từ edge!" }));

export default app;

Bổ sung vào wrangler.jsonc:

{
  "name": "my-vibe-app",
  "main": "./worker/index.ts",
  "compatibility_date": "2026-09-01",
  "assets": {
    "directory": "./dist",
    "not_found_handling": "single-page-application",
    "run_worker_first": ["/api/*"]
  }
}

Cấu hình này nghĩa là: mọi đường dẫn /api/* do Worker xử lý, còn lại trả về giao diện. Frontend và backend chạy chung một domain nên không phải đau đầu với CORS.

Kịch bản 3: Framework có server (Next.js, Astro, Nuxt, SvelteKit)

  • Astro, Nuxt, SvelteKit, React Router: cài adapter Cloudflare chính thức của framework, rồi npx wrangler deploy.
  • Next.js: dùng adapter OpenNext (@opennextjs/cloudflare). Cách nhanh nhất là chạy npm create cloudflare@latest -- --framework=next để có cấu hình chuẩn, sau đó chép code của bạn vào.

Lưu ý với Next.js: gói Free giới hạn kích thước Worker khoảng 3 MB sau nén. App Next.js lớn có thể vượt mức này và cần gói Paid 5 USD/tháng.

Chạy thử trên máy trước khi deploy

Lệnh npx wrangler dev mô phỏng gần như đầy đủ môi trường Cloudflare, kể cả database và lưu trữ, ngay trên máy bạn. Hãy luôn chạy lệnh này trước mỗi lần deploy.

Gắn database và lưu trữ

Cloudflare kết nối Worker với dịch vụ qua binding: khai báo một lần trong wrangler.jsonc, sau đó gọi trong code qua env.TEN_BINDING. Không có chuỗi kết nối, không có mật khẩu database nằm trong code.

D1: database SQL

npx wrangler d1 create my-app-db

Lệnh trả về database_id, dán vào cấu hình:

"d1_databases": [
  { "binding": "DB", "database_name": "my-app-db", "database_id": "<id-vừa-tạo>" }
]

Tạo bảng bằng file migration rồi áp dụng lên bản thật:

npx wrangler d1 migrations create my-app-db init
npx wrangler d1 migrations apply my-app-db --remote

Truy vấn trong Worker, luôn dùng tham số ? để tránh SQL injection:

const { results } = await c.env.DB
  .prepare("SELECT * FROM todos WHERE user_id = ?")
  .bind(userId)
  .all();

KV: cache và cấu hình

Phù hợp với dữ liệu đọc nhiều, ghi ít: cấu hình, cache kết quả API, feature flag. Tạo bằng npx wrangler kv namespace create CACHE. Đừng dùng KV làm database chính: gói Free chỉ cho 1.000 lượt ghi mỗi ngày.

R2: lưu file và ảnh

Phù hợp với ảnh đại diện, file người dùng tải lên, bản backup. Điểm mạnh lớn nhất của R2 là không tính phí băng thông tải ra. Tạo bằng npx wrangler r2 bucket create my-app-files và khai báo binding r2_buckets tương tự D1.

Workers AI và AI Gateway

Nếu app gọi mô hình AI, bạn có hai lựa chọn: chạy mô hình mã nguồn mở trực tiếp trên Workers AI qua binding ai, hoặc tiếp tục gọi Claude/OpenAI nhưng đi qua AI Gateway để có cache, giới hạn tốc độ và thống kê chi phí.

Mẹo khi làm việc với AI: hãy yêu cầu nó “dùng D1 binding tên DB, viết migration SQL riêng, không dùng ORM nặng”. Nói rõ binding giúp AI tránh tự bịa chuỗi kết nối kiểu PostgreSQL.

Bảo mật: 5 lỗi hay gặp ở app vibe-code

AI viết code chạy được rất nhanh, nhưng ít khi tự nghĩ đến bảo mật nếu bạn không yêu cầu. Đây là những lỗi gặp nhiều nhất và cách xử lý bằng Cloudflare.

Lỗi thường gặpHậu quảCách xử lý trên Cloudflare
API key (OpenAI, Stripe…) nằm trong code frontendAi mở DevTools cũng lấy được key và tiêu tiền của bạnChuyển lời gọi API vào Worker, lưu key bằng npx wrangler secret put OPENAI_API_KEY
Commit file .env hoặc .dev.vars lên GitHubLộ toàn bộ thông tin bí mậtThêm hai file này vào .gitignore; nếu đã lộ thì đổi key ngay
API không kiểm tra đăng nhậpNgười lạ đọc và sửa dữ liệu của người khácKiểm tra token ở mọi route /api/*, lọc dữ liệu theo user_id
Form bị bot spam, endpoint AI bị gọi liên tụcHết hạn mức, hoá đơn AI tăng vọtGắn Turnstile (CAPTCHA miễn phí) và Rate Limiting cho endpoint
Trang admin mở công khaiBị dò mật khẩu, chiếm quyềnChe trang admin bằng Cloudflare Access (Zero Trust), miễn phí tới 50 người dùng

Một lời nhắc nên dán vào cuối mọi prompt khi nhờ AI làm phần backend: “Không để secret ở frontend, mọi route phải kiểm tra quyền, dùng câu truy vấn có tham số.”

Tên miền riêng và deploy tự động

Gắn tên miền

  1. Thêm tên miền vào Cloudflare (mua trực tiếp qua Cloudflare Registrar với giá gốc, hoặc chuyển nameserver từ nhà cung cấp hiện tại).
  2. Khai báo trong wrangler.jsonc:
"routes": [
  { "pattern": "app.tenmien.vn", "custom_domain": true }
]
  1. Chạy npx wrangler deploy. Cloudflare tự tạo bản ghi DNS và chứng chỉ SSL, thường xong trong vài phút.

Bật CI/CD qua Git

Vào Dashboard → Workers & Pages → chọn Worker → Settings → Builds → kết nối repo GitHub/GitLab. Từ đây:

  • Mỗi lần push lên nhánh main, Cloudflare tự build và deploy bản chính thức.
  • Push lên nhánh khác sẽ tạo preview URL riêng để bạn xem thử trước khi gộp vào main.
  • Deploy lỗi? Vào tab Deployments và bấm rollback về bản trước trong vài giây.

Quy trình này rất hợp với vibe coding: nhờ AI làm tính năng mới trên một nhánh, xem preview, ổn mới merge.

Gói Free: giới hạn và khi nào nên nâng cấp

Gói Free đủ cho MVP và app vài nghìn lượt truy cập mỗi ngày. Gói Workers Paid giá 5 USD/tháng gỡ phần lớn giới hạn dưới đây.

Dịch vụHạn mức gói FreeDấu hiệu cần nâng cấp
Static assetsKhông giới hạn request và băng thôngHiếm khi phải nâng cấp
Workers100.000 request/ngày, 10 ms CPU mỗi request, Worker tối đa 3 MBLỗi 1101 hoặc vượt hạn mức vào giờ cao điểm
D15 triệu dòng đọc, 100.000 dòng ghi mỗi ngày; 500 MB mỗi databaseTừ 1/9/2026, truy vấn bị lỗi khi vượt hạn mức ngày
KV100.000 lượt đọc, 1.000 lượt ghi mỗi ngàyGhi gần 1.000 lượt/ngày
R210 GB lưu trữ, không phí băng thông tải raDữ liệu vượt 10 GB

Hai điểm hay bị bỏ qua:

  • 10 ms CPU là thời gian xử lý thật, không tính thời gian chờ database hay gọi API ngoài. Phần lớn API đơn giản dùng chưa tới 5 ms.
  • D1 không còn “mềm” khi vượt mức: từ tháng 9/2026, app trên gói Free sẽ báo lỗi truy vấn tới nửa đêm UTC nếu dùng quá hạn mức ngày. Hãy đặt cảnh báo sử dụng trong Dashboard.

Con số trên đúng tại thời điểm viết; kiểm tra lại trang Limits của Cloudflare trước khi lên kế hoạch.

Nguồn: D1 Limits — Cloudflare Docs, thông báo D1 áp hạn mức gói Free, Cloudflare free tier limits.

Checklist trước khi go-live

  • npx wrangler dev chạy ổn trên máy, không lỗi console
  • Không còn API key nào trong code frontend; mọi secret đã đặt bằng wrangler secret put
  • .env và .dev.vars có trong .gitignore
  • Mọi route /api/* đều kiểm tra đăng nhập và quyền
  • Migration D1 đã chạy với --remote
  • Form và endpoint AI đã có Turnstile hoặc Rate Limiting
  • Trang admin đã che bằng Cloudflare Access
  • Đã gắn tên miền riêng, HTTPS hoạt động
  • Đã kết nối Git để deploy tự động và có preview
  • Đã bật cảnh báo sử dụng cho Workers và D1
  • Đã bật Workers Logs để xem lỗi khi chạy thật

Prompt mẫu để AI chuẩn bị app cho Cloudflare

Hãy chuyển project này để deploy lên Cloudflare Workers với static assets.
- Tạo wrangler.jsonc: assets từ ./dist, SPA fallback, Worker xử lý /api/*.
- Backend dùng Hono trong worker/index.ts.
- Database dùng D1 binding tên DB, viết migration SQL trong thư mục migrations.
- Lưu file bằng R2 binding tên FILES.
- Mọi API key đọc từ env (secret), tuyệt đối không để ở frontend.
- Mọi route /api phải kiểm tra đăng nhập; truy vấn SQL dùng tham số.
- Viết hướng dẫn các lệnh wrangler cần chạy để tạo tài nguyên và deploy.

Kết luận

Vibe coding giúp bạn đi từ ý tưởng tới bản chạy được trong vài giờ; Còn lại, Cloudflare giúp bản đó lên internet trong vài phút, với chi phí bằng 0 ở giai đoạn đầu. Công thức gọn nhất cho đa số app năm 2026 là: Workers + static assets cho giao diện, Hono cho API, D1 cho dữ liệu, R2 cho file, Turnstile và Access cho bảo mật.

Hãy bắt đầu bằng kịch bản 1, deploy thật sớm, rồi thêm database và bảo mật dần theo checklist. Thứ khiến app vibe-code thất bại hiếm khi là hosting, mà thường là một API key bị lộ.