Quay lại danh sách
DevOps & Hệ thống

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.

DPTCloud Engineering4 phút đọc
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

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.json có đầ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 HTTPS bằng Let's Encrypt: Sử dụng certbot hoặc nginx-letsencrypt.
  • Thêm rate limiting trong 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 logs hoặc công cụ như ELK.

Tài liệu tham khảo

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!

Hạ tầng DPTCloud Tier III

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%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478