n8n Queue Mode: Redis ve worker'larla ölçeklendirme

n8n Queue Mode, kendi sunucunuzda barındırılan n8n kurulumları için bir yürütme modudur; bu modda ana instance workflow'ları artık kendisi yürütmez, bunun yerine yürütme görevlerini bir Redis kuyruğu üzerinden ayrı worker süreçlerine dağıtır. Mod, ana ve worker instance'larında EXECUTIONS_MODE=queue ortam değişkeni ile etkinleştirilir; veritabanı olarak n8n, SQLite yerine Postgres'i önerir. Queue Mode, yüksek webhook yükü veya çok sayıda paralel yürütme durumunda anlamlıdır; günlük az sayıda çalıştırmaya sahip küçük kurulumlar için ise genellikle gereksiz bir altyapı yüküdür. Güncelleme: Temmuz 2026.

n8n Queue Mode teknik olarak nasıl çalışır?

Ana instance, tetikleyicileri, webhook çağrılarını ve arayüzü üstlenir, ancak Queue Mode'da workflow'ları artık kendisi yürütmez; bunun yerine bir yürütme ID'si oluşturur ve bunu bir Redis kuyruğuna yerleştirir. Uygun bir worker, görevi bu kuyruktan alır, workflow ayrıntılarını yürütme ID'si üzerinden veritabanından yükler, workflow'u yürütür ve sonucu veritabanına geri yazar. Redis, tamamlanmayı ana instance'a geri bildirir. Worker'lar, birbirine paralel çalışan ve ayrı ayrı başlatılan bağımsız Node.js süreçleridir, örneğin n8n worker komutu üzerinden. n8n bu sürecin ayrıntılarını Enable queue mode kılavuzunda açıklar.

Queue Mode gerçekten ne zaman gereklidir?

Queue Mode, tek bir n8n instance'ı sınırlarına ulaştığında, örneğin çok sayıda webhook aynı anda geldiğinde veya birden fazla workflow'un birbirini yavaşlatmadan paralel çalışması gerektiğinde değerlidir. Queue Mode olmadan varsayılan yapılandırmada n8n, eşzamanlı üretim yürütmelerinin sayısını kendiliğinden sınırlamaz; bu da yüksek yük altında event loop'un aşırı yüklenmesine ve instance'ın yavaş tepki vermesine yol açabilir. Queue Mode ile bu yükü birden fazla worker'a dağıtırsınız ve tek bir instance'ı dikey olarak ölçeklendirmek yerine, artan talep durumunda kolayca yeni worker'lar ekleyebilirsiniz. Queue Mode ayrıca birden fazla ana instance ile yüksek erişilebilirlik için de bir ön koşuldur; ancak bu multi-main kurulumu bir Enterprise özelliğidir.

Queue Mode kurulumunuz için ne zaman gereksizdir?

Birkaç düzine otomasyona ve günde yönetilebilir sayıda yürütmeye sahip çoğu küçük ve orta ölçekli işletme için Queue Mode olmadan tek bir n8n instance'ı tamamen yeterlidir. Redis, birden fazla worker konteyneri ve ek izleme kurmak yerine, yaklaşan aşırı yüklenme genellikle N8N_CONCURRENCY_PRODUCTION_LIMIT ortam değişkeniyle önlenebilir; bu değişken, ayrı bir kuyruk altyapısına gerek kalmadan tek bir instance üzerindeki paralel üretim yürütmelerini sınırlar. Redis veya ek worker süreçleri gibi her ek bileşen, izlenmesi, güncellenmesi ve hata durumunda onarılması gereken ek bir parçadır. Yalnızca ara sıra form verisi işleyen, günlük raporlar gönderen veya bir CRM'i senkronize eden biri, Queue Mode'dan hissedilir bir avantaj elde etmez, ancak önemli ölçüde daha fazla işletim yükü elde eder.

Kurulum sırasında teknik olarak nelere dikkat etmelisiniz?

Üretimde bir Queue Mode işletimi için n8n'e göre message broker olarak ortak bir Redis instance'ı ile veritabanı olarak Postgres kesinlikle gereklidir; SQLite dağıtık işletim için önerilmez. N8N_ENCRYPTION_KEY şifreleme anahtarı, ana instance'da ve tüm worker instance'larında aynı şekilde ayarlanmalıdır, aksi takdirde worker'lar kayıtlı kimlik bilgilerinin şifresini çözemez. Her worker varsayılan olarak aynı anda en fazla on işi paralel olarak işler, bu --concurrency bayrağı üzerinden kontrol edilebilir; n8n, bu değerin çok düşük ayarlanmamasını önerir, aksi takdirde çok sayıda worker olduğunda veritabanının bağlantı havuzu tükenebilir. Ayrıca Queue Mode'un ikili verileri ilgili worker'ın yerel dosya sisteminde depolayamayacağı da önemlidir; bunun için S3 gibi harici bir depolama öngörülmüştür. n8n, ortam değişkenlerinin tam listesini Queue mode environment variables altında sunar.

Kendi n8n kurulumunun gerçekten Queue Mode'a ihtiyaç duyup duymadığından veya tek, düzgün yapılandırılmış bir instance ile yetinip yetinemeyeceğinden emin olmayanlar, bunu en iyi şekilde teknik bir durum tespiti kapsamında, örneğin NordFlux'un n8n danışmanlığı kapsamında kontrol ettirebilir.

n8n Queue Mode hakkında sık sorulan sorular

n8n Queue Mode için kesinlikle Redis'e ihtiyacım var mı?

Evet, Redis, Queue Mode'da mimarinin sabit bir parçasıdır ve worker'ların görevlerini aldığı kuyruğu yönetir. Çalışan bir Redis instance'ı olmadan ana instance ve worker'lar birbirleriyle iletişim kuramaz, bu nedenle Queue Mode Redis olmadan işletilemez.

Queue Mode'u veritabanı olarak SQLite ile kullanabilir miyim?

Hayır, Queue Mode için n8n, sürüm 13'ten itibaren Postgres'i önerir; SQLite bu dağıtık işletim için önerilmez. Birden fazla worker aynı anda aynı veritabanına okuma ve yazma erişimi sağladığından, Postgres gibi bunun için tasarlanmış bir sunucu veritabanı daha mantıklı bir seçimdir.

Kaç worker planlamalıyım?

Genel bir referans değer yoktur; her worker varsayılan olarak aynı anda en fazla on işi işler, bu --concurrency bayrağı üzerinden yapılandırılabilir. Baştan çok sayıda worker başlatmak yerine, bir veya iki worker ile başlamak ve yük arttıkça hedefli şekilde daha fazla eklemek daha mantıklıdır.

Queue Mode'da dosyalara ve eklere ne olur?

Yüklenen dosyalar gibi ikili veriler, Queue Mode'da bir worker'ın yerel dosya sisteminde depolanamaz, çünkü bir sonraki işleme adımı başka bir worker üzerinde çalışabilir. Bunun yerine, tüm worker'ların aynı ikili verilere erişebilmesi için S3 gibi harici bir depolama entegre edilmelidir.