İçeriğe geç
  • Hafta içi 08:00 – 18:00 · Destek 7/24
  1. Ana Sayfa
  2. Blog
  3. Barındırma

n8n kurulumu: Docker Compose ile kendi sunucunuzda, HTTPS'li ve kalıcı

n8n'i kendi VDS'inizde çalıştırmak: Docker Compose dosyası, otomatik sertifikalı ters vekil, kaybedilmemesi gereken şifreleme anahtarı, webhook adresinin neden ayrıca tanımlanması gerektiği ve yedekleme.

Sunucuda birbirine bağlı otomasyon adımlarını ve dışarı açılan güvenli kapıyı anlatan izometrik çizim

n8n, farklı servisleri birbirine bağlayıp iş akışları kuran bir otomasyon aracıdır: bir formdan gelen kaydı veritabanına yazmak, gelen e-postayı işleyip bildirim göndermek, zamanlanmış raporlar üretmek gibi işleri kod yazmadan ya da az kodla kurarsınız. Bulut sürümü yerine kendi sunucunuzda çalıştırmanın iki gerekçesi olur: verilerin kendi sunucunuzda kalması ve akış sayısına göre artan abonelik yerine sabit bir sunucu maliyeti. Bu rehberdeki kurulum bir deneme VDS'inde uçtan uca çalıştırıldı.

Ne gerekiyor?

  • Kök erişimli bir sunucu. 1 GB bellek çalışır ama rahat değildir; birkaç eşzamanlı akış için 2 GB ve 2 çekirdek makul bir başlangıçtır.
  • Sunucunun IP adresini gösteren bir alan adı (ör. otomasyon.ornek.com için bir A kaydı). Kaydın yayıldığını DNS sorgulama aracıyla doğrulayabilirsiniz.
  • Docker ve Docker Compose. Kurulumu ve güvenlik duvarı ayarlarını Ubuntu'da Docker kurulumu yazısında anlatıyoruz.
  • 80 ve 443 portlarının dışarı açık olması. Sertifika doğrulaması 80 portundan yapılır.

1. Dizin ve ayarlar

Kurulumu tek bir dizinde toplayın; böylece yedekleme ve taşıma tek dizinin işi olur.

mkdir -p /srv/n8n && cd /srv/n8n

Ayarları ayrı bir .env dosyasına yazın. Şifreleme anahtarını burada bir kez üretip sabitlemek önemlidir:

cat > .env <<EOF
AD=otomasyon.ornek.com
TZ=Europe/Istanbul
N8N_SIFRELEME=$(openssl rand -hex 24)
EOF
chmod 600 .env

N8N_SIFRELEME değeri, n8n'in bağlı servislere ait kimlik bilgilerini şifrelediği anahtardır. Siz tanımlamazsanız n8n ilk açılışta kendisi üretir ve veri biriminin içine yazar; birimi kaybederseniz ya da başka bir sunucuya düzgün taşımazsanız tüm kayıtlı bağlantılar çözülemez hâle gelir. Bu yüzden anahtarı siz üretin, .env dosyasını yedekleyin ve bir kopyasını sunucunun dışında saklayın.

2. Compose dosyası: n8n + otomatik HTTPS

n8n'i doğrudan internete açmak yerine önüne bir ters vekil koyun. Caddy'yi tercih ettik; sertifikayı kendisi alır ve yeniler, ek yapılandırma istemez.

services:
  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports: ["80:80", "443:443"]
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
    depends_on: [n8n]

  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    environment:
      - N8N_HOST=${AD}
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://${AD}/
      - N8N_ENCRYPTION_KEY=${N8N_SIFRELEME}
      - GENERIC_TIMEZONE=${TZ}
      - N8N_PORT=5678
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  caddy_data:
  n8n_data:

Caddy yapılandırması tek satırdır:

otomasyon.ornek.com {
    reverse_proxy n8n:5678
}

Dikkat edilecek üç nokta var. Birincisi, n8n hiçbir port yayımlamıyor: yalnız Caddy 80 ve 443'ü açar, n8n'e sadece aynı Docker ağından, servis adıyla (n8n:5678) erişilir. Bu, Docker'ın güvenlik duvarını delme sorununu baştan ortadan kaldırır. İkincisi, veriler n8n_data birimindedir; konteyner silinse de kalır. Üçüncüsü WEBHOOK_URL: n8n, ters vekil arkasında kendi dış adresini bilemez ve bu değişken olmadan webhook adreslerini iç adresle üretir. Dışarıdan tetiklenen akışlarınız çalışmıyorsa ilk bakılacak yer burasıdır.

3. Çalıştırma ve doğrulama

ufw allow 80/tcp && ufw allow 443/tcp
docker compose up -d
docker compose ps

İlk açılışta Caddy sertifikayı alırken birkaç saniye gecikme olur. Deneme kurulumumuzda yaklaşık 45 saniye sonra her iki servis de running durumundaydı ve n8n sürümü 2.43.7 olarak göründü. Dışarıdan yapılan istek, geçerli bir Let's Encrypt sertifikasıyla 200 döndü:

