Deploy Node.js lên shared hosting cPanel trước đây là một trải nghiệm khá khổ: vào Setup Node.js App, tự chọn version, tự trỏ startup file, tự chạy npm install, app chết thì tự vào restart. Nhiều người bỏ cuộc và chuyển sang VPS chỉ vì một app nhỏ.
AI App Hosting trong cPanel Meridian làm lại toàn bộ luồng này. Bạn đưa code vào bằng Git, ZIP hoặc để AI agent đẩy lên qua MCP. Meridian tự build, cài đặt lên một domain có sẵn HTTPS và giữ cho tiến trình luôn chạy. Tên gọi "AI App Hosting" cũng nói rõ đối tượng: những app được dựng bằng AI coding tool như Claude Code, Cursor cần một chỗ deploy nhanh, dù app viết tay cũng dùng y như vậy.
Điều cần biết trước khi deploy
- Tính năng chỉ hiện khi nhà cung cấp hosting bật Node.js trên Meridian.
- Mỗi tài khoản cPanel chạy tối đa 4 app cùng lúc. Chạm giới hạn thì phải xóa một app mới deploy được app khác.
- Deploy app sẽ chuyển domain từ chế độ phục vụ file sang phục vụ app. Nếu dùng domain đang có sẵn, file cũ vẫn còn nhưng nội dung hiển thị là của app.
- Nếu tạo domain mới trong lúc deploy, bạn không đổi tên domain đó được sau khi deploy. Kiểm tra chính tả trước khi bấm.
Các bước deploy Node.js trên cPanel Meridian
- Vào hub Websites, bấm Add Website.
- Chọn domain có sẵn rồi Continue, hoặc chọn Add another domain, nhập domain mới rồi Continue.
- Chọn AI App Hosting, bấm Continue.
- Bấm Launch My Website.
- Chọn nguồn code: Git repository, Upload a ZIP file hoặc Deploy via WebPros MCP (chi tiết bên dưới).
- Kiểm tra hoặc sửa Website Name cho URL của app.
- Tùy chọn: mở phần Advanced để chọn Node.js version, xem Package manager và build output directory mà Meridian phát hiện được, thêm Environment variables app cần lúc chạy.
- Bấm Deploy.
Meridian cài dependencies, deploy và khởi động app. Sau đó bạn quản lý app ngay trong hub Websites.
Cách 1: Deploy từ Git repository
Đây là cách nên dùng cho mọi app còn phát triển tiếp, vì Git cho phép redeploy hoặc rollback thay đổi gần nhất một cách dễ dàng.
- Repo public: nhập HTTPS clone URL, ví dụ https://example.com/user/my-app.git
- Repo private: nhập SSH clone URL, ví dụ [email protected]:user/my-app.git
Với SSH URL, Meridian dẫn bạn gắn SSH key để nó truy cập được repo:
- Chọn key có sẵn trong menu SSH key. Nếu chưa có, bấm Manage SSH keys in Security để tạo key mới rồi quay lại deploy.
- Cấp quyền cho key trên Git host của bạn, thường gọi là deploy key (GitHub, GitLab, Bitbucket đều có).
- Nếu key có passphrase, nhập khi được hỏi. Bạn sẽ phải nhập lại mỗi lần redeploy.
- Bấm Continue rồi Deploy.
Mẹo: dùng deploy key ở chế độ read-only và tạo riêng cho từng repo. Lỡ hosting có sự cố thì key đó cũng không ghi được gì vào source của bạn.
Nếu deploy lỗi, Meridian hiển thị lý do cụ thể: thiếu quyền SSH, host key chưa được tin cậy, cần credentials HTTPS, hoặc sai passphrase. Sửa rồi chạy lại.
Cách 2: Upload file ZIP
Hợp với app tĩnh bạn không định thay đổi. Chọn Upload a ZIP file, kéo file .zip vào vùng upload hoặc bấm Browse Files, rồi Continue. Nhanh cho demo, landing page build sẵn, hoặc bản bàn giao cho khách.
Cách 3: Để AI agent deploy qua WebPros MCP
- Chọn Deploy via WebPros MCP.
- Nếu chưa liên kết tài khoản WebPros, bấm Link WebPros Account và làm theo hướng dẫn trên trình duyệt. Xem bài kết nối cPanel với MCP.
- Bấm Download mcp.json, thêm vào AI client của bạn và xác nhận kết nối.
- Yêu cầu agent deploy, ví dụ:
Using the webpros-mcp connector, deploy the Node.js app in this project to my cPanel account and give me the live HTTPS URL once it's reachable.Đây là mảnh ghép làm nên chữ "AI" trong tên tính năng: bạn vibe code một app trong Claude Code, xong gõ thêm một câu là app có URL HTTPS chạy thật.
So sánh 3 cách deploy
| Cách | Hợp với | Redeploy, rollback | Độ khó |
|---|---|---|---|
| Git repository | App còn phát triển, làm việc nhóm | Có, dễ | Trung bình (repo private cần SSH key) |
| ZIP | App tĩnh, demo, bàn giao một lần | Upload lại thủ công | Thấp |
| WebPros MCP | Người code cùng AI agent | Ra lệnh cho agent | Thấp sau khi đã kết nối MCP |
Lỗi hay gặp
- Build thành công nhưng deploy vẫn fail: app không sinh ra output directory. Meridian báo tên thư mục còn thiếu. Kiểm tra script build trong package.json và tự nhập build output directory ở phần Advanced nếu Meridian không tự nhận diện được.
- Thiếu biến môi trường: app chạy local ngon nhưng lên host thì crash, thường do .env không nằm trong repo. Khai báo ở Environment variables.
- Sai Node.js version: chọn đúng major version app yêu cầu trong phần Advanced.
Shared hosting cPanel hay VPS cho app Node.js?
Nói thật để bạn chọn đúng: AI App Hosting hợp với app nhỏ và vừa như landing page Next.js, dashboard nội bộ, API nhẹ, MVP để test thị trường. Giới hạn 4 app mỗi tài khoản và tài nguyên theo gói hosting là trần của nó. Nếu app cần WebSocket tải cao, worker chạy nền, Redis hay Docker thì VPS vẫn là lựa chọn đúng. Mình đã so sánh kỹ các phương án ở bài Node.js hosting: 5 phương án từ free đến pro.
Tổng quan các tính năng AI khác của cPanel xem ở bài cPanel AI-native: định hướng mới của cPanel.
Câu hỏi thường gặp
App có tự chạy lại khi bị crash không?
Theo tài liệu cPanel, Meridian giữ tiến trình app luôn chạy cho bạn sau khi deploy, bạn không phải tự quản process manager.
Có HTTPS sẵn không?
Có. Meridian build và cài app lên domain với website HTTPS.
Deploy được framework nào?
Tài liệu không giới hạn framework cụ thể. Meridian phát hiện package manager và thư mục build output từ build tool hoặc script của bạn, nên các project Node.js có script build chuẩn đều đi theo cùng một luồng.
Trải nghiệm trên NVMe cPanel Hosting của TND
Hosting của bên mình chạy cPanel bản quyền đầy đủ trên LiteSpeed Enterprise, ổ U.2 NVMe chuẩn doanh nghiệp và CPU xung nhịp cao, datacenter Hà Nội và Hải Phòng, Free SSL, backup hằng ngày, quét malware tự động, gói từ 136K/tháng đã gồm VAT. Ổ NVMe và CPU xung cao giúp bước build và cài dependencies chạy nhanh hơn thấy rõ.
Nói rõ để bạn khỏi mua nhầm: các tính năng trong Meridian chỉ hiện khi được bật theo gói và theo lộ trình cập nhật cPanel. Nếu bạn cần đúng một tính năng cụ thể, gọi hotline 0225.999.6666 hoặc gửi ticket để bên mình xác nhận tình trạng trên gói bạn định mua trước khi thanh toán.
