Workflow'ları test etmek: Pin Data, Mock Data, Debug modu
n8n'de Pin Data, Mock Data ve Debug modu: workflow'ları üretim sistemlerine karşı canlı olarak değil, sabitlenmiş test verileriyle nasıl test edersin.
Bellekteki veya veritabanındaki ikili veriler n8n'i yavaşlatır. Filesystem ve S3 modu, doğru değişkenlerle bu sorunu çözer.
Bir n8n workflow'u PDF, görsel veya başka dosyalar işlediğinde, n8n bu ikili verileri bir sonraki node'a aktarmadan önce bir yerde geçici olarak depolamak zorundadır. Açık bir yapılandırma olmadan bu veriler belleğe veya çalışma moduna bağlı olarak doğrudan veritabanına düşer, bu da büyük dosyalarda veya çok sayıda paralel çalıştırmada hızla bellek sorunlarına ve şişmiş bir veritabanına yol açar. n8n'in resmi dokümantasyonundaki Büyük ölçekte ikili veri işleme bu nedenle üretim ortamındaki örnekler için filesystem moduna veya self-hosted enterprise lisanslarında harici S3 depolamaya geçilmesini önerir. Güncelleme tarihi: Temmuz 2026.
n8n varsayılan olarak ikili verileri bellekte tutar; bu da dokümantasyona göre büyük dosyalarda çökmelere yol açabilir. Bir örnek birden fazla worker ile queue modunda çalışıyorsa, n8n filesystem modunu desteklemez ve ikili veriler bunun yerine veritabanı modunda saklanmak zorundadır. Sorun şu: ilişkisel bir veritabanı çok sayıda küçük, yapılandırılmış satır için tasarlanmıştır, büyük ikili blob'lar için değil. Depolanan dosyalar büyüdükçe veritabanı da belirgin şekilde büyür, bu da yedeklemeleri, replikasyonu ve normal sorguları yavaşlatır. İşte tam bu noktada filesystem veya S3 depolamaya geçiş devreye girer.
Queue modu dışındaki self-hosted n8n örnekleri için filesystem modu en basit çözümdür. N8N_DEFAULT_BINARY_DATA_MODE ortam değişkeni filesystem değeriyle etkinleştirilebilir, böylece n8n ikili verileri bellek yerine diske yazar. Depolama konumu N8N_BINARY_DATA_STORAGE_PATH ile özelleştirilebilir, varsayılan olarak N8N_USER_FOLDER/binaryData altında bulunur. Ayrıca N8N_AVAILABLE_BINARY_DATA_MODES, hangi modların genel olarak kullanılabilir olduğunu, filesystem varsayılan değeriyle virgülle ayrılmış bir liste olarak tanımlar. Tüm değişkenlerle ilgili ayrıntılar n8n'in ikili veriler için ortam değişkenleri dokümantasyonunda listelenmiştir. Operatörler için önemli: örnek queue modunda çalışıyorsa, dokümantasyona göre bu yöntem kullanılamaz, geriye yalnızca veritabanı modu veya S3 kalır.
n8n'i daha büyük ölçekte işleten veya birden fazla worker örneğine dayanan kişiler, ikili verileri S3 uyumlu bir nesne depolamada saklayabilir. Bu mod, n8n'in harici depolama dokümantasyonuna göre yalnızca Self-Hosted Enterprise planlarında kullanılabilir ve geçerli bir Enterprise lisans anahtarı gerektirir; bu olmadan örnek S3 modunda hiç başlamaz. Yapılandırma birden fazla değişken üzerinden yapılır.
Mod, N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3 ile birlikte N8N_DEFAULT_BINARY_DATA_MODE=s3 üzerinden etkinleştirilir ve ardından örnek yeniden başlatılır. İkili veriler daha sonra bucket içinde workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId} yapısında saklanır.
Geçiş öncesinde, gerekli S3 eylemleri için IAM politikasıyla birlikte bucket'ı kurmalı ve eski ikili verileri otomatik olarak silen bir lifecycle kuralı belirlemelisiniz, çünkü dokümantasyona göre n8n bu temizliği otomatik olarak üstlenmez. Kolayca gözden kaçan bir başka nokta: ikili verilerin pruning işlemi her zaman yalnızca o anda etkin olan modu etkiler. Veritabanı modundan filesystem veya S3 moduna geçerseniz, eski ikili veriler önceki depolama konumunda kalır ve ayrıca temizlenmesi gerekir. Büyüyen veri hacmiyle bir n8n örneğini üretimde işleten kişi, veritabanı belirgin şekilde yavaşladığında tepki vermek yerine bu geçişi erkenden planlamalıdır. NordFlux, n8n kurulumu konusunda, gerçek veri hacmine uygun bir depolama yapılandırması dahil olmak üzere destek sağlar.
Filesystem modu ikili verileri n8n sunucusunun yerel diskine yazar ve queue modunda çalışmayan tekil örnekler için uygundur. S3 modu ise verileri harici bir nesne depolamaya taşır ve birden fazla worker içeren dağıtık kurulumlar için tasarlanmıştır, ancak bunun için bir self-hosted enterprise lisansı gerektirir.
Evet. n8n dokümantasyonuna göre, geçerli bir enterprise lisans anahtarı olmadan örnek S3 modunda başlamaz. Queue modunda çalışmayan daha küçük kurulumlar için genellikle ücretsiz filesystem modu yeterlidir.
Hayır. n8n, filesystem modunu queue moduyla birlikte desteklemez. Birden fazla worker'a sahip operatörler bunun yerine ya veritabanı modunu ya da uygun lisansla S3 modunu kullanmalıdır.
Otomatik olarak taşınmaz veya silinmezler. Pruning her zaman yalnızca o anda ayarlı olan modda çalışır, bu nedenle önceki depolama konumundaki eski dosyalar olduğu gibi kalır ve manuel olarak temizlenmesi gerekir.
NordFlux, kuruluşlar için dijital çalışanlar kurar: tekrar eden işleri üstlenen otomasyonlar ve KI ajanları. Kontrol sizde kalır.
n8n'de Pin Data, Mock Data ve Debug modu: workflow'ları üretim sistemlerine karşı canlı olarak değil, sabitlenmiş test verileriyle nasıl test edersin.
n8n ikili verileri RAM'de tutar: 100 PDF sunucunun çökmesine neden olabilir. Filesystem modu veya S3 modu, bellek patlamasına karşı böyle yardımcı olur.
n8n veritabanının executionlar nedeniyle neden büyüdüğü ve EXECUTIONS_DATA_PRUNE, saklama süresi ile limitlerin veri miktarını nasıl otomatik olarak sınırladığı.
Filesystem veya S3 depolamaya geçmek veritabanını rahatlatır, ancak yedekleme, saklama süresi ve erişim hakları konusunda yeni sorular doğurur. NordFlux'un yönetilen n8n hosting'inde binary data modu, pruning ve yedekleme stratejisi dahil, ilk günden doğru yapılandırılır. Kurulumunuzun bugünkü durumuna memnuniyetle birlikte bakarız.