curl -o /dev/null -w "%{http_code}\n" https://otomasyon.ornek.com/
200

Sertifikanın zincirini ve bitiş tarihini SSL sertifika kontrolü aracıyla da görebilirsiniz. Tarayıcıdan adresi açtığınızda n8n sizi ilk kurulum ekranına alır; burada oluşturduğunuz hesap yönetici hesabıdır. Bu ekranı tamamlamadan adresi açık bırakmayın.

Bir şey çalışmazsa günlüklere bakın:

docker compose logs -f n8n
docker compose logs caddy | tail -20

Sertifika alınamıyorsa sebep neredeyse her zaman aynıdır: alan adı sunucunun IP adresini göstermiyordur ya da 80 portu dışarıdan kapalıdır.

4. Kurulumdan sonra üç ayar

Zaman dilimi

Zamanlanmış akışlar GENERIC_TIMEZONE değerine göre çalışır. Tanımlamazsanız n8n UTC kullanır ve "her gün 09:00" dediğiniz akış Türkiye saatiyle 12:00'de çalışır. Yukarıdaki dosyada bu değer .env içinden geliyor.

Veritabanı

Varsayılan kurulum veriyi birim içindeki bir SQLite dosyasında tutar; tek kullanıcılı ve orta yoğunluktaki kurulumlar için yeterlidir. Çok sayıda eşzamanlı akış çalıştıracaksanız PostgreSQL'e geçmek daha sağlıklıdır; bu durumda compose dosyasına bir postgres servisi ekleyip n8n'e veritabanı değişkenlerini verirsiniz. Geçişi baştan yapmak, sonradan veri taşımaktan kolaydır.

Yedekleme

Yedeklenmesi gereken iki şey var: .env dosyası (şifreleme anahtarı) ve n8n_data birimi (akışlar, kimlik bilgileri, çalışma geçmişi). Birimi dosyaya almak için:

docker run --rm -v n8n_n8n_data:/veri -v /srv/yedek:/yedek alpine \
  tar czf /yedek/n8n-$(date +%F).tar.gz -C /veri .

Birim adı, compose projesinin adıyla öneklenir; docker volume ls ile doğrulayın. Bu yedeği düzenli alın ve en az bir kopyasını sunucunun dışında tutun; geri dönüşü bir kez prova etmeden yedeği çalışıyor saymayın. 3-2-1 kuralı yazısındaki prova adımları bu birim için de geçerlidir.

Güncelleme

cd /srv/n8n
docker compose pull
docker compose up -d

Veriler birimde durduğu için güncelleme sırasında kaybolmaz. Yine de üretimde kullandığınız bir kurulumda önce yedek alın. latest etiketi yerine sürüm numarası sabitlemek (n8nio/n8n:2.43.7 gibi) güncellemeyi bilinçli bir karara dönüştürür; beklenmedik bir ana sürüm geçişiyle akışlarınızın bozulmasını önler.

Çalışma geçmişi diski doldurur

n8n her akış çalıştırmasının ayrıntılarını veritabanına yazar: hangi düğüm hangi veriyle çalıştı, ne döndü. Bu, hata ayıklarken çok değerlidir ve sessizce büyür. Dakikada bir çalışan ve her seferinde veri işleyen bir akış, birkaç hafta içinde veritabanını gigabaytlara çıkarabilir. Kurulumda sınır koyun:

- EXECUTIONS_DATA_PRUNE=true
- EXECUTIONS_DATA_MAX_AGE=168
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000

Bu üç değişken sırasıyla temizliği açar, kayıtları 168 saat (bir hafta) sonra siler ve toplam kayıt sayısına üst sınır koyar. Hata ayıklamak için bir haftalık geçmiş çoğu durumda fazlasıyla yeterlidir. Akış düzeyinde de ayar yapılabilir: başarılı çalıştırmaların verisini hiç saklamayıp yalnız hataları tutmak, hem yer kazandırır hem de kişisel veri saklama süresini kısaltır.

Kaynak: bellek ve eşzamanlılık

n8n, Node.js üzerinde çalışır ve bellek tüketimi işlediğiniz veriye göre değişir. Birkaç yüz satırlık verilerle çalışan akışlar için 2 GB bellekli bir sunucu rahat eder; büyük dosyalar indiren, binlerce satırlık tabloları belleğe alan ya da ikili veri işleyen akışlar belleği hızla tüketir. Bir akış tek seferde çok büyük bir veri kümesini işliyorsa, onu parçalara bölen düğümler kullanmak sunucuyu büyütmekten daha etkili bir çözümdür.

