Cách đưa website lên mạng cho người mới: từ máy tính tới link HTTPS
Để đưa website đang chạy trên máy lên mạng, bạn cần một nơi chạy nó liên tục và một địa chỉ để người khác truy cập. Cách đơn giản nhất cho người mới: đẩy code lên GitHub hoặc chạy lệnh zo deploy trong thư mục dự án, ZoCloud tự build và trả về một link HTTPS dạng https://web-shop.zocloud.app. Khi cần, bạn gắn thêm tên miền riêng như shopcuatoi.vn.
Bài này giải thích từng khái niệm cần biết, rồi đi qua các bước cụ thể.
Vì sao web chạy trên máy mà người khác không mở được
Khi bạn chạy npm run dev hay mở file index.html, website chỉ chạy trên máy của bạn, ở địa chỉ như http://localhost:5173. "localhost" nghĩa là "chính máy này", nên người khác gõ địa chỉ đó sẽ không thấy gì. Tắt máy là web cũng tắt.
Để web "lên mạng", cần ba thứ:
- Một máy chủ chạy 24/7 có kết nối Internet, giữ code và chạy nó.
- Một địa chỉ công khai (tên miền) trỏ về máy chủ đó.
- HTTPS, để trình duyệt không báo "không an toàn" và dữ liệu được mã hoá.
Bạn có thể thuê VPS rồi tự cài mọi thứ, nhưng với người mới, một nền tảng deploy (PaaS) làm hộ phần máy chủ, địa chỉ và HTTPS. Nếu đang phân vân, xem nên dùng VPS hay PaaS.
Website của bạn thuộc loại nào?
Trước khi deploy, hãy xác định web của bạn là loại nào, vì cách chạy khác nhau.
| Loại | Ví dụ | Khi lên mạng cần gì |
|---|---|---|
| Site tĩnh | Trang giới thiệu bằng HTML/CSS, landing page, app React/Vue build bằng Vite | Chỉ cần phục vụ file; không có code chạy phía máy chủ |
| App có backend | Node.js (Express, Next.js), Python (FastAPI, Django), PHP (Laravel) | Một chương trình chạy liên tục, thường kèm database, biến môi trường |
Mẹo nhận biết: nếu web của bạn cần đăng nhập, lưu dữ liệu, gửi e-mail hay gọi API với khoá bí mật, gần như chắc chắn bạn có (hoặc cần) backend. Một số app React lại gọi thẳng dịch vụ bên ngoài như Supabase từ trình duyệt, nên vẫn là site tĩnh dù có đăng nhập.
Tin tốt: trên ZoCloud bạn không phải tự chọn. ZoCloud đọc thư mục dự án và tự nhận diện:
- Có
index.htmlở gốc: phục vụ thành site tĩnh. - Dự án Vite (React, Vue, Svelte) không có script
start: build rồi phục vụ thư mụcdistthành site tĩnh, các đường dẫn như/gioi-thieuvẫn trả về app (hợp với React Router). - Next.js, Node.js, Python, Go, PHP: build và chạy như một server.
Muốn xem trước ZoCloud sẽ làm gì, chạy zo detect trong thư mục dự án.
Cách 1: Đưa website lên mạng từ GitHub
Đây là cách nên dùng lâu dài: mỗi lần bạn sửa code và push, web tự cập nhật.
Bước 1: Đưa code lên GitHub
Nếu chưa có repo, tạo repo mới trên GitHub rồi trong thư mục dự án:
git init
git add .
git commit -m "Phiên bản đầu tiên"
git branch -M main
git remote add origin https://github.com/ten-ban/website.git
git push -u origin main
Kiểm tra file .gitignore có node_modules và .env để không đẩy thư viện và mật khẩu lên GitHub.
Bước 2: Tạo tài khoản và project trên ZoCloud
- Đăng ký ZoCloud và xác minh e-mail. Tổ chức mới 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), bấm Tạo.
Bước 3: Kết nối GitHub và deploy
- Mục GitHub của tổ chức → Kết nối GitHub, cài ZoCloud cho repo vừa tạo. ZoCloud chỉ đọc mã nguồn, không ghi.
- Trên canvas của project, Thêm → Từ repo GitHub, chọn repo.
- Kiểm tra Tên service (ví dụ
web) và Nhánh (main). Nếu web nằm trong thư mục con, điền Thư mục gốc. - Bấm Tạo và deploy.
Vài phút sau, bạn có địa chỉ https://web-shop.zocloud.app. Bật Tự deploy khi push ở tab Cấu hình để mỗi lần push lên main là web tự cập nhật.
Repo công khai thì có thể dán thẳng URL Git, không cần kết nối GitHub, nhưng khi đó không tự deploy khi push.
Cách 2: Đưa website lên mạng từ thư mục trên máy
Chưa dùng Git? Bạn vẫn deploy được thẳng từ thư mục bằng zo CLI.
Bước 1: Cài zo và đăng nhập
macOS, Linux:
curl -fsSL https://app.zocloud.io/install.sh | sh
zo version
Windows: tải zo.exe ở Tài khoản → mục Deploy từ máy của bạn.
Tạo token ở Tài khoản → Token truy cập → Tạo token, rồi:
zo login # dán token khi được hỏi
zo whoami # xem tên tổ chức của bạn
Bước 2: Deploy
Trong thư mục dự án:
zo detect # xem ZoCloud sẽ build thế nào
zo deploy -to myorg/shop/web # lần đầu: tạo project, service và deploy
Thay myorg bằng tên tổ chức của bạn. Project và service được tạo tự động nếu chưa có. zo in log build và địa chỉ HTTPS khi xong. Những lần sau, chỉ cần zo deploy.
zo không bao giờ gửi file .env (trừ .env.example), và bỏ qua .git, node_modules cùng các mẫu trong .gitignore. Mật khẩu, khoá API đặt bằng zo vars (xem bên dưới).
App có backend: thêm database và biến môi trường
Nếu web của bạn lưu dữ liệu, bạn cần database. Trên ZoCloud có PostgreSQL, MySQL (MariaDB) và Redis (Valkey), sao lưu mỗi đêm.
Trên canvas: Thêm → chọn engine dưới mục Database, đặt tên (ví dụ pg), bấm Tạo. Rồi ở tab Biến môi trường của service, thêm:
DATABASE_URL=${{pg.DATABASE_URL}}
Hoặc bằng CLI:
zo db create pg -engine postgres
zo vars set 'DATABASE_URL=${{pg.DATABASE_URL}}'
zo deploy
Biến môi trường có hiệu lực từ lần deploy sau, nên nhớ deploy lại. Chi tiết về biến xem biến môi trường và file .env; ví dụ đầy đủ một app có database xem deploy Node.js có PostgreSQL.
Một lưu ý quan trọng cho app có server: app phải nghe trên 0.0.0.0 và cổng trong biến PORT do ZoCloud đặt, ví dụ với Express:
app.listen(process.env.PORT || 3000, "0.0.0.0");
Gắn tên miền riêng cho website
Địa chỉ ….zocloud.app đủ để chia sẻ và thử nghiệm. Khi muốn khách thấy shopcuatoi.vn, bạn cần:
- Có tên miền: mua ngay trong mục Tên miền của ZoCloud, hoặc dùng tên đã mua ở nơi khác. Xem mua tên miền .vn.
- Gắn vào service: tab Tên miền của service → nhập
www.shopcuatoi.vn→ Thêm. CLI:zo domains add www.shopcuatoi.vn. - Trỏ DNS: tên con như
wwwdùng bản ghiCNAMEvề<service>-<project>.zocloud.app; tên gốc dùng bản ghiAvề các IP mà portal hiện. Tên miền mua tại ZoCloud hoặc dùng ZoCloud DNS thì bản ghi được tạo tự động.
ZoCloud kiểm tra DNS mỗi phút. Khi DNS đúng, chứng chỉ HTTPS được cấp tự động trong vài phút và tự gia hạn, bạn không phải cài gì. Hướng dẫn trỏ chi tiết ở trỏ tên miền về hosting và SSL, HTTPS miễn phí.
Lưu ý: 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) cho tối đa 3 tên miền riêng.
Lỗi hay gặp khi lần đầu đưa web lên mạng
| Hiện tượng | Cách xử lý |
|---|---|
| Build lỗi | Mở tab Deploy xem log build; chạy zo detect trên máy để xem ZoCloud nhận diện ra sao |
| App khởi động rồi thoát | App không nghe 0.0.0.0:$PORT, hoặc thiếu biến môi trường |
| Trang trắng, lỗi kết nối API | Địa chỉ API trong code vẫn là localhost; đổi thành biến môi trường |
| Ảnh, CSS không hiện | Sai đường dẫn (phân biệt chữ hoa, chữ thường trên máy chủ Linux) |
| Tên miền vẫn "chờ DNS" | Bản ghi chưa đúng hoặc DNS chưa cập nhật; kiểm tra lại giá trị portal hiện |
Xem log khi app đang chạy: tab Log trên portal, hoặc zo logs -since 1h.
Chi phí để website chạy trên mạng
Trên ZoCloud, bạn trả bằng ví VND trả trước. Bảng giá theo tháng, chưa gồm VAT 10%:
| Gói | Giá | Đủ cho |
|---|---|---|
| Dùng thử | 0 đ | Thử nghiệm: 2 service, 1 database, 512 MB RAM, chưa có tên miền riêng |
| Hobby | 119.000 đ | Web cá nhân, dự án nhỏ: 5 service, 2 database, 1 GB RAM, 3 tên miền riêng |
| Pro | 499.000 đ | App có người dùng thật: 20 service, 5 database, 4 GB RAM |
Trả theo năm bằng 10 tháng. Tên miền tính riêng theo đuôi. Xem thêm chi phí chạy app vibe coding và hướng dẫn thanh toán.
Chi tiết từng mục ở hướng dẫn app, zo CLI và tên miền.