n8n 2.0 neyi değiştiriyor?
n8n 2.0, yeni özelliklerden çok güvenli varsayılanlarla öne çıkan bir sürüm. Daha önce isteğe bağlı olan korumaların birçoğu artık kendiliğinden açık geliyor. Bu iyi haber, ama bir yan etkisi var: 1.x üzerinde sorunsuz çalışan bazı iş akışları yükseltmeden sonra kırılabilir.
Resmî "breaking changes" sayfasındaki maddeleri, işe yarayacak sırayla ele alalım.
Code node'da ortam değişkenleri neden okunamıyor?
N8N_BLOCK_ENV_ACCESS_IN_NODE varsayılan olarak true oluyor ve Code node içinden ortam değişkenlerine erişimi engelliyor. Bir iş akışında $env ile gizli değer okuyorsanız yükseltmeden sonra boş dönecektir.
// 1.x'te çalışırdı, 2.0'da varsayılan olarak engelli
const anahtar = $env.HARICI_SERVIS_ANAHTARI
Önerilen çözüm, gizli değerleri n8n kimlik bilgilerine (credentials) taşımak. Bu hem engeli aşmanın daha güvenli yolu hem de iş akışı JSON'unda değerin geçmemesini sağlıyor. Değişkeni false yapmak mümkün ama bu, korumayı kapatmak demek.
Task runner'lar varsayılan oluyor
Code node artık task runner'lar üzerinde çalışıyor ve N8N_RUNNERS_ENABLED varsayılanı true. Yükseltmeden önce 1.x üzerinde bu değişkeni açıp iş akışlarını denemek, sürprizleri önceden gösteriyor.
Bazı JavaScript özellikleri bu modda kapalı. N8N_RUNNERS_INSECURE_MODE=true onları geri açıyor ama dokümantasyon üretimde bunu önermiyor. Bir de $evaluateExpression() artık Code node içinde çalışmıyor.
Komut ve dosya düğümleri neden kapalı?
ExecuteCommand ve LocalFileTrigger düğümleri varsayılan olarak devre dışı. İhtiyacınız varsa NODES_EXCLUDE="[]" ile açabilirsiniz, ama önce gerçekten gerekip gerekmediğini düşünün: sunucuda komut çalıştıran bir düğüm, ele geçirilmiş bir iş akışında en tehlikeli parçadır.
Dosya erişimi de daraldı. N8N_RESTRICT_FILE_ACCESS_TO için artık bir varsayılan var ve ReadWriteFile ile ReadBinaryFiles düğümleri ~/.n8n-files klasörüyle sınırlı. Başka yerde dosya okuyan akışlar bu klasöre taşınmalı ya da izin verilen yol genişletilmeli.
Aynı çizgide birkaç küçük değişiklik daha var: N8N_SKIP_AUTH_ON_OAUTH_CALLBACK true'dan false'a dönüyor, N8N_GIT_NODE_DISABLE_BARE_REPOS true oluyor, N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS ise yapılandırma dosyaları için 0600 izni istiyor.
Yayın modeli ve webhook akışları
Aktif/pasif anahtarı yerini Publish ve Unpublish düğmelerine bırakıyor. Komut satırında update:workflow kullanımdan düşüyor, yerine publish:workflow ve unpublish:workflow geliyor. workflow.activeChange kancaları da workflow.published lehine kullanımdan düşüyor. Otomasyonu betikle yönetiyorsanız bu isimleri güncellemeniz gerekir.
Start düğümü kaldırıldı. Yerine Manual Trigger ya da Execute Workflow Trigger kullanılıyor. Bir alt iş akışı bekleme durumundan (webhook, form ya da insan onayı) devam ettiğinde ise üst akış artık alt akışın çıktısını alıyor, girdisini değil. Bu, veriyi sonraki düğümde bekleyen akışları sessizce bozabilir, o yüzden bu tür akışları ayrıca deneyin.
Veritabanı ve ikili veri değişiklikleri
MySQL ve MariaDB artık n8n'in kendi depolama arka ucu olarak desteklenmiyor, PostgreSQL ya da SQLite'a geçmek gerekiyor. İş akışlarındaki MySQL düğümü bundan etkilenmiyor. Eski SQLite sürücüsü kalktı, havuzlu sürücü varsayılan oldu.
İkili veri için bellek içi varsayılan mod kaldırıldı. Geçerli modlar filesystem, database ve s3.
Python Code node'u da değişiyor
Pyodide tabanlı Python Code node ve aracı kaldırıldı. Python Code node'ları artık yalnızca harici modda task runner'larda çalışıyor. Yerel Python sürümü _input ve nokta erişimini desteklemiyor, Python aracı ise _query kullanıyor. Python düğümü kullanan akışlar için ayrı bir deneme planlayın.
Yükseltmeden önce ne yapmalı?
Önce üretimin bir kopyasını bir test ortamına alın. n8n 1.x'in son sürümünde N8N_RUNNERS_ENABLED değişkenini açın ve her iş akışını gerçek bir örnek veriyle çalıştırın. Webhook ile tetiklenenleri gerçek bir istekle sınayın, çünkü sorunlar çoğu zaman yalnızca gerçek veride çıkıyor.
Sonra şu listeden geçin: Code node'da $env kullanan var mı, ExecuteCommand ya da dosya düğümü kullanan var mı, Python Code node var mı, depolama MySQL ya da MariaDB mi, betiklerde update:workflow geçiyor mu. Webhook uç noktalarını dışarıya açıyorsanız Header Auth gibi bir doğrulama kullanmayı da bu fırsatta kontrol edin.
Sık sorulan sorular
n8n 2.0 neden bu kadar çok şeyi kapatıyor? Güvenli varsayılan yaklaşımı yüzünden. Koruma isteğe bağlı olmak yerine varsayılan oldu, gevşetmek için açıkça ayar yapmak gerekiyor.
Code node'da gizli değerleri nasıl okurum? Ortam değişkeni yerine n8n kimlik bilgilerini kullanın. N8N_BLOCK_ENV_ACCESS_IN_NODE değerini false yapmak mümkün ama korumayı kapatır.
MySQL ile kullanıyorum, ne yapmalıyım? n8n'in depolaması için MySQL ve MariaDB desteği kalktı, PostgreSQL ya da SQLite'a geçmeniz gerekiyor.
ExecuteCommand düğümünü nasıl açarım? NODES_EXCLUDE="[]" ayarıyla. Ama önce gerçekten gerekli olup olmadığına bakın.

