İçeriğe geç
zefıly
← Tüm yazılar

n8n'i kendi sunucunuzda çalıştırmak: Docker, HTTPS ve yedekler

5 dk okuma

n8n bir VPS'te Docker ile nasıl çalıştırılır. Webhook'ların ihtiyaç duyduğu ayarlar, kaybetmemeniz gereken şifreleme anahtarı, ters vekil yapılandırması, bellek kullanımı, yedekler ve güncellemeler. n8n 2.47 ile denendi.

n8n, kendiniz çalıştırabileceğiniz bir iş akışı otomasyon aracıdır. Kendi sunucunuzda iş akışı ya da çalıştırma sınırı yoktur ve kimlik bilgileriniz sizde kalır. Bedeli, onu sizin işletmenizdir: HTTPS, yedekler ve güncellemeler sizin işinizdir.

Buradaki komutları 12 Kasım 2026'da resmi imajla denedik; o gün imaj n8n 2.47.5 idi.

Kısaca

  • Tek kapsayıcı, tek birim. n8n her şeyi /home/node/.n8n içinde, varsayılan olarak SQLite'ta tutar.
  • WEBHOOK_URL değerini genel adresinize ayarlayın; yoksa webhook'lar yanlış adres gösterir.
  • N8N_ENCRYPTION_KEY değerini kendiniz belirleyin ve bir kopyasını saklayın. Onsuz kayıtlı kimlik bilgileri okunamaz.
  • Bellek ayırın: boşta duran kapsayıcımız yaklaşık 520 MB kullandı.
  • HTTPS'li bir ters vekilin arkasına koyun ve sahip hesabını başkasından önce oluşturun.

1. Sunucunun ihtiyacı

2 GB bellekli bir VPS makul bir alt sınırdır; n8n bir Node.js uygulamasıdır ve denememizde tek bir iş akışı çalıştırmadan yaklaşık 520 MB kullandı. Docker (ya da Podman), sunucuyu gösteren bir alan adı ve HTTPS için bir web sunucusu gerekir.

2. Kapsayıcıyı başlatın

docker volume create n8n_data

docker run -d --name n8n --restart unless-stopped \
  -p 127.0.0.1:5678:5678 \
  -e N8N_HOST=n8n.example.com \
  -e N8N_PROTOCOL=https \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e GENERIC_TIMEZONE=Europe/Istanbul \
  -e N8N_ENCRYPTION_KEY=<uzun rastgele bir dizge> \
  -v n8n_data:/home/node/.n8n \
  docker.io/n8nio/n8n:2.47.5

Üç ayrıntı önemlidir:

  • 127.0.0.1:5678, yalnızca 5678 değil. Kapsayıcıya sadece sunucunun kendisinden erişilir; HTTPS'i öndeki web sunucusu ekler. Portu internete açmak n8n'i şifrelemesiz yayınlar.
  • Sabit sürüm etiketi. :latest siz farkında olmadan değişir. Sürümü sabitleyin ve bilerek güncelleyin.
  • WEBHOOK_URL. n8n vekilin arkasında çalışır ve genel adresini bilemez. Bu ayar olmadan gösterdiği webhook adresleri http://localhost:5678 ile başlar.

Çalıştığını kontrol edin:

curl http://127.0.0.1:5678/healthz
{"status":"ok"}

3. Şifreleme anahtarı

n8n, kaydettiğiniz kimlik bilgilerini (API anahtarları, parolalar, OAuth belirteçleri) tek bir anahtarla şifreler. N8N_ENCRYPTION_KEY vermezseniz n8n ilk başlangıçta bir anahtar üretir ve veri birimindeki config dosyasına yazar.

Anahtarı kendiniz belirleyin ve sunucunun dışında bir kopyasını saklayın. Anahtar kaybolur ya da değişirse kayıtlı bütün kimlik bilgileri okunamaz olur ve hepsini yeniden girersiniz.

Şununla üretebilirsiniz:

openssl rand -hex 32

4. Ters vekil

n8n'in düzenleyicisi sunucuyla kalıcı bir bağlantı kullanır; vekil WebSocket yükseltmelerini geçirmelidir. nginx için:

