Hướng dẫn Deploy dự án Next.js lên VPS từ A-Z với PM2, Nginx và SSL miễn phí

# 1. Cập nhật package hệ thống & cài công cụ cần thiết
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ufw nginx

# 2. Cài đặt NVM (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 3. Kích hoạt NVM cho session hiện tại
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"

# 4. Cài đặt phiên bản Node.js LTS mới nhất (v20 hoặc v22)
nvm install --lts
nvm use --lts
node -v # Kiểm tra phiên bản node
npm -v  # Kiểm tra npm

# 5. Cài đặt pnpm và PM2 toàn cục (không cần sudo)
npm install -g pnpm pm2

# Cho phép SSH và Nginx
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'

# Bật tường lửa
sudo ufw enable
sudo ufw status

# Tạo thư mục và cấp quyền
sudo mkdir -p /var/www/my-nextjs-app
sudo chown -R $USER:$USER /var/www/my-nextjs-app

# Clone dự án từ GitHub
git clone https://github.com/username/my-nextjs-app.git /var/www/my-nextjs-app
cd /var/www/my-nextjs-app

# Tạo file biến môi trường .env.production
nano .env.production

# Cài đặt dependencies và build
pnpm install
pnpm build

module.exports = {
  apps: [
    {
      name: "my-nextjs-app",
      script: "node_modules/next/dist/bin/next",
      args: "start -p 3000",
      cwd: "/var/www/my-nextjs-app",
      instances: "max", // Chạy dạng cluster tận dụng đa nhân CPU
      exec_mode: "cluster",
      env: {
        NODE_ENV: "production",
        PORT: 3000,
      },
      max_memory_restart: "800M",
    },
  ],
};

# Khởi động ứng dụng
pm2 start ecosystem.config.js

# Lưu danh sách tiến trình
pm2 save

# Tạo script startup khi boot VPS
pm2 startup

server {
    listen 80;
    server_name duynoa.com www.duynoa.com;

    # Cấu hình proxy sang Next.js Node server
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        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;
    }

    # Cache file tĩnh Next.js tĩnh dài hạn
    location /_next/static {
        alias /var/www/my-nextjs-app/.next/static;
        expires 365d;
        access_log off;
    }
}

# Tạo symbolic link
sudo ln -s /etc/nginx/sites-available/my-nextjs-app /etc/nginx/sites-enabled/

# Kiểm tra cú pháp cấu hình
sudo nginx -t

# Khởi động lại Nginx
sudo systemctl restart nginx

# Cài đặt Certbot và plugin Nginx
sudo apt install -y certbot python3-certbot-nginx

# Yêu cầu cấp chứng chỉ SSL cho domain
sudo certbot --nginx -d duynoa.com -d www.duynoa.com

# Kiểm tra tính năng tự động gia hạn
sudo systemctl status certbot.timer

name: Deploy Next.js to VPS

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy qua SSH
        uses: appleboy/ssh-action@v1.0.3
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USERNAME }}
          key: ${{ secrets.VPS_SSH_KEY }}
          script: |
            # Load NVM vào session SSH
            export NVM_DIR="$HOME/.nvm"
            [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

            cd /var/www/my-nextjs-app
            git pull origin main
            pnpm install --frozen-lockfile
            pnpm build
            pm2 reload my-nextjs-app --update-env