إعداد VPS الذي يعمل فعلا: Node.js و PM2 و Nginx ونشر بدون توقف

إعداد نشر VPS الدقيق الذي أستخدمه في بيئة الإنتاج — تقوية Ubuntu، وضع المجموعات في PM2، وكيل عكسي Nginx، SSL، وسكريبت نشر لم يخذلني بعد. لا نظريات، فقط ما يعمل.

يمكن لـ VPS متواضع بـ 10 دولارات/شهر — صندوق Ubuntu واحد مع Nginx و PM2 وسكريبت bash — تشغيل تطبيق Node.js بشكل موثوق دون Vercel أو AWS أو مجموعة Kubernetes.

جربت المسارات الأخرى. استخدمت Vercel (رائع حتى تحتاج وظائف مجدولة أو WebSockets مستمرة أو مجرد تحكم). استخدمت AWS (رائع إذا كنت تستمتع بقضاء نصف يومك في سياسات IAM). دائما أعود إلى VPS.

لكن إليك المشكلة: كل دليل "انشر على VPS" على الإنترنت يتوقف عند المسار السعيد. يُريك كيف تثبت Node.js وتشغل node server.js ويسميها إنتاج. ثم يتعرض خادمك لهجوم القوة الغاشمة على SSH، وتموت عمليتك في الساعة 3 صباحا لأن لا أحد أعد مدير عمليات، وشهادة SSL انتهت صلاحيتها منذ ثلاثة أشهر.

هذا هو الدليل الذي كنت أتمنى لو كان لدي. كل شيء هنا مُختبر في المعركة.

ابدأ بالأمان، وليس الكود

قبل أن تفكر حتى في Node.js، أمّن الصندوق. مثيلات VPS الجديدة هي أهداف. الروبوتات الآلية تبدأ بضرب منفذ SSH في غضون دقائق من التوفير.

أنشئ مستخدما غير الجذر

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,
      },
      // إيقاف رشيق
      kill_timeout: 5000,
      listen_timeout: 10000,
      wait_ready: false,
      // التسجيل
      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,
      // إعادة التشغيل التلقائي عند الفشل
      autorestart: true,
      max_restarts: 10,
      min_uptime: "10s",
      // لا تراقب في بيئة الإنتاج
      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;
 
    # إعادة توجيه كل HTTP إلى HTTPS
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;
 
    # SSL (يُدار بواسطة Certbot — تُضاف هذه الأسطر تلقائيا)
    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;
 
    # ترويسات الأمان
    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;
 
    # ضغط 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;
 
    # إعدادات الوكيل
    location / {
        proxy_pass http://node_app;
        proxy_http_version 1.1;
 
        # الترويسات
        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;
 
        # دعم WebSocket (إذا احتجته يوما)
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
 
        # المهل الزمنية — سخية لكن ليست لا نهائية
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
 
        # التخزين المؤقت — دع Nginx يتعامل مع العملاء البطيئين
        proxy_buffering on;
        proxy_buffer_size 16k;
        proxy_buffers 4 32k;
        proxy_busy_buffers_size 64k;
    }
 
    # أصول Next.js الثابتة — دع Nginx يقدمها مباشرة
    location /_next/static/ {
        alias /var/www/example.com/.next/static/;
        expires 365d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }
 
    # الملفات الثابتة العامة
    location /static/ {
        alias /var/www/example.com/public/static/;
        expires 30d;
        access_log off;
    }
 
    # حظر الوصول إلى ملفات النقطة
    location ~ /\. {
        deny all;
        access_log off;
        log_not_found off;
    }
}

bash

#!/bin/bash
# deploy.sh — نشر بدون توقف تقريبا
 
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 "=== Deploy started ==="
 
cd "$APP_DIR"
 
# سحب أحدث الكود
log "Pulling latest changes..."
git pull origin main 2>&1 | tee -a "$LOG_FILE"
 
# تثبيت التبعيات
log "Installing dependencies..."
npm install --legacy-peer-deps 2>&1 | tee -a "$LOG_FILE"
 
# البناء
log "Building application..."
rm -rf .next
npm run build 2>&1 | tee -a "$LOG_FILE"
 
if [ $? -ne 0 ]; then
    log "ERROR: Build failed. Aborting deploy."
    exit 1
fi
 
# إعادة تحميل PM2 (بدون توقف في وضع المجموعات)
log "Reloading PM2..."
pm2 reload "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
pm2 save 2>&1 | tee -a "$LOG_FILE"
 
# فحص الصحة مع إعادة المحاولة
log "Running 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 completed successfully ==="
        exit 0
    fi
    log "Health check attempt $i/$MAX_RETRIES (HTTP $HTTP_CODE). Retrying in ${RETRY_INTERVAL}s..."
    sleep $RETRY_INTERVAL
done
 
log "ERROR: Health check failed after $MAX_RETRIES attempts"
log "Rolling back to previous PM2 state..."
pm2 restart "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
exit 1

إعداد VPS الذي يعمل فعلا: Node.js و PM2 و Nginx ونشر بدون توقف

ابدأ بالأمان، وليس الكود

أنشئ مستخدما غير الجذر

إعداد مصادقة مفتاح SSH

جدار الحماية مع UFW

Fail2Ban

تحديثات الأمان التلقائية

Node.js: استخدم NVM، وليس apt

PM2: مدير العمليات الذي يستحق مكانه

التثبيت والإعداد

إعداد النظام البيئي

سكريبت بدء التشغيل

تدوير السجلات

Nginx: الوكيل العكسي الذي يفعل أكثر مما تظن

التثبيت

الإعداد

SSL في خمس دقائق

التحقق من التجديد التلقائي

سكريبت النشر

عندما تتعطل الأشياء في الساعة 2 صباحا

"الموقع معطل"

"الذاكرة تستمر في النمو"

"شهادة SSL انتهت صلاحيتها"

"مساحة القرص ممتلئة"

الأمر الذي أشغله كل صباح

ما لن تخبرك به معظم الأدلة

القائمة الكاملة

هل هذا "بمستوى المؤسسات"؟

مقالات ذات صلة

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

YAML Validator Guide: Catch Config Errors Before Deploy