server {
    server_name n8n.example.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

Sonra bir sertifika alın; örneğin Certbot ile.

5. İlk ziyaret

Siteyi açın ve kurulum ekranında sahip hesabını oluşturun. Bunu hemen yapın: sahip oluşturulana kadar adresi ilk açan kişi sahip olur.

Düzenleyiciyi yalnızca siz ve ekibiniz kullanıyorsa daha da kısıtlayın: yalnızca kendi IP adreslerinize izin verin ya da önüne parola koyun. Webhook'lar erişilebilir kalmalıdır; /webhook/ yolunu değil, düzenleyici yollarını kısıtlayın.

6. Birimde neler var

config  database.sqlite  ...
  • database.sqlite: iş akışları, kimlik bilgileri (şifreli), çalıştırma geçmişi.
  • config: ayarlar; n8n ürettiyse şifreleme anahtarı da buradadır.

Kapsayıcı node kullanıcısıyla (uid 1000) çalışır. Birim yerine sunucudaki bir dizini bağlarsanız dizin bu uid'e ait olmalıdır; yoksa n8n izin hatasıyla durur.

SQLite, orta düzeyde kullanılan tek bir kurulum için yeterlidir. Dakikada çok sayıda çalıştırma için n8n PostgreSQL'i destekler.

7. Yedekler

Birimi ve şifreleme anahtarınızı yedekleyin. Tutarlı bir kopya için kapsayıcıyı kısa süre durdurun:

docker stop n8n
docker run --rm -v n8n_data:/data -v "$PWD":/backup alpine \
  tar czf /backup/n8n-$(date +%F).tar.gz -C /data .
docker start n8n

Arşivi sunucunun dışına kopyalayın. Çalıştırma geçmişi veritabanını büyütür; diski doldurmaması için n8n ayarlarından bir saklama süresi belirleyin.

8. Güncellemeler

docker pull docker.io/n8nio/n8n:<yeni sürüm>
docker stop n8n && docker rm n8n
# aynı docker run komutunu yeni etiketle çalıştırın

Veri birimde kalır. Yeni sürüm başlarken n8n veritabanını kendisi taşır. Önce yedek alın ve yeni bir ana sürümden önce sürüm notlarını okuyun: uyumluluğu bozan değişiklikler orada listelenir.

Zefily ile

n8n, Zefily'de tek tıkla kurulan bir uygulamadır. Sitenin kendi Linux kullanıcısı altında, yetkisiz (rootless) bir kapsayıcı olarak 127.0.0.1 üzerinde, HTTPS'li web sunucusunun arkasında çalışır. Zefily N8N_HOST, WEBHOOK_URL ve üretilmiş bir N8N_ENCRYPTION_KEY değerini sizin için ayarlar, veriyi güncellemelerden etkilenmeyen bir birimde tutar ve siz sahip hesabını oluşturana kadar bir İlk adım bildirimi gösterir. Konteyner uygulamaları belgesine bakın.

Sık sorulan sorular

n8n ne kadar bellek ister?

Denememizde boşta duran bir n8n 2.47.5 kapsayıcısı yaklaşık 520 MB kullandı. 2 GB bellekli bir sunucu makul bir alt sınırdır.

n8n webhook adreslerim neden localhost gösteriyor?

Çünkü n8n vekilin arkasında genel adresini bilmez. WEBHOOK_URL değerini https adresinize ayarlayın ve kapsayıcıyı yeniden başlatın.

n8n şifreleme anahtarını kaybedersem ne olur?

Kayıtlı kimlik bilgileri artık çözülemez ve yeniden girilmeleri gerekir. N8N_ENCRYPTION_KEY değerini kendiniz belirleyin ve sunucu dışında bir kopyasını saklayın.

n8n verisini nerede tutar?

Kapsayıcının içindeki /home/node/.n8n dizininde: iş akışları, kimlik bilgileri ve çalıştırma geçmişiyle database.sqlite ve config dosyası.

n8n veritabanı sunucusu ister mi?

Hayır. Varsayılan olarak SQLite kullanır. Daha büyük kurulumlar için PostgreSQL desteklenir.

Zefily ile kendi imajlarınızı çalıştırmak için Konteynerler belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →