Düzenleyiciyi koruyun
Düzenleyiciyi HTTPS ve desteklenen kimlik doğrulamanın arkasına yerleştirin. Yönetici erişimini kısıtlayın ve gereksiz olduğunda genel kayıttan kaçının. Webhook rotaları kendi açığa çıkarma ve kimlik doğrulama kararlarını gerektirir.
Kimlik bilgisi anahtarını saklayın
Yapılandırılmış şifreleme anahtarını uygun korumayla yedekleyin. Doğru anahtar olmadan bir veritabanını geri yüklemek kaydedilen kimlik bilgilerini kullanılamaz bırakabilir. Anahtarı ekran görüntülerinden, depolarından ve filtrelenmemiş günlüklerden uzak tutun.
Yürütme yolunu kasıtlı olarak ölçeklendirin
Yoğun bir kurulum için desteklenen veritabanı, kuyruk ve çalışan modelini gözden geçirin. Redis ve ayrı çalışanlar kendi erişim ve kalıcılık gereksinimlerini ekler. Eşzamanlı işleri sınırlayın, böylece bir ani yük VPS veya harici bir API bütçesini tüketemez.
Yalnızca faydalı yürütme verilerini saklayın
İş akışları belirteçleri, kişisel kayıtları ve belgeleri işleyebilir. Yürütme geçmişi temizliğini ayarlayın, hassas değerleri gizleyin ve yeniden denemeleri dikkatle tanımlayın. Yinelenen bir webhook istenmeyen ikinci bir ödeme veya mesaja yol açmamalıdır.
Şifreleme anahtarını veritabanının parçası olarak değerlendirin
Kaydedilen kimlik bilgileri n8n'nin şifreleme anahtarına bağlıdır. Otomatik oluşturulan anahtarı içeren durum dizinini koruyun veya N8N_ENCRYPTION_KEY değerini özel bir gizli depodan ayarlayın. Tüm kuyruk worker'ları ana süreçle aynı anahtara ihtiyaç duyar. Geri yüklemeyi tek kullanımlık bir kimlik bilgisiyle test edin; yalnızca geri yüklenen bir veritabanı sağlıklı görünebilir ama kimlik bilgileri okunamaz kalabilir.
- Anahtarı genel dizinin ve deponun dışında tutun
- Veritabanını tutarlı şekilde yedekleyin
- Amaçlanan üretim dağıtımı için desteklenen PostgreSQL kullanın
Resmi belgeler: n8n şifreleme anahtarı yapılandırması
Web kancalarına genel adreslerini verin
Caddy gibi bir ters proxy HTTPS sonlandırırken n8n dahili olarak dinler. Güncel belgeler harici webhook kaynağı için N8N_WEBHOOK_URL kullanır ve 2.35.0 sürümünden itibaren eski WEBHOOK_URL adını değiştirir. Güvenilen proxy atlama sayısını gerçek yola ayarlayın; tek proxy N8N_PROXY_HOPS=1 kullanır. İletilen ana bilgisayar, protokol ve istemci bilgilerini koruyun. Sunucu dışından bir webhook test edin ve üretim URL değerini doğrulayın.
- İş akışı saat dilimini bilinçli olarak ayarlayın
- Hassas girdiler içeren yürütme geçmişini budayın
- Kuyruk çalışanlarını ve Redis'i yalnızca gerekli özel erişim kontrolleriyle kullanın
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Resmi belgeler: Ters proxy arkasında n8n
İş yükünü ve izin verilen entegrasyonları tanımlayın
Tetikleyicileri, harici hesapları, beklenen yürütme hacmini ve her iş akışının oluşturabileceği maksimum harcamayı veya yan etkiyi listeleyin. Gerçek kullanım için n8n lisansını kontrol edin, özellikle başkalarına hizmet olarak sunuyorsanız. Küçük bir planlı iş akışı ile genel bir webhook işleyicisinin kaynak ihtiyaçları farklıdır. Desteklenen bir sürüm, özel kalıcı durum, bir TLS adı ve dağıtıma uygun bir veritabanıyla başlayın; veritabanı bağlantı noktalarını düzenleyiciyle açığa çıkarmaktan kaçının.
- Her entegrasyon için ayrı kısıtlı kimlik bilgileri kullanın.
- Amaçlanan iş akışı saat dilimini ve yürütme geçmişi saklamayı ayarlayın.
- Dışa aktarılan iş akışlarını gömülü gerçek sırlardan uzak tutun.
Resmi belgeler: n8n Docker dağıtımı
Yüklü sürüm için genel webhook kaynağını ayarlayın
Caddy gibi bir ters proxy dahili olarak n8n adresine ulaşırken harici hizmetler onun HTTPS webhook kaynağını çağırır. Kurulu sürüm için belgelenen webhook URL değişkenini kullanın; güncel belgeler N8N_WEBHOOK_URL adını verirken eski sürümler WEBHOOK_URL kullanıyordu. Rastgele iletilen başlıklara güvenmek yerine gerçek proxy atlama sayısını ayarlayın. Düzenleyici erişim politikasını webhook kimlik doğrulamasından ayrı tutun ve üretim geri çağırmasının dahili bir ana bilgisayar veya bağlantı noktası içermediğini doğrulayın.
# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1Resmi belgeler: n8n webhook ters proxy ayarları
Yazma erişimi vermeden önce zararsız bir iş akışını test edin
Salt okunur bir istekle veya tek kullanımlık bir test kaydıyla başlayın. Üretim webhook'unu VPS dışından test edin, kimlik doğrulama reddini ve bilinçli bir yeniden denemeyi deneyin. Tekrarlanan bir istek yanlışlıkla ikinci bir sonuç doğuran eylem oluşturmamalıdır. Yürütme günlüklerinde sızan girdileri kontrol edin, ardından bir saklama politikası uygulayın. Bir webhook yalnızca editörün test modunda çalışıyorsa, iş akışının yayımlanmış/etkin olup olmadığını ve üretim ile test yollarının doğru sürece ulaşıp ulaşmadığını inceleyin.
- Bir geri yüklemeyi test etmek için tek kullanımlık bir entegrasyon kimlik bilgisi kullanın.
- N8N_ENCRYPTION_KEY veya oluşturulan anahtar durumunun bağımsız şifreli bir kopyasını saklayın.
- Örnek parolaları veya API belirteçlerini saklanan hata ayıklama çıktısına göndermeyin.
Resmi belgeler: n8n şifreleme anahtarı
Yalnızca yürütme darboğazını gözlemledikten sonra ölçeklendirin
Kuyruk modu Redis, çalışanlar ve paylaşılan bir veritabanı ekler; ana süreç tetikleyicileri alırken çalışanlar yürütmeleri gerçekleştirir. Her çalışan aynı kimlik bilgisi şifreleme anahtarını kullanmalıdır. Dosyalı bir iş akışını kuyruk moduna taşımadan önce güncel ikili veri depolama gereksinimlerini izleyin. Eşzamanlılığı ve üst kaynak API bütçelerini sınırlayın, kuyruk yaşını ve hataları izleyin. Veritabanını, durumu ve anahtarı birlikte yedekleyin; bir konteyneri yeniden başlatmak, okunamayan kayıtlı kimlik bilgileri için bir kurtarma planı değildir.
Resmi belgeler: n8n kuyruk modu · Yürütme budama ayarları