Varsayılan kurulumda akışlar aynı süreç içinde çalışır. Yoğun kullanımda n8n ayrı işçi süreçleriyle (queue kipi) çalıştırılabilir; bu kurulum bir kuyruk servisi ekler ve akışları birden çok işçiye dağıtır. Buna geçmeden önce basit bir ölçüm yapın: hangi akışın ne kadar sürdüğünü ve belleği ne kadar kullandığını docker stats ile izleyin. Çoğu kurulumda darboğaz n8n değil, bağlandığınız dış servisin hız sınırıdır.

İlk akışı kurarken üç pratik not

  • Kimlik bilgilerini akışın içine yazmayın. n8n'in kimlik bilgisi (credentials) bölümünü kullanın; bunlar şifrelenerek saklanır ve akışı dışa aktardığınızda içine gömülmez.
  • Webhook ile zamanlanmış tetikleyiciyi karıştırmayın. Webhook, dışarıdan bir isteğin akışı tetiklemesidir ve adresinin doğru üretilmesi için yukarıdaki WEBHOOK_URL ayarına bağlıdır. Zamanlanmış akışlar ise sunucunun saatine ve GENERIC_TIMEZONE değerine göre çalışır.
  • Hata yolunu baştan kurun. Dış servise bağlanan her akış bir gün hata verecektir. n8n'de bir hata akışı tanımlayıp kendinize bildirim göndermek, sessizce çalışmayı bırakan bir otomasyondan çok daha iyidir.

Güvenlik notları

  • n8n arayüzü, bağlı tüm servislerin kimlik bilgilerini taşır; yönetici parolası güçlü olmalıdır. Rastgele parola için şifre oluşturucu kullanabilirsiniz.
  • Yalnız siz kullanacaksanız arayüzü büsbütün internete açmak yerine ters vekilde IP kısıtı ya da ek kimlik doğrulaması koyabilirsiniz. Webhook uçlarının dışarı açık kalması gerektiğini unutmayın.
  • Sunucunun temel sertleştirmesini atlamayın; n8n'i çalıştıran makine aynı zamanda tüm entegrasyonlarınızın anahtarlarını tutar.

Sık sorulan sorular

n8n'i kendi sunucumda çalıştırmak ücretsiz mi?

n8n'in kendi sunucunuzda çalıştırdığınız sürümü kaynak kodu açık bir lisansla dağıtılır ve kendi iç kullanımınız için ücretsizdir; yalnız sunucu maliyetini ödersiniz. Lisans, n8n'i bir hizmet olarak başkalarına satmak gibi kullanımları sınırlar; ticari bir ürünün parçası yapacaksanız yürürlükteki lisans metnini okuyun.

N8N_ENCRYPTION_KEY nedir, kaybedersem ne olur?

n8n, bağlı servislerin kimlik bilgilerini bu anahtarla şifreleyip veritabanına yazar. Anahtar kaybolursa kayıtlı tüm kimlik bilgileri çözülemez ve her bağlantıyı yeniden girmeniz gerekir. Anahtarı kurulumda siz üretip sabitleyin ve yedeklerinizden ayrı bir yerde saklayın.

n8n webhook adresleri neden yanlış çıkıyor?

n8n, dışarıya vereceği adresi kendi başına bilemez; ters vekil arkasında çalışırken WEBHOOK_URL ve N8N_HOST değişkenleri tanımlı değilse konteynerin iç adresini ya da localhost yazar. Bu değişkenleri alan adınızla tanımlayın ve n8n'i yeniden başlatın.

n8n'i nasıl güncellerim?

docker compose pull ile yeni imajı indirip docker compose up -d ile konteyneri yeniden oluşturursunuz; veriler birimde durduğu için korunur. Güncellemeden önce veri birimini yedekleyin ve sürüm notlarını okuyun; ana sürüm atlamalarında akışlarda değişiklik gerekebilir.

n8n için ne kadar RAM gerekir?

Birkaç yüz satırlık verilerle çalışan akışlar için 2 GB bellekli bir sunucu rahat eder. Büyük dosyalar indiren, binlerce satırlık tabloları belleğe alan ya da ikili veri işleyen akışlar belleği hızla tüketir; bu durumda veriyi parçalara bölen düğümler kullanmak çoğu zaman sunucuyu büyütmekten daha etkilidir.

n8n verilerini başka sunucuya nasıl taşırım?

İki şeyi taşırsınız: veri birimi (akışlar, kimlik bilgileri, geçmiş) ve şifreleme anahtarı. Anahtarı taşımadan birimi kopyalarsanız akışlar gelir ama kayıtlı kimlik bilgileri çözülemez. Yeni sunucuda aynı N8N_ENCRYPTION_KEY değerini tanımlayıp birimi geri yükleyin, sonra alan adını yeni sunucuya yönlendirin.

  • #n8n
  • #docker
  • #otomasyon
  • #self-hosted

Otomasyonlarınızı kendi sunucunuzda mı çalıştırmak istiyorsunuz? VDS paketlerimizde kök erişimi sizdedir; Docker ve n8n sürümünü siz belirlersiniz.

VDS paketlerine bakın
Devamı

İlgili yazılar