İkili Veriler: Veritabanı Yerine Filesystem/S3

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.

Veritabanı neden ikili veriler için uygun değildir

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.

Filesystem modu: pragmatik ilk adım

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.

S3 modu: ölçeklenen dağıtımlar için harici depolama

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.

• N8N_EXTERNAL_STORAGE_S3_HOST: S3 uç noktası, örneğin s3.us-east-1.amazonaws.com
• N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME: bucket adı
• N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION: bölge, 2.6.4 sürümünden itibaren yalnızca alfanümerik karakterler ve tireler, bölge belirtilmezse auto değeri yeterlidir
• N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY ve N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET: bucket için erişim bilgileri
• N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT: kimlik bilgilerini otomatik algılamak için isteğe bağlı olarak true değerine ayarlanır, örneğin bir IAM rolü üzerinden

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şi düzgün şekilde hazırlamak

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.

n8n'de ikili veriler hakkında sık sorulan sorular

Filesystem modu ile S3 modu arasındaki fark nedir?

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.

S3 modu için mutlaka bir enterprise lisansına ihtiyacım var mı?

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.

Filesystem modu queue modunda da çalışır mı?

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.

Mod değiştirildiğinde daha önce depolanmış ikili verilere ne olur?

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.