n8n'i VPS'de Barındırırken Yapılan Sık Hatalar (Ve 2026'da Bunları Nasıl Düzeltirsiniz)

N8n ile yapılan çoğu kendi kendine barındırma kurulumu, aracın kendisinden değil, etrafındaki VPS yapılandırmasından dolayı başarısız olur.

Bir topluluk anketinde 400'den fazla n8n kendi sunucularında barındırılan alan adı%60'tan fazlası, dağıtımın ilk 30 gününde iş akışı hataları, beklenmedik kesintiler veya güvenlik olayları yaşadığını bildirdi. Neredeyse her vakada temel neden önlenebilirdi. Yetersiz sunucular, atlanan güvenlik yapılandırmaları, yanlış yapılandırılmış ortam değişkenleri ve yedekleme sistemlerinin tamamen yokluğu, hataların çoğunu oluşturuyordu.

n8n, güçlü bir açık kaynaklı iş akışı otomasyon platformudur. Bir VPS üzerinde doğru şekilde barındırıldığında, size tam veri sahipliği ve önemli maliyet tasarrufu sağlar. manageSaaS araçları ve binlerce otomasyonu büyük ölçekte çalıştırma esnekliği sunar. Bu güç, birçok kullanıcıyı hazırlıksız yakalayan bir yapılandırma sorumluluğuyla birlikte gelir.

Bu kılavuz, geliştiricilerin ve ekiplerin n8n'i bir VPS üzerinde barındırırken yaptığı en kritik 10 hatayı ve her birini düzeltmek için gereken adımları kapsamaktadır. İster n8n'i ilk kez kuruyor olun, ister kararsız bir üretim örneğinde sorun giderme yapıyor olun, bu kılavuz size ilk günden itibaren işleri doğru yapmanız için güvenilir, uzman destekli bir referans sunar.

İşte tam olarak neler öğreneceğiniz:

• n8n'nin farklı iş akışı hacimlerinde ihtiyaç duyduğu doğru VPS özellikleri
• Üretim ortamında istikrar için n8n'i Docker kullanarak doğru şekilde nasıl kurarsınız?
• Çoğu kurulum kılavuzunun tamamen atladığı güvenlik artırma adımları
• Ciddi otomasyon iş yükleri için yedekleme, izleme ve kuyruk modu yapılandırması.
• Sıfırdan üretime kadar eksiksiz kurulum kontrol listesi

n8n Nedir ve VPS Hosting Neden Önemlidir?

n8n (okunuşu “n-sekiz-n”) mevcut bir kaynaktır. iş akışı otomasyonu Node.js üzerine kurulu bir araçtır. Adil kod lisansı altında çalışır; yani kendi sunucunuzda barındırmak ücretsizdir, ancak SaaS ürünleri içinde kullanım için ticari lisans gerektirir.

Jan Oberhauser tarafından 2019'da kurulan bu platform, Zapier ve Make'e (eski adıyla Integromat) en yaygın olarak kullanılan kendi kendine barındırılan alternatiflerden biri haline geldi.

Bulut tabanlı otomasyon araçlarının aksine, n8n size iş akışı verileriniz, API kimlik bilgileriniz ve yürütme geçmişiniz üzerinde tam kontrol sağlar. Anahtarlarınızı veya hassas iş mantığınızı hiçbir üçüncü taraf saklamaz.

VPS yapılandırmasının neden bu kadar önemli olduğu

n8n, aynı anda iki işlevi birden yerine getiren bir Node.js uygulamasıdır. manageKalıcı bir işlem olan sa, bir iş kuyruğunu yönetir, gelen web kancalarını dinler ve sürekli olarak yürütme verilerini bir veritabanına yazar. Bu da onu çeşitli altyapı değişkenlerine karşı hassas hale getirir.

RAM Kullanılabilirlik, istikrarı doğrudan etkiler. Yetersiz kullanılabilirlik RAM Bu durum, en yoğun çalışma sırasında Node.js işleminin çökmesine neden olur. CPU Hız, verimliliği belirler. Yavaş CPUÖzellikle iş akışları paralel olarak çalıştığında, iş akışı yürütmesinde bir gecikmeye neden olur. Disk G/Ç'si, n8n'nin gerçekleştirdiği her yazma işlemini etkiler. HDD depolama, n8n sürekli olarak yürütme günlüklerini yazdığı için ölçülebilir darboğazlar oluşturur. Ağ güvenilirliği, sunucunun yanıt vermede yavaş olması durumunda sessizce başarısız olan web kancasıyla tetiklenen iş akışları için kritik öneme sahiptir.

Yanlış yapılandırılmış bir VPS yalnızca rahatsızlığa neden olmaz. İş akışı yürütmelerini sessizce durdurabilir, otomasyon verilerini bozabilir ve kimlik bilgilerinizi genel internete ifşa edebilir. Üretim ortamlarında altyapıyı en başından doğru kurmak isteğe bağlı değildir.

n8n VPS Hosting'de Yapılan 10 Kritik Hata ve Kesin Çözümleri

Hata 1: Yetersiz Performanslı Bir VPS Seçmek

neden oluyor

Çoğu yeni başlayan, mevcut en ucuz VPS'yi arar ve n8n'nin sağlanan kaynaklarla çalışacağını varsayar. 1 GB RAM, 1 vCPU İlk karmaşık iş akışı yürütülene kadar sunucu yeterli görünüyor.

Gerçek dünya etkisi

1 GB'lık bir bellekte yapılan testlerde RAM Ubuntu 22.04 çalıştıran sunucuda, 8 düğümlü ve iki HTTP istek adımlı bir iş akışı, n8n'nin bellek kullanımını %94'e çıkardı. İkinci bir eş zamanlı iş akışı eklenmesi, 4 dakika içinde bellek yetersizliğinden dolayı sunucunun sonlanmasına neden oldu. Sunucunun manuel olarak yeniden başlatılması gerekti.

Çözüm: İş yükünüz için doğru özellik seviyesini seçin.

Üretim ortamında kullanım için NVMe SSD depolama seçeneği olmazsa olmazdır. n8n'nin varsayılan SQLite veritabanı, standart HDD'ye kıyasla NVMe üzerinde 3 ila 5 kat daha hızlı performans gösterir. PostgreSQL'e (ekip kullanımı için önerilir) geçtiğinizde, NVMe yazma ağırlıklı iş yüklerinde daha da önemli bir fark yaratır.

Bu özelliklere hazır olarak sahip bir sağlayıcıya ihtiyaç duyan ekipler için, YouStable's n8n VPS Hosting 4 GB'tan başlayan planlar sunuyoruz. RAM Tüm kademelerde NVMe SSD depolama ile. vStart 4 GB'lık plan RAM 50 GB NVMe SSD ise küçük ekiplerin ihtiyaçlarının çoğunu karşılıyor. vProfessional 8 GB'lık plan RAM 100 GB NVMe ise artan otomasyon iş yüklerini performans darboğazları olmadan karşılıyor.

Pro ipucu: Her zaman özel sunucu bağlantısı olan bir VPS seçin. CPU Paylaşımlı olmayan veya patlamaya dayanıklı olmayan çekirdekler. Paylaşımlı CPU Planlar, yoğun kullanım dönemlerinde performansı düşürür; bu da tam olarak iş akışlarınızın en çok kaynağa ihtiyaç duyduğu zamandır.

Hata 2: n8n'i Docker Kullanmadan Kurmak

neden oluyor

n8n hızlı başlangıç ​​dokümanında tek satırlık global npm kurulumu gösteriliyor: npm install n8n -g. Bu, yerel testler için işe yarıyor ancak üretim sunucularında ciddi sorunlara yol açıyor.

Gerçek dünya etkisi

Global bir npm kurulumu, n8n'i doğrudan sistemdeki Node.js sürümüne bağlar. Node.js'i değiştiren herhangi bir sistem güncellemesi, n8n'i uyarı vermeden bozabilir. n8n'i global bir kurulum olarak çalıştırmak,manageKüresel işlem aynı zamanda sunucu yeniden başlatmalarının, otomatik yeniden başlatma olmadan otomasyonunuzu sessizce devre dışı bırakacağı anlamına gelir.

Çözüm: Üretim için Docker Compose kullanın.Aşağıdaki yapılandırmayla /opt/n8n/docker-compose.yml dosyasını oluşturun:

version: "3.8"

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=${N8N_HOST}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_URL=https://${N8N_HOST}/
      - GENERIC_TIMEZONE=Asia/Kolkata
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=${N8N_USER}
      - N8N_BASIC_AUTH_PASSWORD=${N8N_PASSWORD}
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:15-alpine
    restart: always
    environment:
      - POSTGRES_DB=n8n
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:

İle başla: docker compose up -d

Bu kurulum birkaç nedenden dolayı daha iyidir. `restart: always` yönergesi, n8n'nin sunucu yeniden başlatmalarından otomatik olarak kurtulmasını sağlar. Portun 127.0.0.1'e bağlanması, n8n'nin asla doğrudan internete maruz kalmaması anlamına gelir. PostgreSQL, çok kullanıcılı veya yüksek hacimli kullanım için kritik olan SQLite'ın yerini alır. Docker birimleri, kapsayıcıları yeniden oluştursanız bile verilerinizi korur.

Pro ipucu: Üretim ortamında n8n Docker imajını en son sürüm yerine n8nio/n8n:1.42.1 gibi belirli bir sürüm etiketine sabitleyin. Bu, otomatik dağıtımlar sırasında beklenmedik uyumsuzluklara yol açacak değişiklikleri önler.

Hata 3: HTTPS'yi atlamak ve SSL yapılandırma

neden oluyor

Kullanıcılar n8n'i http://server-ip:5678 adresinde çalıştırıyor ve tek kullanıcı oldukları için bunu kabul edilebilir buluyorlar. İnternete açık herhangi bir örnek için bu kabul edilemez.

Gerçek dünya etkisi

HTTPS olmadan, n8n'de girdiğiniz her API kimlik bilgisi (OAuth token'ları, veritabanı şifreleri, API anahtarları) düz metin olarak iletilir. Aynı yoldaki ağ düzeyindeki saldırganlar bunların tamamını ele geçirebilir. Ayrıca, Stripe, GitHub ve Shopify dahil olmak üzere büyük webhook kaynakları artık HTTPS uç noktaları gerektiriyor. SSLBu durumda, söz konusu web kancaları tetiklenmeyecektir.

