n8n hakkında
n8n, görsel arayüzle çalışan bir iş akışı otomasyon aracıdır. Webhook'ları, HTTP isteklerini, veritabanlarını, e-postayı ve SaaS servislerini bir tuval üzerinde node'lar (düğümler) halinde birbirine bağlarsınız. Bir node yetmediğinde araya JavaScript veya Python kodu ekleyebilirsiniz. Kendi sunucunuzda çalıştırdığınızda verileriniz ve kimlik bilgileriniz üçüncü bir tarafta değil, kendi makinenizde durur.
Teslimat sırasında tarif betiği, Docker yüklü değilse önce onu kurar, ardından /opt/n8n dizininden Docker Compose ile iki konteyner başlatır: n8n (docker.n8n.io/n8nio/n8n:latest imajı) ve Caddy 2. n8n yalnızca 127.0.0.1:5678 adresini dinler. Caddy ise ana makine ağ modunda çalışır, servisi 443 numaralı portta HTTPS ile yayınlar ve istekleri n8n'e iletir.
Sertifika kendinden imzalıdır (Caddy'nin tls internal yönergesi) ve sunucunun genel IP adresine bağlıdır. Bu nedenle ilk ziyarette tarayıcınız bir uyarı gösterir. Bir alan adı bağlayana kadar bu normaldir. n8n verileri bir Docker volume'unda (n8n_data) saklanır ve saat dilimi Europe/Paris olarak ayarlanmıştır.
n8n ile neler yapabilirsiniz
Görsel iş akışı düzenleyicisi
Tetikleyicileri, koşulları ve eylemleri tuval üzerinde bir araya getirirsiniz. Her çalıştırmayı node node inceleyebilirsiniz, bu da hata ayıklamayı belirgin biçimde kolaylaştırır.
Webhook ve HTTP çağrıları
Bir iş akışı gelen bir istekle başlayabilir veya herhangi bir REST API'yi sorgulayabilir. Sunucu, webhook URL'lerini HTTPS ile oluşturacak şekilde zaten yapılandırılmıştır.
JavaScript veya Python kodu
Code node'u, veriyi dönüştürmenize ya da standart node'ların karşılamadığı bir mantığı yazmanıza olanak tanır. İş akışından çıkmanız gerekmez.
Veriler sizin sunucunuzda
İş akışları, kimlik bilgileri ve çalıştırma geçmişi, Paris veya Frankfurt'taki VPS'inizin
n8n_dataDocker volume'unda kalır.Başlangıçtan itibaren Caddy ile HTTPS
n8n
127.0.0.1adresine bağlı kalır, yalnızca Caddy 443 numaralı portta dışarı açılır. Geçerli bir sertifikaya geçmek için tek bir dosyayı değiştirmeniz yeterlidir.Otomatik başlatma
İki konteyner de
restart: alwaysile tanımlanmıştır. Sunucu yeniden başladığında n8n ve Caddy müdahale gerekmeden tekrar çalışır.
n8n ile başlayın
Siparişten canlıya birkaç dakikada.
- 1
VPS'i n8n ile sipariş edin
Paris veya Frankfurt'ta bir Linux VPS seçin, ardından sipariş formundaki «Uygulamalar» sekmesinde n8n'i işaretleyin. Debian 12, Debian 13, Ubuntu 20.04, 22.04 ve 24.04 sürümleri sunulur.
- 2
Teslimatı bekleyin ve kontrol edin
Betik ilk açılışta çalışır: Docker'ı kurar, sonra konteynerleri başlatır. Bu birkaç dakika sürer. Teslimat bilgilerinizle SSH üzerinden bağlanın ve n8n ile Caddy'nin çalıştığını doğrulayın.
Bashcd /opt/n8n && docker compose ps - 3
Sahip hesabını oluşturun
Tarayıcınızda https://SERVER_IP adresini açın ve kendinden imzalı sertifika uyarısını kabul edin. n8n sizden sahip hesabını oluşturmanızı ister. Örneği yöneten hesap budur.
- 4
Alan adına geçin ve HTTPS'i sağlamlaştırın
YOUR_DOMAIN için SERVER_IP adresini gösteren bir DNS A kaydı oluşturun, ardından Caddyfile'ı ve n8n değişkenlerini değiştirin. 80 ve 443 numaralı portlara erişilebiliyorsa Caddy, tanınan bir sertifikayı otomatik olarak alır.
Bashcd /opt/n8n cat > Caddyfile <<'EOF' YOUR_DOMAIN { reverse_proxy 127.0.0.1:5678 } EOF sed -i 's|N8N_HOST=.*|N8N_HOST=YOUR_DOMAIN|; s|WEBHOOK_URL=.*|WEBHOOK_URL=https://YOUR_DOMAIN/|' docker-compose.yml docker compose up -d docker compose restart caddy
n8n kullanım alanları
İş araçlarınızı senkronize edin
Bir formdan gelen yeni lead, CRM'inizde kayıt oluşturur, onay e-postası gönderir ve ekibe mesajlaşma uygulamasından haber verir. Hepsi tek bir iş akışına sığar.
Gelen webhook'ları işleyin
Ödemeler, Git depoları veya izleme uyarıları; olayları süzen, zenginleştiren ve dağıtan iş akışlarını tetikleyebilir. Bunun için geçerli sertifikalı bir alan adı gerekir, çünkü çoğu servis kendinden imzalı sertifikayı reddeder.
Zamanlanmış görevleri otomatikleştirin
Veritabanı dışa aktarımları, haftalık raporlar, veri temizliği: bir cron tetikleyicisi, birkaç makineye dağılmış betiklerin yerini alır.
Yapay zekâ modellerini bağlayın
n8n, bir iş akışı içinden dil modeli API'lerini çağırabilir. Örneğin destek taleplerini sınıflandırabilir ya da e-postaları doğru kişiye yönlendirmeden önce özetleyebilirsiniz.
n8n hakkında sık sorulan sorular
Sertifikayı Caddy (tls internal) sunucunun IP adresi için üretir. Bu yapılandırmada hiçbir genel sertifika otoritesi bir IP için sertifika veremez. Şifreleme etkindir, ancak sertifika tanınmaz. Bir alan adı bağladığınızda Caddy geçerli bir sertifika alır.
n8n hakkında daha fazlası
Kurulan dosyalar
Her şey /opt/n8n içindedir: install-n8n.sh betiği, docker-compose.yml dosyası ve Caddyfile. Üç Docker volume'u oluşturulur: n8n_data (n8n verileri ve kimlik bilgilerinin şifreleme anahtarı dahil), caddy_data ve caddy_config.
N8N_HOST ve WEBHOOK_URL değişkenleri, kurulum sırasında tespit edilen genel IP adresini içerir. IP adresinizi ya da alan adınızı değiştirirseniz bunları güncelleyin. Aksi halde arayüzde görünen webhook URL'leri yanlış olur.
Güvenlik duvarı
n8n doğrudan dışarı açılmaz, ancak 443 numaralı portu Caddy açar. Geri kalanını kısıtlayın: SSH, 80 (Let's Encrypt sertifikasının alınması için gerekir) ve 443 yeterlidir.
Bashufw allow 22/tcp ufw allow 80/tcp ufw allow 443/tcp ufw enable
Güvenlik duvarını etkinleştirmeden önce SSH'e izin verin, yoksa oturumunuzu kaybedersiniz.
Yedekleme
Önemli olan her şey n8n veri volume'unda bulunur. Docker Compose volume adının başına proje klasörünün adını ekler. Adı docker volume ls ile doğrulayın (normalde n8n_n8n_data olur), ardından arşivleyin.
Bashdocker run --rm -v n8n_n8n_data:/data -v /root:/backup alpine \ tar czf /backup/n8n-data-$(date +%F).tar.gz -C /data .
Arşivi sunucunun dışına kopyalayın. Bu volume'daki şifreleme anahtarı olmadan, n8n'e kaydedilen kimlik bilgileri geri getirilemez.
Güncellemeler
Compose dosyası latest etiketini kullanır. Güncellemek için:
Bashcd /opt/n8n docker compose pull docker compose up -d
Öncesinde yedek alın. Üretim ortamındaki bir örnekte docker-compose.yml içindeki latest yerine belirli bir sürüm numarası yazabilir, sürüm notlarını okuduktan sonra yükseltmeyi kendi kararınızla yapabilirsiniz.
