n8n Yedekleme: iş akışları, kimlik bilgileri ve şifreleme anahtarı

Bir n8n yedeklemesi, ancak iş akışlarını, kimlik bilgilerini ve bunlara uygun şifreleme anahtarını birlikte güvence altına aldığında eksiksiz sayılır. Anahtar eksikse veya orijinalinden farklıysa, n8n kayıtlı erişim bilgilerini artık şifresini çözemez ve e-posta kutusu, CRM veya API ile kayıtlı her bağlantının elle yeniden kurulması gerekir. İş akışlarının kendisi web arayüzü üzerinden veya CLI ile JSON olarak dışa ve içe aktarılabilir; kimlik bilgileri için ayrıca orijinal şifreleme anahtarına veya bilinçli olarak şifresi çözülmüş bir dışa aktarıma ihtiyaç vardır. n8n'i kendisi barındıran ve otomasyonlarının sorumluluğunu taşıyan şirketler için şifreleme anahtarı, bu nedenle işlevsel bir yedekleme stratejisinin en önemli tek unsurudur. Durum: Temmuz 2026.

Şifreleme anahtarı n8n'de aslında ne işe yarar?

Şifreleme anahtarı, n8n'de saklanan tüm kimlik bilgilerini veritabanına kaydedilmeden önce şifreler; uygun anahtar olmadan bu veriler kalıcı olarak okunamaz durumda kalır. n8n ilk başlatmada otomatik olarak rastgele bir anahtar oluşturur ve bunu ~/.n8n klasöründe saklar. Bunun yerine kendi anahtarını kullanmak isteyen kişi, ayarlar dosyası oluşturulmadan önce N8N_ENCRYPTION_KEY ortam değişkenini ayarlamalıdır; sonradan yapılan bir değişiklik otomatik olarak devreye girmez. n8n birden fazla worker ile kuyruk modunda çalışıyorsa, belgelere göre her bir worker için aynı şifreleme anahtarının ayarlanmış olması gerekir (şifreleme anahtarı hakkında n8n belgeleri).

Şifreleme anahtarı kaybolursa ne olur?

Şifreleme anahtarı kaybolursa veya kimlik bilgilerinin şifrelenmesinde başlangıçta kullanılan anahtardan farklıysa, n8n muhtemelen farklı bir şifreleme anahtarı kullanıldığı için kimlik bilgilerinin şifresinin çözülemediğini bildirir. İş akışı mantığının kendisi bir JSON yapısı olarak korunur, ancak API anahtarları, OAuth belirteçleri veya SMTP erişimleri gibi kayıtlı her kimlik bilgisi kullanılamaz hale gelir ve elle yeniden bağlanması gerekir. Az sayıda iş akışında bu can sıkıcıdır; muhasebe, CRM veya stok yönetimine çok sayıda bağlantısı olan gelişmiş otomasyonlarda ise bu durum, tüm kimlik bilgisi yönetiminin fiilen sıfırdan yeniden başlaması anlamına gelir. Bu nedenle şifreleme anahtarı, veritabanı yedeklemesinden ayrı ama onun kadar güvenilir şekilde her yedekleme rutininde yer almalıdır.

İş akışlarını ve kimlik bilgilerini doğru şekilde nasıl yedeklersiniz?

n8n, yedeklemeler için hem arayüz üzerinden hem de sunucu CLI'si üzerinden yollar sunar; düzenli yedeklemeler için CLI daha güvenilir bir yoldur. Web arayüzünde bir iş akışı, üç nokta menüsü aracılığıyla JSON dosyası olarak indirilebilir veya bir dosyadan ya da URL'den içe aktarılabilir.

• İş akışlarını dışa aktarma: --backup ve --output seçenekleriyle n8n export:workflow, tüm iş akışlarını tek tek ve okunabilir şekilde biçimlendirilmiş olarak bir hedef klasöre kaydeder.
• Kimlik bilgilerini dışa aktarma: n8n export:credentials --all şifrelenmiş kimlik bilgilerini kaydeder; ek --decrypted seçeneğiyle bunlar, örneğin farklı bir şifreleme anahtarına sahip bir örneğe hedefe yönelik olarak aktarılmak üzere düz metin olarak da dışa aktarılabilir.
• İçe aktarma: n8n import:workflow ve n8n import:credentials, JSON dosyalarını yeniden içe aktarır; içerdikleri kimlikler (ID), aynı kimliğe sahip mevcut iş akışlarının veya kimlik bilgilerinin üzerine yazar.