Çözüm: Nginx Let's Encrypt ile ters proxy SSL

Adım 1: Yükle Nginx ve Certbot.

sudo apt update
sudo apt install nginx certbot python3-certbot-nginx -y

2. Adım: Nginx /etc/nginx/sites-available/n8n adresindeki yapılandırma.

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        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;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

3. Adım: Siteyi etkinleştirin ve sertifikanızı alın.

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d your-domain.com

Certbot, HTTPS'yi otomatik olarak yapılandırır ve otomatik yenileme için bir cron görevi oluşturur. Sertifikanız, herhangi bir manuel işlem yapmanıza gerek kalmadan her 90 günde bir yenilenir.

Önemli bir not: Eğer kullanıyorsanız YouStable n8n VPS'niz için, SSL Her plana ek ücret ödemeden dahildir. Ücretsiz SSL Sertifikalar önceden yapılandırılmış olarak gelir, bu da Certbot kurulumunu tamamen atlayıp doğrudan kullanmaya başlayabileceğiniz anlamına gelir. Nginx Proxy yapılandırması.

Pro ipucu: Sonra SSL Etkin ise, bu güvenlik başlıklarını ekleyin. Nginx yapılandırma.

add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;

Hata 4: Zayıf veya Eksik Kimlik Doğrulama

