Kesintisiz sunucu değişimi

Kendi barındırdığınız n8n için sunucu değişimi, blue-green ilkesine göre ilerlerseniz belirgin bir kesinti olmadan başarılabilir: yeni sunucu, eskisiyle tamamen paralel olarak kurulur ve DNS değişimi trafiği yönlendirmeden önce taşınan verilerle test edilir. Bu sırada workflow'ların, credential'ların ve n8n veritabanının aynı şifreleme anahtarıyla eksiksiz şekilde yeni sunucuya aktarılması önemlidir, çünkü n8n, kaydedilmiş erişim bilgilerini çözmek için N8N_ENCRYPTION_KEY'i kullanır. Taşıma sırasında bu anahtarı unutan kişi, workflow'ların kendisi içe aktarılabilmiş olsa bile kayıtlı tüm credential'lara erişimi kaybeder. Güncelleme: Temmuz 2026.

Yeni sunucuyu hazırlama

Herhangi bir şeyi taşımadan önce, yeni sunucu (örneğin yeni bir Hetzner Cloud instance'ı) Docker veya Docker Compose, reverse proxy ve 80 ile 443 portları için firewall kuralları dahil olmak üzere çalışır durumda kurulmuş olmalıdır. Hetzner kurulumları için Hetzner üzerinde barındırma hakkındaki n8n dokümantasyonu Docker Compose ve reverse proxy olarak Caddy ile kurulumu, n8n verileri için kalıcı volume'lerle birlikte anlatır.

• Docker ortamı: n8n ve reverse proxy, veriler yeniden başlatmalardan etkilenmesin diye kendi volume'leriyle konteyner olarak çalışır.
• Test için subdomain: Ana domain değiştirilmeden önce yeni sunucuyu test edebilmek için önce ikinci bir DNS kaydı oluşturun (örneğin n8n-yeni.sizindomaininiz.com).
• Aynı n8n sürümü: İçe aktarma hatalarını önlemek için yeni sunucudaki n8n sürümünün eski sunucudaki sürümle eşleştiğini kontrol edin veya sürümü bilinçli olarak güncelleyin.

Workflow'ları, credential'ları ve veritabanını taşıma

n8n, workflow'ları ve credential'ları ayrı ayrı işleyen dışa ve içe aktarma için CLI komutları aracılığıyla özel komutlar sunar. Tam bir yedekleme --backup ve --output bayraklarıyla oluşturulabilir, içe aktarmada --input ve --separate ile geri yüklenebilir.

• Workflow'ları dışa aktarma: n8n export:workflow --backup --output=backups/latest/ tüm workflow'ları biçimlendirilmiş şekilde ve ayrı dosyalar olarak yedekler.
• Credential'ları dışa aktarma: n8n export:credentials --backup --output=backups/latest/ erişim bilgilerini hâlâ şifrelenmiş şekilde yedekler; --decrypted seçeneği bunları açık metin olarak gösterir ve yalnızca kontrollü taşımalar için kullanılmalıdır.
• Yeni sunucuda içe aktarma: n8n import:workflow --separate --input=backups/latest/ ve n8n import:credentials --separate --input=backups/latest/ dosyaları geri yükler.
• Şifreleme anahtarını devralma: N8N_ENCRYPTION_KEY değerini yeni sunucuda eski sunucudaki değerle tam olarak aynı şekilde ayarlayın, aksi takdirde içe aktarılan credential'lar çözülemez.
• Veritabanı klasörüne dikkat edin: N8N_USER_FOLDER'ın işaret ettiği klasör, SQLite veritabanının yanı sıra başka yerel yapılandırma verilerini de içerir ve harici bir PostgreSQL veritabanına geçmediğiniz sürece yedeğe dahil edilmelidir.

n8n dokümantasyonuna göre bu komutlar, workflow'ların ve credential'ların dahili ID'lerini de dışa aktarır. Hedef sunucuda aynı ID'lere sahip kayıtlar zaten varsa, içe aktarma sırasında bunların üzerine yazılır; yeni sunucu tamamen boş kurulmadıysa bu önemli bir noktadır. İçe aktarılan workflow'lar ayrıca varsayılan olarak devre dışıdır ve kontrolden sonra bilinçli olarak yeniden etkinleştirilmelidir.

İçe aktarmadan sonra: kritik workflow'ları test subdomain'i üzerinden manuel olarak test edin, tetikleyicileri, webhook'ları ve harici hizmetlere olan bağlantıları kontrol edin ve eski ile yeni sunucu arasındaki workflow ve credential sayısını örnekleme yoluyla karşılaştırın.

DNS'i değiştirme: kesintisiz blue-green

Yeni sunucu test subdomain'i altında güvenilir şekilde çalıştığında asıl domain değiştirilir. Değişikliğin hızlı etkili olması için önceden ilgili DNS kaydının TTL'sini düşük bir değere indirin (örneğin 300 saniye). Ardından ana domainin A kaydını yeni sunucunun IP adresine değiştirin. Geçiş süresi boyunca eski ve yeni instance paralel çalışır, bu nedenle gelen istekler DNS önbellek durumuna bağlı olarak kısa süreliğine her iki sunucuya da dağıtılabilir. Webhook tabanlı workflow'larda bu durum, geçiş penceresi sırasında bazı çağrıların yeni yerine eski sunucuya ulaşmasına yol açabilir, bu yüzden webhook yoğun workflow'lar bu aşamada özellikle izlenmelidir.

Eski sunucuyu kapatma

DNS değişiminden sonra eski sunucuyu kapatmadan önce en az eski TTL süresi artı bir güvenlik payı kadar bekleyin. Bu süre boyunca yeni sunucunun loglarını gelen trafik açısından kontrol edin ve eski sistemde artık önemli execution'ların çalışmadığından emin olun. Yeni sunucu, tüm trafiği uzun bir süre boyunca istikrarlı şekilde işledikten sonra ancak eski sunucuyu durdurmalı ve kalıcı olarak silinmeden önce son bir yedek arşivlemelisiniz. NordFlux, kendi barındırdığı n8n kullanan müşteriler için sunucu değişimlerinde, Alman veri egemenliğini ve altyapı üzerindeki kontrolü sürekli olarak korumak amacıyla bu yaklaşımı varsayılan olarak uygular.

Kesintisiz sunucu değişimi hakkında sık sorulan sorular

n8n'de blue-green sunucu değişimi ne kadar sürer?

Bu, workflow sayısına, veri miktarına ve DNS kayıtlarının TTL'sine bağlıdır. Verilerin asıl taşınması genellikle birkaç dakika içinde tamamlanır, güvenlik payı dahil DNS değişimi ise TTL yapılandırmasına bağlı olarak birkaç saat sürebilir.

Şifreleme anahtarı aktarılmazsa ne olur?

Aynı N8N_ENCRYPTION_KEY olmadan içe aktarılan credential'lar çözülemez. Workflow'lar görünür, ancak erişim bilgileri yeniden girilene kadar harici hizmetlere olan bağlantılar başarısız olur.

Taşıma için basit bir veritabanı dışa aktarımı yeterli midir?

Tam bir taşıma için, kullanılıyorsa asıl veritabanı klasörüne veya harici bir PostgreSQL instance'ına ek olarak, hem workflow'ları hem de credential'ları özel n8n CLI komutlarıyla dışa aktarmalısınız.

Taşıma sırasında n8n kapatılmalı mı?

Hayır. Blue-green yaklaşımında eski sunucu, DNS değişimi başarılı olana kadar etkin ve kullanılabilir kalır. Asıl kesinti, ideal durumda kısa DNS geçiş anıyla sınırlıdır.