CLI ile n8n: İçe/Dışa Aktarma, Kullanıcı Sıfırlama

n8n'i kendi sunucusunda barındıran herkes er ya da geç workflow'ların yedeklenmesi, başka bir örneğe aktarılması veya kilitlenmiş bir kullanıcı hesabının sıfırlanması gereken bir noktaya gelir. Bu üç görev için n8n, doğrudan sunucuda çalışan ve çalışan bir web arayüzü olmadan da kullanılabilen kendi CLI komutlarını sunar. Bu makale, resmi n8n dokümantasyonunda açıklandığı şekliyle dışa aktarma, içe aktarma ve acil durum parola sıfırlama için en önemli komutları gösterir. Güncelleme: Temmuz 2026.

CLI ile workflow'ları dışa aktarma

export:workflow komutu, workflow'ları n8n veritabanından JSON dosyalarına aktarır. Ek bir belirtim olmadan tek tek workflow'lar için geçerlidir, ancak uygun bayraklarla dışa aktarma tüm envantere genişletilebilir veya doğrudan bir yedekleme için hazırlanabilir.

• --all: Yalnızca tek bir workflow yerine örneğin tüm workflow'larını dışa aktarır.
• --id=<ID>: Yalnızca belirtilen ID'ye sahip workflow'u dışa aktarır.
• --output veya -o: Hedef dosyayı veya birden fazla workflow olduğunda hedef dizini belirler.
• --backup: Eksiksiz, okunabilir bir yedekleme için otomatik olarak --all, --pretty ve --separate'ı etkinleştirir.
• --separate: Her workflow'u kendi dosyasına yazar, --output ile birlikte bir dizin gerektirir.
• --pretty: JSON çıktısını kompakt yerine okunabilir biçimde biçimlendirir.
• --published: Bir workflow'un mevcut taslağı yerine yayınlanmış sürümünü dışa aktarır.
• --version=<VERSION_ID>: Bir workflow'un belirli bir geçmiş sürümünü dışa aktarır.

Düzenli yedeklemeler için özellikle export:workflow --backup --output=backups/latest/ kombinasyonu uygundur ve bir cron görevinde günlük veya haftalık görev olarak kolayca planlanabilir.

CLI ile workflow'ları içe aktarma

Karşılığı import:workflow'dur. Daha önce dışa aktarılmış JSON dosyalarını okur ve bunları hedef örneğin veritabanına geri yazar, örneğin bir sunucu taşıması veya bir arıza sonrası kurtarma sırasında.

• --input: Giriş dosyasının yolu veya --separate ile birlikte birden fazla dosya içeren bir dizinin yolu.
• --separate: Yalnızca tek bir dosya yerine bir dizindeki tüm JSON dosyalarını içe aktarır.
• --projectId: İçe aktarılan workflow'ları belirli bir projeye atar.
• --userId: İçe aktarılan workflow'ları belirli bir kullanıcıya atar.
• --activeState: İçe aktarılan workflow'ların etkinleştirilip etkinleştirilmeyeceğini kontrol eder, varsayılan olarak false, veya çoklu ana (multi-main) çalışmada fromJson.
• --skipMigrationChecks: İçe aktarma sırasında doğrulama kontrollerini atlar.

Önemli: hedef veritabanında zaten bulunan bir ID'ye sahip workflow'lar içe aktarma sırasında çoğaltılmaz, üzerine yazılır. Bu nedenle üretim ortamındaki bir örnekte içe aktarma yapmadan önce mevcut workflow'ları yedek olarak önceden dışa aktarmak her zaman değerlidir.

Acil durum: kilitlenme durumunda CLI ile parola sıfırlama

Bir parola unutulduğu ve e-posta ile normal sıfırlama için bir SMTP sunucusu ayarlanmadığı için bir n8n hesabına erişim eksikse, n8n dokümantasyonuna göre user-management:reset komutu yardımcı olur. Kullanıcı yönetimini ilk kurulum öncesi duruma geri döndürür ve bu sırada mevcut tüm kullanıcı hesaplarını kaldırır. Web arayüzüne bir sonraki erişimde n8n, yeni bir kurulumda olduğu gibi yeniden yeni bir sahip hesabı kurulmasını ister.