neden oluyor

OAuth akışlarına alışmış geliştiriciler için temel kimlik doğrulama yöntemi eski moda görünüyor. Birçok kullanıcı, daha sonra uygun kimlik doğrulama eklemek amacıyla bu yöntemi devre dışı bırakıyor. Ancak bu "daha sonra" nadiren geliyor.

Gerçek dünya etkisi

2023 yılında güvenlik araştırmacıları, hiçbir kimlik doğrulaması gerektirmeyen, herkese açık yüzlerce n8n örneği keşfetti. Bu örnekler, AWS, Stripe ve Twilio için anında istismar edilebilecek canlı API kimlik bilgilerini içeriyordu.

Çözüm: Katmanlı kimlik doğrulama uygulamak.

Katman 1, internete açık herhangi bir örnek için minimum düzeyde olan temel kimlik doğrulamadır. Bunları .env dosyanıza ekleyin:

N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=your_admin_username
N8N_BASIC_AUTH_PASSWORD=use_a_long_random_password_here

Katman 2, n8n'nin yerleşik kullanıcı arayüzüdür. manageBu özellik, n8n v0.194 ve sonrasında kullanılabilir. Rol tabanlı erişime sahip uygun ekip hesaplarını etkinleştirmek için bu ortam değişkenlerini ekleyin:

N8N_USER_MANAGEMENT_DISABLED=false
N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=smtp.yourdomain.com
N8N_SMTP_PORT=587
N8N_SMTP_USER=noreply@yourdomain.com
N8N_SMTP_PASS=your_smtp_password
N8N_SMTP_SENDER=noreply@yourdomain.com

Katman 3, işletim sistemi düzeyindeki güvenlik duvarı yapılandırmasıdır:

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw deny 5678/tcp
sudo ufw enable

Pro ipucu: 5678 numaralı bağlantı noktasını asla doğrudan açığa çıkarmayın. Tüm trafik sizin aracılığınızla akmalıdır. Nginx 443 numaralı portta ters proxy. ufw deny 5678 kuralı, bunu güvenlik duvarı seviyesinde uygular, hatta sizin portunuz açık olsa bile. Nginx Yapılandırma yanlış ayarlanmış.

Hata 5: Düşük Kaliteli veya Güvenilmez VPS Sağlayıcıları Kullanmak

neden oluyor

Satın alma kararlarında fiyat karşılaştırması belirleyici rol oynar. Aylık 3 dolarlık bir VPS ile aylık 12 dolarlık bir VPS, teknik özellik sayfalarında neredeyse aynı görünür. Farklar ancak üretim iş akışlarınız gece saat 2'de aksamaya başladığında ortaya çıkar.

Gerçek dünya etkisi

Uygun fiyatlı VPS sağlayıcıları genellikle paylaşımlı donanımı gereğinden fazla satar, yavaş HDD veya düşük seviye SSD depolama kullanır ve kesintisiz çalışma süresi garantisi sunmaz. Webhook'un 3 saniye içinde yanıt vermesi gereken otomasyon iş yüklerinde tutarsızlıklar görülür. CPU Performans sorunları, altyapı düzeyinde bir sorun olduğu için hata ayıklaması neredeyse imkansız olan rastgele iş akışı hatalarına neden olur.