Tüm komutlara ilişkin ayrıntılar, dışa ve içe aktarma ile komut satırına ilişkin n8n belgelerinde yer alır (n8n'de dışa ve içe aktarma, n8n CLI komutları).

Şifreleme anahtarını değiştirirken veya dışa aktarımları paylaşırken nelere dikkat etmelisiniz?

Şifreleme anahtarını değiştirmek rutin bir işlem değil, hazırlanmış bir yedekleme olmadan kalıcı veri kaybına yol açabilecek bir müdahaledir. n8n, ana anahtar olarak asla değişmeyen örnek şifreleme anahtarı ile kimlik bilgilerini fiilen şifreleyen ve kendi rotasyon işlevi aracılığıyla yenilenebilen alttaki veri şifreleme anahtarı arasında ayrım yapar. Belgelere göre bu rotasyon açıkça geri alınamaz; ilgili işlev tekrar devre dışı bırakılırsa, o zamandan beri şifrelenmiş tüm veriler kalıcı olarak erişilemez hale gelir; önceden alınmış eksiksiz bir veritabanı yedeği tek koruma yöntemidir (anahtar rotasyonu hakkında n8n belgeleri). Dışa aktarılan iş akışı JSON dosyalarını paylaşırken de dikkatli olunmalıdır, çünkü dosyalar kimlik bilgisi adlarını ve kimlikleri içerir ve cURL'den içe aktarılan HTTP istek düğümleri, kimlik doğrulama başlıklarını düz metin olarak bile içerebilir. Bu bilgiler her paylaşımdan önce kaldırılmalıdır.

Kendi n8n örneğini işleten ve yedekleme rutinlerini kurarken veya sunucular arasında taşınırken destek arayan kişiler, NordFlux'un n8n hizmetinde bu konuda destek bulabilir.

n8n yedekleme ve şifreleme anahtarı hakkında sıkça sorulan sorular

n8n'i tamamen yedeklemek için tek başına bir veritabanı yedeklemesi yeterli midir?

Hayır, sadece bir veritabanı yedeklemesi iş akışlarını ve şifrelenmiş kimlik bilgilerini güvence altına alır, ancak ilgili şifreleme anahtarı olmadan bu kimlik bilgileri geri yüklenirken okunamaz durumda kalır. Anahtar varsayılan olarak ~/.n8n klasöründe ayrı bir ayarlar dosyasında bulunur ve bu nedenle bilinçli olarak, ideal olarak veritabanı yedeklemesinden ayrı, erişime karşı korunan bir yerde yedeklenmelidir.

İş akışlarını ilgili kimlik bilgileri olmadan dışa aktarabilir miyim?

Evet, bir iş akışının arayüz üzerinden veya n8n export:workflow ile dışa aktarılması yalnızca kimlik bilgisi adlarına ve kimliklerine referanslar içeren iş akışı yapısını içerir, kimlik bilgilerinin kendisini değil. Kimlik bilgilerini de birlikte almak için n8n export:credentials ile ayrı bir dışa aktarma gereklidir ve hedefte ya aynı şifreleme anahtarı bulunmalı ya da kimlik bilgileri önceden --decrypted seçeneğiyle düz metin olarak dışa aktarılmalıdır.

Kimlik bilgilerini farklı bir şifreleme anahtarına sahip bir n8n örneğine nasıl taşırım?

En güvenilir yol, kaynak örnekte n8n export:credentials --all --decrypted ile şifresi çözülmüş dışa aktarma yapmak, ardından hedef örnekte, verileri otomatik olarak kendi şifreleme anahtarıyla yeniden şifreleyen olağan içe aktarmayı gerçekleştirmektir. Dosya bu işlem sırasında kısa süreliğine düz metin halinde bulunduğundan, içe aktarmadan hemen sonra güvenli bir şekilde silinmelidir.

Şifreleme anahtarı gerçekten kaybolduysa ne yapmalıyım?

Orijinal anahtar veya ayarlar dosyasının bir yedeği olmadan, zaten şifrelenmiş kimlik bilgileri artık kurtarılamaz; etkilenen her bağlantının ilgili iş akışlarında elle yeniden kimlik doğrulaması yapılması gerekir. İş akışı mantığının kendisi bu sırada kaybolmaz; çaba, kimlik bilgilerinin yeniden girilmesiyle sınırlıdır, ancak bu, kapsamlı otomasyonlarda yine de birkaç saatlik iş anlamına gelebilir.