Komut bilinçli olarak radikaldir: yalnızca etkilenen hesabı değil, örneğin tüm kullanıcı hesaplarını siler. Roller, izinler ve proje atamaları daha sonra yeniden yapılmalıdır. Dokümantasyona göre workflow'lar, kimlik bilgileri ve yürütme geçmişi bundan etkilenmez, çünkü komut yalnızca kullanıcı yönetimini sıfırlar.

Birisinin, örneğin kurtarma kodları kaybolduğu için artık iki faktörlü kimlik doğrulamayı kullanamadığı daha dar kapsamlı durum için, daha az köklü olan mfa:disable --email=<e-posta-adresi> komutu yeterlidir. Tam olarak bu tek hesap için MFA'yı devre dışı bırakır, böylece kişi tekrar normal şekilde giriş yapabilir ve iki faktörlü kimlik doğrulamayı yeniden kurabilir.

Günlük işletimde diğer CLI komutları

• export:credentials ve import:credentials: Kimlik bilgilerini yedekler ve aktarır; --decrypted ile tüm hassas değerler dosyada düz metin olarak yer alır, bu nedenle buna göre dikkatli kullanılmalıdır.
• audit: Örneği yaygın güvenlik sorunlarına karşı kontrol eder.
• license:info ve license:clear: Geçerli lisansı gösterir veya onu varsayılan özellik kapsamına sıfırlar.
• n8n --help: Kurulu n8n sürümünün tüm kullanılabilir komutlarını listeler, çünkü özellik kapsamı sürüme göre değişebilir.

CLI komutları doğrudan sunucuda çalışır ve örneğin SSH veya docker exec üzerinden karşılık gelen erişim gerektirir. n8n'i shell erişimi olmayan bir sağlayıcıda çalıştıranlar bunları genellikle kullanamaz ve sağlayıcının desteğine bağımlıdır. n8n'i kendisi barındıran ve günlük işleyişte güvenilir yedeklemelere ve belgelenmiş bir acil durum planına bağımlı olan şirketler için NordFlux, kendi verileriniz ve erişimleriniz üzerinde kontrolü sizin elinizde tuttuğunuz bir kurulumla n8n kurulumu ve işletimi konusunda destek sağlar.

n8n CLI içe/dışa aktarma hakkında sık sorulan sorular

Tüm n8n workflow'larını otomatik olarak nasıl yedeklerim?

export:workflow --backup --output=<dizin> komutuyla tüm workflow'lar okunabilir, ayrı dosyalar halinde yedeklenebilir. Komut, sunucuda günlük bir cron görevi olarak iyi çalışır ve hedef dizinin bir kopyasının ikinci bir depolama konumuna alınmasıyla tamamlanabilir.

user-management:reset ile workflow'lar ve kimlik bilgileri de silinir mi?

Hayır. n8n dokümantasyonuna göre komut yalnızca kullanıcı yönetimini sıfırlar ve tüm kullanıcı hesaplarını kaldırır. Workflow'lar, kimlik bilgileri ve yürütme geçmişi korunur, ancak sıfırlamadan sonra yeni bir sahip hesabına yeniden atanmalıdır.

Tüm örnek yerine tek tek workflow'ları dışa aktarabilir miyim?

Evet. export:workflow --id=<ID> --output=dosya.json ile tek bir workflow, geri kalan envantere dokunmadan hedefe yönelik olarak dışa aktarılabilir.

İçe aktarılan bir workflow ID'si zaten mevcutsa ne olur?

Aynı ID'ye sahip mevcut workflow, içe aktarma sırasında kopya olarak oluşturulmaz, üzerine yazılır. Bu nedenle çalışan bir örnekte her içe aktarmadan önce yedek olarak güncel bir dışa aktarma yapılması önerilir, bkz. komut satırı hakkındaki n8n dokümantasyonu ve kullanıcı yönetimi hakkındaki dokümantasyon.