Hướng dẫn toàn diện deploy ứng dụng Node.js/Next.js trên VPS với Docker và Nginx reverse proxy
Hướng dẫn chi tiết cách triển khai ứng dụng Node.js/Next.js trên VPS sử dụng Docker và Nginx làm reverse proxy, bao gồm cấu hình, tối ưu và bảo mật.
Giới thiệu
Việc triển khai ứng dụng Node.js hoặc Next.js lên VPS là một bước quan trọng trong quá trình phát triển phần mềm hiện đại. Sử dụng Docker cùng Nginx làm reverse proxy giúp bạn dễ dàng quản lý, triển khai và bảo mật ứng dụng. Hướng dẫn này sẽ hướng dẫn bạn từng bước triển khai một ứng dụng Node.js/Next.js trên VPS với Docker và Nginx, đảm bảo hiệu suất và tính ổn định cao.
Yêu cầu tiên quyết
- Một VPS (Cloud VPS NVMe cho Docker, Nginx & Database) với hệ điều hành Linux (Ubuntu 20.04/22.04 được khuyến nghị).
- Access SSH vào VPS (thường qua SSH key).
- Node.js và npm đã cài đặt trên VPS.
- Docker và Docker Compose đã được cài đặt.
- Ngữ cảnh ứng dụng: Node.js hoặc Next.js (tối thiểu 12.0, khuyến nghị 16.0 trở lên).
- Biết cách tạo và quản lý file cấu hình Nginx.
Chuẩn bị và triển khai ứng dụng
Trước tiên, bạn cần tạo một thư mục cho ứng dụng và cấu hình Docker.
1. Tạo thư mục và cấu hình ứng dụng
Giả sử bạn đang triển khai một ứng dụng Next.js. Tạo thư mục:
mkdir my-nextjs-app
cd my-nextjs-app
Tạo file next.config.js nếu cần tùy chỉnh (ví dụ: cấu hình port):
module.exports = {
port: 3000,
};
2. Tạo Dockerfile
Tạo file Dockerfile trong thư mục dự án:
FROM node:16-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]
3. Tạo docker-compose.yml
Tạo file docker-compose.yml:
version: '3.8'
services:
app:
build: .
ports:
- "3000:3000"
restart: unless-stopped
environment:
- NODE_ENV=production
volumes:
- ./app:/app
- ./node_modules:/app/node_modules
Cấu hình Nginx làm reverse proxy
Nginx sẽ nhận request từ bên ngoài, chuyển tiếp đến container ứng dụng chạy trên port 3000.
1. Cài đặt Nginx
sudo apt update
sudo apt install nginx -y
2. Tạo file cấu hình Nginx
Tạo file cấu hình trong /etc/nginx/sites-available/myapp:
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;
}
# Optional: Redirect HTTP to HTTPS
# return 301 https://$host$request_uri;
}
3. Kích hoạt cấu hình
sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Khởi chạy ứng dụng
Trong thư mục dự án, chạy:
docker-compose up -d
Ứng dụng sẽ được xây dựng, chạy và được truy cập qua Nginx tại http://your-domain.com.
Kiểm tra và xác minh
- Thực hiện kiểm tra trạng thái Docker:
docker-compose ps - Truy cập trang web để kiểm tra ứng dụng hoạt động:
curl -I http://your-domain.com - Xem log:
docker-compose logs -f app
Giải quyết sự cố
- Không truy cập được ứng dụng: Kiểm tra Nginx có chạy không:
sudo systemctl status nginx. Kiểm tra file cấu hình có lỗi không:sudo nginx -t. - Docker không xây dựng ứng dụng: Kiểm tra Dockerfile có lỗi cú pháp không. Kiểm tra file
package.jsoncó đầy đủ dependencies không. - Ứng dụng chạy nhưng không phản hồi: Kiểm tra port trong Dockerfile và docker-compose.yml có khớp không. Kiểm tra môi trường (NODE_ENV) có đúng không.
Tối ưu và bảo mật
- Đặt
HTTPSbằng Let's Encrypt: Sử dụngcertbothoặcnginx-letsencrypt. - Thêm
rate limitingtrong Nginx để chống DDoS. - Chạy Docker dưới user không phải root.
- Log và giám sát ứng dụng bằng
docker logshoặc công cụ nhưELK.
Tài liệu tham khảo
- Cloud VPS NVMe cho Docker, Nginx & Database
- Hướng dẫn chọn thuê VPS tối ưu cho nhu cầu và ngân sách
- Hướng dẫn chuyển từ shared hosting sang VPS: lộ trình 7 ngày cho người không chuyên
Chúc bạn triển khai thành công ứng dụng Node.js/Next.js trên VPS với Docker và Nginx!
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
