Thiết Lập VPS Thực Sự Hoạt Động: Node.js, PM2, Nginx, và Deploy Không Downtime | Akousa

javascript

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: "myapp",
      script: "node_modules/.bin/next",
      args: "start -p 3002",
      cwd: "/var/www/example.com",
      instances: 2,
      exec_mode: "cluster",
      max_memory_restart: "500M",
      env: {
        NODE_ENV: "production",
        PORT: 3002,
      },
      // Tắt graceful
      kill_timeout: 5000,
      listen_timeout: 10000,
      wait_ready: false,
      // Logging
      log_date_format: "YYYY-MM-DD HH:mm:ss Z",
      error_file: "/var/log/pm2/myapp-error.log",
      out_file: "/var/log/pm2/myapp-out.log",
      merge_logs: true,
      // Tự khởi động lại khi lỗi
      autorestart: true,
      max_restarts: 10,
      min_uptime: "10s",
      // Không watch trong production
      watch: false,
    },
  ],
};

nginx

# /etc/nginx/sites-available/example.com
 
upstream node_app {
    server 127.0.0.1:3002;
    keepalive 64;
}
 
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
 
    # Chuyển hướng tất cả HTTP sang HTTPS
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;
 
    # SSL (quản lý bởi Certbot — các dòng này được thêm tự động)
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
 
    # Header bảo mật
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
 
    # Nén gzip
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_min_length 256;
    gzip_types
        text/plain
        text/css
        text/javascript
        application/javascript
        application/json
        application/xml
        image/svg+xml
        application/wasm;
 
    # Cài đặt proxy
    location / {
        proxy_pass http://node_app;
        proxy_http_version 1.1;
 
        # Header
        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;
 
        # Hỗ trợ WebSocket (nếu cần)
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
 
        # Timeout — rộng rãi nhưng không vô hạn
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
 
        # Buffering — để Nginx xử lý client chậm
        proxy_buffering on;
        proxy_buffer_size 16k;
        proxy_buffers 4 32k;
        proxy_busy_buffers_size 64k;
    }
 
    # Asset tĩnh Next.js — để Nginx phục vụ trực tiếp
    location /_next/static/ {
        alias /var/www/example.com/.next/static/;
        expires 365d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }
 
    # File tĩnh public
    location /static/ {
        alias /var/www/example.com/public/static/;
        expires 30d;
        access_log off;
    }
 
    # Chặn truy cập file ẩn
    location ~ /\. {
        deny all;
        access_log off;
        log_not_found off;
    }
}

bash

#!/bin/bash
# deploy.sh — deploy gần như không downtime
 
set -euo pipefail
 
APP_DIR="/var/www/example.com"
APP_NAME="myapp"
LOG_FILE="/var/log/deploy.log"
HEALTH_URL="http://localhost:3002"
MAX_RETRIES=10
RETRY_INTERVAL=3
 
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}
 
log "=== Bắt đầu deploy ==="
 
cd "$APP_DIR"
 
# Pull code mới nhất
log "Đang pull thay đổi mới nhất..."
git pull origin main 2>&1 | tee -a "$LOG_FILE"
 
# Cài dependency
log "Đang cài dependency..."
npm install --legacy-peer-deps 2>&1 | tee -a "$LOG_FILE"
 
# Build
log "Đang build ứng dụng..."
rm -rf .next
npm run build 2>&1 | tee -a "$LOG_FILE"
 
if [ $? -ne 0 ]; then
    log "LỖI: Build thất bại. Hủy deploy."
    exit 1
fi
 
# Reload PM2 (không downtime trong cluster mode)
log "Đang reload PM2..."
pm2 reload "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
pm2 save 2>&1 | tee -a "$LOG_FILE"
 
# Health check với retry
log "Đang chạy health check..."
for i in $(seq 1 $MAX_RETRIES); do
    HTTP_CODE=$(curl -s -o /dev/null -w '%{http_code}' "$HEALTH_URL" 2>/dev/null || echo "000")
    if [ "$HTTP_CODE" = "200" ]; then
        log "Health check passed (HTTP $HTTP_CODE)"
        log "=== Deploy hoàn tất thành công ==="
        exit 0
    fi
    log "Health check lần thử $i/$MAX_RETRIES (HTTP $HTTP_CODE). Thử lại sau ${RETRY_INTERVAL}s..."
    sleep $RETRY_INTERVAL
done
 
log "LỖI: Health check thất bại sau $MAX_RETRIES lần thử"
log "Đang rollback về trạng thái PM2 trước đó..."
pm2 restart "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
exit 1

Thiết Lập VPS Thực Sự Hoạt Động: Node.js, PM2, Nginx, và Deploy Không Downtime

Bắt Đầu Với Bảo Mật, Không Phải Code

Tạo User Không Phải Root

Thiết Lập Xác Thực SSH Key

Tường Lửa Với UFW

Fail2Ban

Cập Nhật Bảo Mật Tự Động

Node.js: Dùng NVM, Không Phải apt

PM2: Process Manager Xứng Đáng Với Công Sức

Cài Đặt và Thiết Lập

File Config Ecosystem

Script Khởi Động

Xoay Log

Nginx: Reverse Proxy Làm Được Nhiều Hơn Bạn Nghĩ

Cài Đặt

Cấu Hình

SSL Trong Năm Phút

Xác Minh Gia Hạn Tự Động

Script Deploy

Khi Mọi Thứ Hỏng Lúc 2 Giờ Sáng

"Site bị sập"

"Bộ nhớ cứ tăng"

"Chứng chỉ SSL hết hạn"

"Ổ đĩa đầy"

Lệnh Tôi Chạy Mỗi Sáng

Những Điều Hầu Hết Hướng Dẫn Không Nói

Checklist Đầy Đủ

Đây Có Phải "Enterprise-Grade" Không?

Bài viết liên quan

Monorepos in 2026: Nx, Turborepo, and the Lessons Nobody Shares

YAML Validator Guide: Catch Config Errors Before Deploy