Gerçekten Çalışan VPS Kurulumu: Node.js, PM2, Nginx ve Sıfır Kesintili Dağıtım | 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,
      },
      // Zarif kapanış
      kill_timeout: 5000,
      listen_timeout: 10000,
      wait_ready: false,
      // Loglama
      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,
      // Başarısızlıkta otomatik yeniden başlat
      autorestart: true,
      max_restarts: 10,
      min_uptime: "10s",
      // Üretimde izleme yapma
      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;
 
    # Tüm HTTP'yi HTTPS'ye yönlendir
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;
 
    # SSL (Certbot tarafından yönetilir — bu satırlar otomatik eklenir)
    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;
 
    # Güvenlik başlıkları
    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 sıkıştırma
    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;
 
    # Proxy ayarları
    location / {
        proxy_pass http://node_app;
        proxy_http_version 1.1;
 
        # Başlıklar
        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 desteği (ihtiyacınız olursa)
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
 
        # Zaman aşımları — cömert ama sonsuz değil
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
 
        # Tamponlama — yavaş istemcileri Nginx'e bırak
        proxy_buffering on;
        proxy_buffer_size 16k;
        proxy_buffers 4 32k;
        proxy_busy_buffers_size 64k;
    }
 
    # Next.js statik varlıkları — Nginx'in doğrudan sunmasını sağla
    location /_next/static/ {
        alias /var/www/example.com/.next/static/;
        expires 365d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }
 
    # Genel statik dosyalar
    location /static/ {
        alias /var/www/example.com/public/static/;
        expires 30d;
        access_log off;
    }
 
    # Nokta dosyalarına erişimi engelle
    location ~ /\. {
        deny all;
        access_log off;
        log_not_found off;
    }
}

bash

#!/bin/bash
# deploy.sh — sıfıra yakın kesintili dağıtım
 
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 başladı ==="
 
cd "$APP_DIR"
 
# En son kodu çek
log "En son değişiklikler çekiliyor..."
git pull origin main 2>&1 | tee -a "$LOG_FILE"
 
# Bağımlılıkları kur
log "Bağımlılıklar kuruluyor..."
npm install --legacy-peer-deps 2>&1 | tee -a "$LOG_FILE"
 
# Derle
log "Uygulama derleniyor..."
rm -rf .next
npm run build 2>&1 | tee -a "$LOG_FILE"
 
if [ $? -ne 0 ]; then
    log "HATA: Derleme başarısız. Deploy iptal ediliyor."
    exit 1
fi
 
# PM2'yi yeniden yükle (küme modunda sıfır kesinti)
log "PM2 yeniden yükleniyor..."
pm2 reload "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
pm2 save 2>&1 | tee -a "$LOG_FILE"
 
# Yeniden denemeli sağlık kontrolü
log "Sağlık kontrolü çalıştırılıyor..."
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 "Sağlık kontrolü geçti (HTTP $HTTP_CODE)"
        log "=== Deploy başarıyla tamamlandı ==="
        exit 0
    fi
    log "Sağlık kontrolü denemesi $i/$MAX_RETRIES (HTTP $HTTP_CODE). ${RETRY_INTERVAL}s sonra tekrar deneniyor..."
    sleep $RETRY_INTERVAL
done
 
log "HATA: $MAX_RETRIES denemeden sonra sağlık kontrolü başarısız"
log "Önceki PM2 durumuna geri dönülüyor..."
pm2 restart "$APP_NAME" 2>&1 | tee -a "$LOG_FILE"
exit 1

Gerçekten Çalışan VPS Kurulumu: Node.js, PM2, Nginx ve Sıfır Kesintili Dağıtım

Kodla Değil, Güvenlikle Başlayın

Root Olmayan Kullanıcı Oluşturun

SSH Anahtar Kimlik Doğrulaması Kurun

UFW ile Güvenlik Duvarı

Fail2Ban

Otomatik Güvenlik Güncellemeleri

Node.js: apt Değil, NVM Kullanın

PM2: Hak Ettiğini Kanıtlayan Süreç Yöneticisi

Kurulum

Ekosistem Yapılandırması

Başlangıç Betiği

Log Rotasyonu

Nginx: Düşündüğünüzden Fazlasını Yapan Ters Proxy

Kurulum

Yapılandırma

Beş Dakikada SSL

Otomatik Yenilemeyi Doğrulayın

Deploy Betiği

Gece 2'de İşler Bozulduğunda

"Site çökmüş"

"Bellek sürekli artıyor"

"SSL sertifikası süresi dolmuş"

"Disk alanı dolmuş"

Her Sabah Çalıştırdığım Komut

Çoğu Rehberin Size Söylemeyeceği Şeyler

Tam Kontrol Listesi

Bu "Kurumsal Düzeyde" mi?

İlgili Yazılar

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

YAML Validator Guide: Catch Config Errors Before Deploy