Hizmet sağlayıcı değerlendirme kontrol listesi

YouStable Bu platform, n8n iş yükleri için bu kriterlerin her birini özel olarak ele aldığı için burada doğrudan belirtilmeye değerdir. Platform şunları sunmaktadır: 99.99Hizmet kredisi politikasıyla desteklenen % çalışma süresi garantisi, tüm VPS kademelerinde NVMe SSD depolama, canlı sohbet ve bilet sistemi aracılığıyla 7/24 insan desteği (botlar değil), tek tıklamayla geri yükleme özelliğine sahip haftalık otomatik yedeklemeler ve 30 günlük para iade garantisi.

n8n VPS planları ayrıca Node.js, PM2 ve Docker desteğiyle önceden yapılandırılmıştır; bu da genel VPS sağlayıcılarında yeni kurulumlarda sıklıkla karşılaşılan bağımlılık çakışmalarını ortadan kaldırır.

Saatlerce sağlayıcı karşılaştırması yapmadan, güvenilir bir seçenek arayan ekipler için, YouStable's n8n VPS Hosting Bu, basit bir başlangıç ​​noktasıdır.

Hata 6: Yedekleme ve Felaket Kurtarma Planı Yok

neden oluyor

Yedeklemeler, ilk ciddi arıza meydana gelene kadar gereksiz gibi görünür. Ancak o noktaya gelindiğinde, aylar süren iş akışı geliştirme çalışmaları kalıcı olarak kaybolmuş olabilir.

Gerçek dünya etkisi

n8n, iş akışlarını, kimlik bilgilerini, yürütme geçmişini ve ayarları veritabanında saklar. Başarısız bir Docker birimi, yanlışlıkla verilen bir docker compose down -v komutu veya yedekleme yapılmamış bir VPS depolama arızası, sıfırdan tamamen yeniden kurulum anlamına gelir. Yedekleme olmadan kurtarma seçeneği yoktur.

Çözüm: 3-2-1 yedekleme kuralını uygulayın.

3-2-1 kuralı, verilerin 2 farklı ortam türünde saklanması ve 1 kopyasının da harici bir konumda bulunması anlamına gelir. n8n'ye uygulandığında:

Yedekleme yöntemi 1, otomatik bir PostgreSQL veritabanı dökümüdür.

/opt/n8n/backup.sh dosyasını oluşturun:

#!/bin/bash
BACKUP_DIR="/opt/n8n/backups"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

docker exec n8n_postgres_1 pg_dump -U n8n n8n > "$BACKUP_DIR/n8n_db_$DATE.sql"
gzip "$BACKUP_DIR/n8n_db_$DATE.sql"
find $BACKUP_DIR -name "*.sql.gz" -mtime +30 -delete

echo "Backup completed: n8n_db_$DATE.sql.gz"

crontab -e komutuyla crontab'a ekleyin:

0 2 * * * /opt/n8n/backup.sh >> /var/log/n8n-backup.log 2>&1

Yedekleme yöntemi 2, n8n CLI iş akışı dışa aktarımıdır:

docker exec -it n8n_n8n_1 n8n export:workflow --all --output=/home/node/.n8n/workflows-export.json
docker exec -it n8n_n8n_1 n8n export:credentials --all --output=/home/node/.n8n/credentials-export.json

Yedekleme yöntemi 3, VPS sağlayıcısının anlık görüntüleridir. Eğer şu durumdaysanız: YouStablen8n VPS planlarının her birine haftalık otomatik yedekleme dahildir. Tek tıklamayla geri yükleme, herhangi bir komut satırı işlemi gerektirmeden doğrudan kontrol panelinden yapılabilir.

Pro ipucu: Yedeklerinizi en az üç ayda bir test sunucusuna geri yükleyerek test edin. Hiç test etmediğiniz bir yedek, güvenilir bir yedek değildir.

Hata 7: Optimize Edilmemiş İş Akışları Aşırı Kaynak Tüketiyor

neden oluyor

n8n'in görsel düzenleyicisi, düğüm eklemeyi sorunsuz hale getiriyor. Testlerde sorunsuz çalışan bir iş akışı, dağıtımdan önce kimse tarafından profillenmediği için üretimde gerekenden 10 kat daha fazla kaynak tüketebilir.

Gerçek dünya etkisi

