Hướng Dẫn Tự Host Headless Commerce MedusaJS Trên VPS Kết Hợp NextJS Front End
Đây là hướng dẫn chi tiết về việc tự host nền tảng thương mại điện tử headless sử dụng MedusaJS làm backend và NextJS làm frontend trên VPS. Hướng dẫn bao gồm thiết lập môi trường,...
Nguồn ảnh: wikimedia
Đây là hướng dẫn chi tiết về việc tự host nền tảng thương mại điện tử headless sử dụng MedusaJS làm backend và NextJS làm frontend trên VPS. Hướng dẫn bao gồm thiết lập môi trường, cấu hình cơ sở dữ liệu, triển khai hai phần ứng dụng riêng biệt, kết nối API và bảo mật toàn bộ hệ thống. Người dùng sẽ học cách triển khai một hệ thống thương mại điện tử hiện đại, linh hoạt, dễ mở rộng và kiểm soát hoàn toàn, phù hợp cho doanh nghiệp có nhu cầu phát triển riêng.
Giới thiệu về MedusaJS và NextJS
MedusaJS là một nền tảng thương mại điện tử headless mã nguồn mở, cho phép xây dựng các hệ thống bán hàng linh hoạt bằng cách tách biệt backend (API, quản lý sản phẩm, đơn hàng) khỏi frontend. NextJS là một framework React phổ biến, lý tưởng cho việc xây dựng frontend hiện đại, SEO-friendly và có hiệu suất cao. Kết hợp hai công nghệ này, bạn có thể tạo ra một hệ thống thương mại điện tử toàn diện, với backend được tự quản lý trên VPS và frontend có thể triển khai trên bất kỳ nền tảng nào.
MedusaJS cung cấp các tính năng mạnh mẽ như quản lý sản phẩm, giỏ hàng, thanh toán, đơn hàng và nhiều hơn nữa thông qua một API RESTful mạnh mẽ. NextJS cho phép xây dựng giao diện người dùng tương tác, nhanh chóng và tối ưu hóa SEO. Việc tách biệt frontend và backend giúp mỗi phần có thể được phát triển, thử nghiệm và triển khai độc lập, tăng tốc độ phát triển và cải thiện tính ổn định.
Yêu cầu và Thiết lập VPS
Để bắt đầu, bạn cần một VPS (Virtual Private Server) có tài nguyên đủ mạnh để chạy cả MedusaJS và NextJS. Một VPS NVMe với ít nhất 4GB RAM và 2 CPU là tối thiểu. Bạn có thể chọn một trong các gói VPS từ [Cloud VPS NVMe cho Docker, Nginx & Database](/vi/vps) để đảm bảo hiệu suất tốt cho cả ứng dụng và cơ sở dữ liệu.
Sau khi mua VPS, bạn cần thiết lập hệ điều hành (thường là Ubuntu 20.04 hoặc 22.04), cập nhật hệ thống và tạo một tài khoản người dùng không phải root với quyền sudo. Bạn cũng cần thiết lập tường lửa (ufw) và SSH key để tăng cường bảo mật.
Đối với việc triển khai, bạn sẽ cần cài đặt các công cụ sau:
- Node.js (v16 hoặc mới hơn)
- Yarn hoặc npm
- PostgreSQL hoặc MySQL
- Docker (tùy chọn, nhưng rất hữu ích)
- Nginx (để làm reverse proxy và SSL)
Thiết lập cơ sở dữ liệu là bước quan trọng. Bạn có thể cài PostgreSQL trực tiếp trên VPS hoặc sử dụng một dịch vụ cơ sở dữ liệu riêng biệt. Dưới đây là một ví dụ về việc tạo cơ sở dữ liệu PostgreSQL:
sudo -u postgres psql
CREATE DATABASE medusa_db;
CREATE USER medusa_user WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE medusa_db TO medusa_user;
Triển khai MedusaJS Backend
Để triển khai MedusaJS, bạn cần tạo một dự án mới. Sử dụng CLI của Medusa để tạo dự án:
medusa new my-commerce-project --store-url=http://localhost:8080 --admin-url=http://localhost:7000
Điều này sẽ tạo ra một dự án MedusaJS với cấu hình mặc định. Bạn cần chỉnh sửa file `.env` để cấu hình kết nối đến cơ sở dữ liệu PostgreSQL đã tạo ở bước trước:
MEDUSA_DATABASE_URL=postgres://medusa_user:your_secure_password@localhost:5432/medusa_db
Sau khi cấu hình xong, bạn có thể khởi chạy MedusaJS bằng lệnh:
cd my-commerce-project
yarn dev
MedusaJS sẽ khởi động trên cổng 7000 (admin) và 8080 (store). Tuy nhiên, để triển khai trên VPS, bạn cần chạy ứng dụng trong môi trường sản xuất. Bạn có thể sử dụng PM2 để quản lý quá trình:
pm2 start yarn --name "medusa" -- start
Triển khai NextJS Frontend
Đối với frontend, bạn cần tạo một dự án NextJS mới. Sử dụng CLI của NextJS:
npx create-next-app@latest my-store
Trong dự án NextJS, bạn cần cài đặt thư viện MedusaJS client để kết nối với API backend:
cd my-store
yarn add @medusajs/medusa-js
Sau đó, tạo một file `lib/medusa.js` để khởi tạo client Medusa:
import { Medusa } from "@medusajs/medusa-js";
const medusa = new Medusa({
baseUrl: "https://your-vps-ip:8080",
maxRetries: 3,
});
export default medusa;
Thay `your-vps-ip` bằng địa chỉ IP của VPS của bạn. Bạn có thể truy cập API của MedusaJS từ frontend nếu đã cấu hình đúng.
Kết nối và Bảo mật
Để kết nối frontend và backend, bạn cần cấu hình Nginx làm reverse proxy. Điều này giúp bạn quản lý cổng và bảo mật kết nối. Dưới đây là một ví dụ về cấu hình Nginx:
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /api {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Để bảo mật, bạn nên sử dụng SSL. Bạn có thể sử dụng Let's Encrypt để cấp phát chứng chỉ SSL miễn phí. Cài đặt Certbot và chạy lệnh sau:
sudo certbot certonly --nginx -d your-domain.com
Chứng chỉ SSL sẽ được tự động cấu hình trong Nginx. Bạn cũng nên cấu hình tường lửa để chỉ mở các cổng cần thiết (80, 443, 22).
Xác minh và Khắc phục sự cố
Để xác minh rằng hệ thống đang hoạt động, hãy kiểm tra các bước sau:
- Truy cập `http://your-vps-ip:8080` để xem API MedusaJS có trả về dữ liệu không.
- Truy cập `http://your-vps-ip:3000` để xem frontend NextJS đang chạy.
- Chạy lệnh `pm2 status` để kiểm tra trạng thái của MedusaJS.
- Kiểm tra log của MedusaJS và NextJS để tìm lỗi.
Nếu gặp sự cố, hãy kiểm tra:
- Chứng chỉ SSL và cấu hình Nginx.
- Địa chỉ IP và cổng trong file `.env`.
- Quyền truy cập cơ sở dữ liệu.
- Trạng thái dịch vụ PM2.
Tài liệu tham khảo
Để tìm hiểu thêm về MedusaJS, bạn có thể tham khảo tài liệu chính thức: [MedusaJS Documentation](https://docs.medusajs.com/). Để tìm hiểu về NextJS, hãy xem tài liệu tại: [NextJS Documentation](https://nextjs.org/docs).
Tham khảo hạ tầng & bài viết liên quan: Cloud VPS NVMe cho Docker, Nginx & Database · Hướng Dẫn Tự Host Excalidraw Trên Docker VPS Làm Chu Nền Tảng Vẽ Sơ Đồ Và Công Tác Nội Bộ Cho Doanh Nghiệp
Cấu hình Cloud VPS NVMe khuyến nghị để triển khai
SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