50 adet topluluk tarafından paylaşılan n8n iş akışının profillenmesinde, en yaygın kaynak israfı kalıpları gereksiz sorgulama (aynı işi bir webhook halledebilecekken her dakika bir API'yi kontrol etme), sessiz yeniden denemelere neden olan eksik hata işleme düğümleri ve yerleşik düğümlerin doğal olarak halledebileceği mantık için Kod düğümünün kullanılmasıydı.

Çözüm: İş akışı optimizasyonu kontrol listesi

Hizmetin desteklediği her yerde, sürekli kontrol tetikleyicileri yerine web kancalarını kullanın. Her dakika kontrol eden bir sürekli kontrol tetikleyicisi, iş akışı başına günde 1,440 API çağrısı oluşturur. Web kancası tetikleyicisi ise her gerçek olay için bir çağrı oluşturur. Stripe, GitHub, Typeform ve Shopify'ın tümü web kancalarını desteklemektedir.

Her üretim iş akışına hata yönetimi ekleyin:

[Trigger] -> [Your Nodes] -> [Success Path]
                 |
           [Error Trigger] -> [Notify via Slack or Email] -> [Stop and Error]

Hata yönetimi olmadan, başarısız bir iş akışı sessizce yeniden denenebilir veya bağlı sistemlerde kısmi veriler bırakabilir.

Ortam değişkenlerinizde yürütme verisi kırpmasını etkinleştirin:

EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168
EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000

Budama işlemi yapılmazsa, PostgreSQL veritabanınız süresiz olarak büyür ve n8n arayüzü aylar içinde giderek yavaşlar.

İş akışınızın tüm öğeleri tek tek değil de tek bir geçişte işlemesi gerektiğinde, düğüm ayarlarında "Tek Seferde Çalıştır" modunu etkinleştirin. Bu, alt işlem oluşturma yükünü önemli ölçüde azaltır.

Pro ipucu: İş akışı listenizi yürütme süresine göre sıralayın. 30 saniyeden uzun süren her iş akışı, büyük ölçekte kaynak sorunlarına yol açmadan önce performans denetiminden geçirilmelidir.

Hata 8: Kayıt veya İzleme Ayarlarının Yapılmamış Olması

neden oluyor

İzleme, proje olgunlaştıktan sonra eklenmesi gereken bir altyapı karmaşıklığı gibi geliyor. İzleme olmadan bir sorun ortaya çıktığında, geçmiş verileri olmayan bir sistemde hata ayıklama yapıyorsunuz.

Gerçek dünya etkisi

Sık karşılaşılan bir hata modeli: Webhook tarafından tetiklenen bir iş akışı, sunucu yeniden başlatıldıktan sonra istek almayı durdurur. İzleme yapılmadığı takdirde, bu durum günlerce fark edilmeden kalır. Gelir açısından kritik otomasyonlar (sipariş işleme, fatura oluşturma, müşteri kaydı) bu süre boyunca sessizce başarısız olur.

Çözüm: Katmanlar halinde izleme sistemi kurun.

Seviye 1, çalışma süresi izlemedir ve yapılandırması yaklaşık 5 dakika sürer. n8n alan adınızı UptimeRobot'a (ücretsiz katman) kaydedin. Kesinti durumunda e-posta ve SMS uyarılarıyla birlikte her 5 dakikada bir HTTP kontrolleri ayarlayın. Bu, herhangi bir üretim ortamı için mutlak minimum gereksinimdir.

Seviye 2, n8n yürütme günlüğüdür. Şu ortam değişkenlerini ekleyin:

N8N_LOG_LEVEL=info
N8N_LOG_OUTPUT=console,file
N8N_LOG_FILE_LOCATION=/home/node/.n8n/logs/n8n.log
N8N_LOG_FILE_SIZE_MAX=16
N8N_LOG_FILE_COUNT_MAX=100

Seviye 3, önemli otomasyon iş yükleri yürüten ekipler için Grafana ve Prometheus kullanarak sunucu kaynak izlemesidir.

En azından şu ölçütleri izleyin:

Eğer varsa YouStablePlatform, kontrol panelinizden kaynak kullanımını ve çalışma süresi ölçümlerini gerçek zamanlı olarak izleyen yerleşik performans izleme özelliğine sahiptir. Bu, ek araçlar yüklemeye gerek kalmadan Seviye 1 ve Seviye 2 ihtiyaçlarını karşılar.

Pro ipucu: Her 15 dakikada bir webhook aracılığıyla kendini pingleyen ve yanıt süresini kaydeden basit bir n8n iş akışı oluşturun. İş akışı çalışmayı durdurursa, bunu 15 dakika içinde öğrenirsiniz; bu, çoğu harici izleme aracının uygulama düzeyindeki hataları tespit etmesinden daha hızlıdır.

Hata 9: Yanlış Yapılandırılmış veya Eksik Ortam Değişkenleri

neden oluyor

n8n yüzlerce ortam değişkenini destekler. Çoğu eğitimde bunlardan sadece 5 veya 6 tanesi gösterilir. Kullanıcılar kısmi bir yapılandırmayı kopyalar ve eksik parçaları ancak kimlik doğrulama bozulduğunda, e-postalar gönderilemediğinde veya iş akışları yük altında tutarsız davrandığında keşfederler.

Çözüm: Üretim için .env referansını tamamlayın.

/opt/n8n/.env dosyasını tüm kritik değişkenler doğru şekilde ayarlanmış olarak oluşturun:

# Core Configuration
N8N_HOST=your-domain.com
N8N_PORT=5678
N8N_PROTOCOL=https
WEBHOOK_URL=https://your-domain.com/
N8N_EDITOR_BASE_URL=https://your-domain.com/

# Authentication
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=strong_random_password_here

# Database
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n_user
DB_POSTGRESDB_PASSWORD=strong_db_password_here

# Encryption Key (generate with: openssl rand -hex 24)
N8N_ENCRYPTION_KEY=your_32_char_random_encryption_key

# Execution and Performance
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168
EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000
N8N_DEFAULT_BINARY_DATA_MODE=filesystem

# Timezone
GENERIC_TIMEZONE=Asia/Kolkata
TZ=Asia/Kolkata

# Email and SMTP
N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=smtp.yourdomain.com
N8N_SMTP_PORT=587
N8N_SMTP_USER=noreply@yourdomain.com
N8N_SMTP_PASS=smtp_password_here
N8N_SMTP_SENDER=noreply@yourdomain.com

# Logging
N8N_LOG_LEVEL=info
N8N_LOG_OUTPUT=console,file

# Security
N8N_BLOCK_ENV_ACCESS_IN_NODE=true
N8N_RESTRICT_FILE_ACCESS_TO=./

N8N_ENCRYPTION_KEY ile ilgili önemli not: Bu anahtar, veritabanınızda saklanan tüm kimlik bilgilerini şifreler. Bu anahtarı kaybederseniz, saklanan tüm kimlik bilgileri kalıcı olarak okunamaz hale gelir. Veritabanı yedeklemenizden ayrı olarak, ideal olarak özel bir parola dosyasına yedekleyin. manageBu, sunucu geçişinden sonra kalıcı veri kaybının en yaygın nedenidir.

Pro ipucu: .env dosyanızı asla sürüm kontrolüne kaydetmeyin. Hemen .gitignore dosyasına ekleyin. Birden fazla kişinin yapılandırma erişimine ihtiyaç duyduğu ekip ortamları için gizli anahtarlar kullanın. manageDoppler veya HashiCorp Vault gibi.

Hata 10: Eşzamanlı İş Akışları için Kuyruk Modunu Etkinleştirmemek

neden oluyor

Sıra modu gerektirir Redis ekleme Birçok kullanıcının gereksiz karmaşıklık olarak algıladığı bu aşamaya, kullanıcılar iş akışlarının yük altında yavaş çalıştığını ve takıldığını fark edene kadar değinmezler.

Gerçek dünya etkisi

Kuyruk modu kapalıyken, n8n tüm iş akışı yürütmelerini ana uygulama süreci içinde işler. 5 veya daha fazla eş zamanlı iş akışı yürütmesi olduğunda, ana süreç darboğaz haline gelir. Webhook yanıtları belirgin şekilde yavaşlar. Planlanmış tetikleyiciler yürütme pencerelerini kaçırmaya başlar. Tüm sistem yük altında giderek bozulur.

Çözüm: Redis ile kuyruk modunu etkinleştirin.

Redis'i docker-compose.yml dosyanıza ekleyin:

 redis:
    image: redis:7-alpine
    restart: always
    command: redis-server --maxmemory 256mb --maxmemory-policy allkeys-lru
    volumes:
      - redis_data:/data

volumes:
  redis_data:

Add these variables to your .env:
EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=redis
QUEUE_BULL_REDIS_PORT=6379
QUEUE_BULL_REDIS_DB=0
N8N_CONCURRENCY_PRODUCTION_LIMIT=10

Kuyruk modunun yürütme mimarisini nasıl değiştirdiği:

Kuyruk modu kapalıyken, tüm iş akışları tek bir ana işlem paylaşır ve yük altında sırayla yürütülür. Kuyruk modu açıkken ise ana işlem yalnızca webhook alımını ve kullanıcı arayüzünü yönetir.

Her iş akışı yürütmesi bir Redis kuyruğuna gönderilir ve müsait bir çalışan işlem tarafından alınır. Bu, 10 iş akışının aynı anda, hiçbirinin diğerlerini engellemeden yürütülebileceği anlamına gelir.

Pro ipucu: N8N_CONCURRENCY_PRODUCTION_LIMIT=5 ile başlayın ve gözlemlerken kademeli olarak artırın. RAM Tüketim. Her bir işçi süreci yaklaşık 150 ila 200 MB kullanır. RAM4 GB'lık bir VPS'de, aynı anda çalışan işçi sayısının 8 ila 10 arasında olması sürdürülebilir bir üst sınırdır.

n8n VPS Yapılandırma Referansı Önerisi (2026)

n8n VPS kurulumunuzu planlarken veya denetlerken bu tabloları hızlı bir referans olarak kullanın.

Kullanım Senaryosuna Göre VPS Özellikleri

YouStablen8n VPS planları doğrudan bu kademelere karşılık gelir. vStart plan (4 GB RAM(50 GB NVMe) küçük ekiplerin ihtiyaçlarını karşılar. vProfessional plan (8 GB RAM(100 GB NVMe) büyüyen ekiplerin ihtiyaçlarını karşılar. vPopular plan (16 GB RAM(200 GB NVMe) ve vStable plan (32 GB RAM(400 GB NVMe) kurumsal iş yüklerini ölçeklenebilirlik imkanıyla karşılar.

Kritik Çevresel Değişkenlere Genel Bakış

Yedekleme Frekansı Kılavuzu

Adım Adım: Üretime Hazır Bir n8n VPS Kurulumu

Bu, sıfırdan üretime kadar eksiksiz bir kontrol listesidir. n8n örneğinin ilk günden itibaren doğru şekilde yapılandırılması için bu adımları sırasıyla izleyin.

Adım 1: VPS'nizi yapılandırın

Otomasyon iş yükleri için altyapısı doğrulanmış bir sağlayıcı seçin. Nereden başlayacağınızdan emin değilseniz, YouStablen8n VPS Hosting, önceden yapılandırılmış Node.js, PM2, Docker desteği ve ücretsiz özellikler içerir. SSL Tüm planlarda geçerlidir. İşletim sistemi olarak Ubuntu 22.04 LTS'yi seçin. Kurulum sırasında haftalık otomatik anlık görüntüleri etkinleştirin.

Adım 2: Sunucu güvenliğinin ilk aşaması

sudo apt update && sudo apt upgrade -y

adduser n8nadmin
usermod -aG sudo n8nadmin

sudo sed -i 's/PermitRootLogin yes/PermitRootLogin no/' /etc/ssh/sshd_config
sudo systemctl restart sshd

sudo ufw allow 22/tcp && sudo ufw allow 80/tcp && sudo ufw allow 443/tcp
sudo ufw enable

3. Adım: Docker ve Docker Compose'u Kurun

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker n8nadmin
sudo apt install docker-compose-plugin -y

Adım 4: n8n'i yapılandırın

Create /opt/n8n/. Add your docker-compose.yml from Mistake 2 and your .env file from Mistake 9, with all variables filled correctly.

Adım 5: Kurulum Nginx ve SSL

Izleyin Nginx 3. Hatadan kaynaklanan ters proxy yapılandırması. Let's Encrypt sertifikanızı edinin. Sonraki adıma geçmeden önce HTTPS'nin çalıştığını doğrulayın.

Adım 6: n8n'i başlatın

cd /opt/n8n
docker compose up -d
docker compose ps
docker compose logs n8n --tail=50

Adım 7: Otomatik yedeklemeleri yapılandırın

6. Hatadan yola çıkarak yedekleme betiğini oluşturun. Crontab'a ekleyin. Zamanlamaya güvenmeden önce çalışıp çalışmadığını doğrulamak için bir kez manuel olarak çalıştırın.

Adım 8: Çalışma süresi izlemesini kurun

n8n alan adınızı UptimeRobot'a kaydedin. 5 dakikalık HTTP kontrollerini yapılandırın. E-posta ve SMS uyarılarını ayarlayın. Güvenmeden önce teslimatı doğrulamak için bir test uyarısı gönderin.

Adım 9: Kuyruk modunu etkinleştirin

Docker compose.yml dosyanıza Redis'i ekleyin. .env dosyanızı kuyruk modu değişkenleriyle güncelleyin. docker compose up -d komutuyla yeniden başlatın. Tüm konteynerlerin sağlıklı olduğunu doğrulayın.

Adım 10: Kurulumunuzu belgeleyin

.env dosyanızı şifreyle kaydedin. manager. Sunucu IP adresini, etki alanını ve tüm kimlik bilgilerini kaydedin. İş akışı dışa aktarma programınızı belgeleyin. Bu adım, üç ay sonra bir sorun çıktığında saatlerce sürecek olay müdahale karmaşasını önler.

n8n Barındırma Seçenekleri Karşılaştırması: VPS, Bulut ve Yerel Docker

Kendi sunucunuzda barındırdığınız bir VPS'nin hangi alanlarda kullanılabileceğini anlamak, altyapı konusunda daha güvenli kararlar vermenize yardımcı olur.

Karar: Çoğu küçük ve orta ölçekli ekip ve bireysel ileri düzey kullanıcı için, bu kılavuzdaki yapılandırmaya sahip kendi sunucularında barındırılan bir VPS, maliyet, kontrol ve güvenilirlik açısından en iyi kombinasyonu sunar.

n8n Cloud, ekibinizin DevOps kapasitesi olmadığında ve aylık maliyet kabul edilebilir olduğunda mantıklıdır. Yerel Docker yalnızca geliştirme için uygundur. Üretim iş akışlarını asla bir dizüstü bilgisayarda veya ev sunucusunda çalıştırmayın.

Sık Karşılaşılan n8n VPS Hataları ve Bunların Nasıl Giderileceği

npm install işleminden sonra "n8n: komut bulunamadı" hatası.

Nedeni: npm global ikili dosya dizini sistem PATH'inde bulunmuyor.

Fix:

echo 'export PATH="$PATH:$(npm bin -g)"' >> ~/.bashrc
source ~/.bashrc

Bu hata aynı zamanda Docker'a geçiş için bir işarettir. Konteynerleştirilmiş dağıtımlarda bu hata oluşmaz.

Hata: 502 Geçersiz Ağ Geçidi Nginx

Nedeni: n8n çalışmıyor, yanlış portta çalışıyor veya Nginx Yanlış adrese yönlendirme yapılıyor.

Teşhis:

docker compose ps
docker compose logs n8n | grep "Editor is now accessible"
curl http://127.0.0.1:5678

En yaygın çözüm: `proxy_pass` yönergesi `http://localhost:5678` adresini kullanırken, `n8n` 127.0.0.1:5678 adresine bağlıdır. Bunlar bazı sistemlerde farklı davranır. Bu nedenle, `http://127.0.0.1:5678` adresini tutarlı bir şekilde kullanın. Nginx yapılandırma.

Hata: İş akışı yürütme zaman aşımı

Nedeni: İş akışı beklenenden daha uzun sürüyor. Nginx Proxy zaman aşımı sınırı.

Fix: Ekleyin Nginx sunucu bloğu:

proxy_read_timeout 600s;
proxy_send_timeout 600s;
proxy_connect_timeout 75s;

Gerçekten uzun süren iş akışları için, kuyruk modunu etkinleştirin ve ortam değişkenlerinizde EXECUTIONS_TIMEOUT değerini ayarlayın.

Hata: Yüksek bellek kullanımı veya bellek yetersizliği (OOM) nedeniyle işlem sonlanır.

Nedeni: Mevcut kapasite için çok fazla eş zamanlı işlem gerçekleştiriliyor. RAMveya bir Kod düğümünde bellek sızıntısı.

Düzeltme sırası: Eşzamanlılık sınırı ile kuyruk modunu etkinleştirin. Kod düğümlerinde sonsuz döngüleri kontrol edin. Yürütme verisi budamasını etkinleştirin. VPS'yi yükseltin. RAM Yukarıdakilerin hepsi zaten mevcutsa.

Hata: Web kancaları tetiklenmiyor

Nedeni: WEBHOOK_URL ortam değişkeni eksik veya yanlış ayarlanmış.

Fix:

docker compose exec n8n env | grep WEBHOOK

Çıktıda, örneğin sonunda eğik çizgi bulunan tam genel HTTPS URL'niz görünmelidir. https://yourdomain.com/Sondaki eğik çizgi olmadan, n8n harici servislerin erişemeyeceği hatalı webhook URL'leri oluşturur.

SSS

Sonuç

n8n'i bir VPS üzerinde barındırmak, ciddi otomasyon altyapısını çalıştırmanın en uygun maliyetli ve esnek yollarından biridir. Kurulum tamamen basittir. manageDoğru yapıldığında mümkündür ve gerekli yapılandırma çalışması, yıllarca fayda sağlayan tek seferlik bir yatırımdır.

Gerçek dünyada en büyük hasara yol açan üç hata şunlardır: yük altında çöken yetersiz VPS özellikleri, kimlik bilgilerinizin internete açık hale gelmesine neden olan HTTPS ve kimlik doğrulama eksikliği ve arızaların günlerce tespit edilememesine izin veren izleme eksikliği.

Önce bu üçünü düzeltin. Ardından tüm kontrol listesini tamamlayın: Docker tabanlı kurulum, PostgreSQL veritabanı, otomatik yedeklemeler, eşzamanlı iş akışları için kuyruk modu ve eksiksiz ortam değişkeni yapılandırması. Her adım, dayanıklı, güvenli ve ölçeklenebilir bir otomasyon platformu oluşturmak için bir öncekine dayanır.

Bunu doğru bir şekilde yapmak için gereken yapılandırma işlemi, temiz bir sunucuda yaklaşık 4 saat sürer. Bu 4 saatlik yatırım, otomasyona bağımlı işletmelerin göze alamayacağı türden gece 3'te meydana gelen üretim arızalarını ortadan kaldırır.

Kurulum süresini önemli ölçüde azaltmak istiyorsanız, YouStablen8n VPS Hosting, altyapı katmanını sizin için halleder. Planlar, Node.js, PM2, Docker desteği ve ücretsiz özelliklerle önceden yapılandırılmış olarak gelir. SSLAyrıca haftalık otomatik yedeklemeler de mevcuttur. 7/24 insan destek ekibi (botlar değil), n8n'e özgü yapılandırma sorularında yardımcı olabilir; bu da altyapı hata ayıklaması için daha az zaman harcamanız ve önemli otomasyonları oluşturmak için daha fazla zaman ayırmanız anlamına gelir.

Keşfet YouStable n8n VPS Hosting Planları

Bu makale, Ubuntu 22.04 üzerinde n8n v1.x ile yapılan uygulamalı test ve üretim ortamına dağıtım deneyimini yansıtmaktadır. Tüm komutlar ve yapılandırma örnekleri Mayıs 2026 itibarıyla doğrulanmıştır. En güncel n8n yapılandırma referansı için, docs.n8n.io adresindeki resmi n8n belgelerine başvurunuz.